
Nether API
A library mod for adding End and Nether biomes or structures, and for creating new biome ambience!
Автор: jbredwards428,8 тыс.37обновлён 20 окт. 2026 г.
БиблиотекиГенерация мира
Описание
A library mod for adding End and Nether biomes or structures, and for creating new biome ambience!
Also unifies different older mods' End and Nether biome generators under one system, fixes respawn dimension logic and other bugs, and offers new settings for the End and Nether.

If you're a modpack developer wanting to add Nether API to a modpack distributed outside of CurseForge or Modrinth, use File Director to avoid reuploading Nether API's files.
API Features:
Ability to add custom biome ambience!
- This is applicable to any biome, not just End or Nether biomes.
- Can have passive ambient sounds (can also be set with
BiomeAmbienceEvent). - Can have a custom darkness ambient sound (can also be set with
BiomeAmbienceEvent). - Can spawn passive particles (can also be set with
BiomeAmbienceEvent). - Can have a custom lava color (idea provided by Mellohi).
Ability to add custom End and Nether biomes!
- Can have a custom biome generation weight (can be set with
NetherAPIRegistryEvent). - Can have a custom fog color (can also be set with
NetherAPIFogColorEvent). - Can have a custom music type.
- Can have a custom surface builder, and a custom chunk populator.
- Can have custom cave carving conditions.
- Can have custom Chorus Plant, End City, and Small End Island generation conditions (End biomes only).
- Can have multiple weighted sub-biomes and edge-biomes.
Ability to add custom End and Nether structures!
- Can generate between chunks (like Nether Fortresses).
- Can have custom entity spawning properties (like Nether Fortresses).
- Can have custom generation conditions.
- All registered structures automatically work with the /locate command.
- All registered structures automatically check for other structures when generating, so they won't intersect.
New EnumPlantTypes!
- These are applied automatically by Nether API to various modded End and Nether plants and soil blocks, to let them respect other mods' "End Stone"-like or "Netherrack"-like soil blocks. This allows for new inter-compatibility between any plants and soils from different mods that use them!
PlantUtils.END_PLANT_TYPE: This PlantType is for any plants that can be planted on "End Stone"-like blocks. At runtime this is automatically applied to Vanilla's Chorus Plants.PlantUtils.NETHER_PLANT_TYPE: This PlantType is for any plants that can be planted on both "Netherrack"-like blocks and "Soul Sand"-like blocks.PlantUtils.NETHERRACK_PLANT_TYPE: This PlantType is for any plants that can be planted on "Netherrack"-like blocks.PlantUtils.SOUL_SAND_PLANT_TYPE: This PlantType is for any plants that can be planted on "Soul Sand"-like blocks. This field just set to Forge'sEnumPlantType.Nether, since they serve the same purpose.
Mod Features:
Features:
- Allows end biome mods to work together by unifying end biome generation code!
- Allows nether biome mods to work together by unifying nether biome generation code!
- Allows users to define a default "player spawn dimension" through new config settings!
- Automatically enables Forge's cascading world gen fix during End & Nether generation!
- Caves can now generate in the End's outer islands!
- Nether caves can now carve through biome top/filler blocks and soul sand (instead of only netherrack)!
- New config setting to disable the first Ender Dragon spawn. When this setting is active: an End Gateway will generate, the Ender Dragon can still be summoned using End Crystals, and the dragon egg still appears after the Ender Dragon's first death.
- The Nether can now be 256 blocks tall!
- This feature is disabled by default.
- This feature should only be enabled for new worlds (or old worlds if you reset the Nether first).
- For many mods that generate their own nether features, you'll have to adjust their configs to account for the new height. Currently all mods that Nether API adds its own support for (and do not require manual config editing) are as follows (it's also assumed that any mods using Nether API as a dependency have automatic support for this feature):
Fixes:
- Fix "initial spawn position" bugs for many dimensions (like positioning players in lava or well above the ground).
- Fix MC-10369 (Certain particles do not get spawned):
- Baby animal spawning particles.
- Ender dragon block destruction particles.
- Entity teleportation particles.
- Eye of ender placement particles.
- Fluid mixing effect particles.
- Iron golem creation particles.
- Redstone torch burnout particles.
- Snow golem creation particles.
- Wither creation particles.
- Fix MC-31681 (Fog and clouds darken when you're under any blocks).
- Perform initial spawn chunk load for the "player spawn dimension" instead of the overworld, and generate spawn positions for all respawn dimensions.
- The Ender Dragon can now longer destroy blocks with a blast resistance of obsidian (enchanting tables, ender chests, etc.). Also prevent the Ender Dragon from being able to destroy torches (as they're a part of the exit portal).
- Respawning now accounts for all of Forge's per-dimension bed spawn points instead of only the current dimension. This change alone fixes some mods (like aether beds not working if you die outside the aether), and greatly simplifies the respawn logic needed by mod developers wanting to add a dimensional respawn point.
Special Mod Compatibility:
BetterNether
- All three versions are supported (BetterNether, BetterNether: RotN Edition, and BetterNether Continuation).
- BetterNether uses a pseduo-biome generation system, this mod disables that and gives it real biomes.
- Heavily improve performance when generating features (by not causing block updates). This also fixes several cascading world generation issues.
- New config setting that allows eye vines to generate in Biomes O' Plenty's "Visceral Heap" biome.
Biomes O' Plenty
- Add config option to allow the fluids from Biomes O' Plenty that already generate in the Nether (Blood and Honey) to not vaporize in the Nether when placed through a bucket.
- Add config option to toggle world-type dependency for BOP's nether biomes, allowing them to spawn even when the world-type isn't set to "Biomes O' Plenty".
- Fix BOP dynamic trees addon creating dirt in the nether.
- Fix BOP nether bramble cascading world generation issues.
- Fix BOP nether hive cascading world generation issues.
- Fix BOP nether lava cascading world generation issues, caused by that mod copying Vanilla's code but not copying Forge's fix for it (see MC-117810).
- Prevent BOP from hiding its cascading world generation issues from the logger (lol).
- Prevent BOP from removing End and Nether fog.
Journey Into The Light
- JITL uses a pseduo-biome generation system, this mod disables that and gives it real biomes.
- Fix all of JITL's Nether cascading world generation bugs.
- Fix certain structures using bad entity ids for spawners (caused lots of log spam and broken spawners).
- Improve performance when generating JITL's Nether features (by not causing block updates).
- JITL's Nether entities now spawn only in JITL's Nether biomes instead of Vanilla's Hell biome (any can be reverted via GroovyScript):
- Hell Cow: Now only spawns in the Blood Forest & Blood Forest Edge biomes.
- Hell Serpant: Now only spawns in the Heat Sands biome.
- Hell Turtle: Now only spawns in the Heat Sands biome.
- Inferno Blaze: Now only spawns in the Blood Forest biome.
- Mini Ghast: Now only spawns in the Blood Forest biome.
- Reaper: Now only spawns in the Earthen Seep biome.
- Witherspine: Now only spawns in the Earthen Seep biome.
Natura
- Only generate Natura's Nether features in Vanilla's Hell biome, as they usually are very out of place in modded ones. Other biomes can be whitelisted via GroovyScript.
Nethercraft Classic
- Add new "Glowing Grove" biome that Nethercraft now adds all of its features into.
- Fix all of Nethercraft's cascading world generation issues.
- Fix Nethercraft's bad entity network registries (also fixes weird projectile behavior).
- More of Nethercraft's entities are now fireproof.
- Nethercraft's Dark Zombies are now summoned instead of normal zombies during
SummonAidEventwhile in the nether - Nethercraft's Slime Eggs can no longer spawn entities on the client.
NetherEx
- Add functionality for NetherEx's previously unused config values for soul sand and gravel generation.
- Fix bad structure size check, no longer causes cascading world gen when checking structure placement.
Stygian End: Biome Expansion
- All three versions are supported (Stygian End: Biome Expansion, Stygian End: Unoffical, and Stygian End Continuation).
- Chorus Plants no longer generate in Stygian End's biomes (each can be toggled via configs).
- End Cities no longer generate in Stygian End's biomes (each can be toggled via configs).
- Fix all of Stygian End's canopy cascading world generation issues (done by drastically changing how the trees generate, can be reverted via configs).
- Fix all of Stygian End's volcano cascading world generation issues.
- Stygian End's acidic plains biome features now generate only on end obsidian.
Direct contact: jbred.dev@gmail.com
This mod will not be ported
Галерея
Последние версии
Все версии →release
v1.5.4-mc1.12.2
1.5.420 окт. 2026 г.390Minecraft: 1.12.2forge
Что нового
**Bug Fixes:**
- BetterNether RotN/Continuation:
- Fix crash when quartz stained glass is disabled (fixes [#48 (comment)](https://github.com/jbredwards/Nether-API/issues/48#issuecomment-6273589623)) (this bug only affected v1.5.0 of Nether API).
**Compatibility Fixes and Improvements:**
- BetterNether:
- Fix lucis mushroom generation intersecting with other plants (suggestion by [#48](https://github.com/jbredwards/Nether-API/issues/48)).
- Move all hardcoded BetterNether block drops to Forge system (suggestion inspired by [#48](https://github.com/jbredwards/Nether-API/issues/48)). This change allows them to be manipulated by the block drops event (and therefore also by the various "block drop tweaker" mods), and also fixes some bugs caused by not using the Forge system.
release
v1.5.3-mc.1.12.2
1.5.319 окт. 2026 г.132Minecraft: 1.12.2forge
Что нового
**Bug Fixes:**
- BetterNether:
- Fix crash when attempting to reload resources (fixes [#50](https://github.com/jbredwards/Nether-API/issues/50)) (this bug only affected v1.5.0 of Nether API).
- Fix magma blobs generating in the air when netherrack moss or nether mycelium are disabled via config (fixes [#49](https://github.com/jbredwards/Nether-API/issues/49)) (this bug only affected v1.5.0 of Nether API).
release
v1.5.2-mc1.12.2
1.5.213 окт. 2026 г.882Minecraft: 1.12.2forge
Что нового
**Bug Fixes:**
- NetherEx Coolmar Spider rendering bugfix from v1.5.0 now works properly.
**Compatibility Fixes and Improvements:**
- Dynamic Surroundings:
- Fix a bug where "ambience.json"-defined fog colors were not being visually applied on player join, and would only be visually applied when the player moved between blocks.
- Improve performance of biome fog color algorithm in the nether/end, by using the biome fog color already calculated by Nether API.
- Make the biome fog color transition between biomes smoother in the nether/end.
- Snow no longer accumulates on the nether roof if the biome temperature is cold enough (like the NetherEx arctic abyss bome). This happened because Dynamic Surroundings applies weather to the nether.
release
v1.5.1-mc1.12.2
1.5.111 окт. 2026 г.246Minecraft: 1.12.2forge
Что нового
**Bug Fixes:**
- Fix crash while Biomes O' Plenty is not installed (fixes [#46](https://github.com/jbredwards/Nether-API/issues/46)) (this bug only affected v1.5.0 of Nether API).
release
v1.5.0-mc1.12.2
1.5.011 окт. 2026 г.78Minecraft: 1.12.2forge
Что нового
**Features:**
- Allow biome ambience (including end and nether biome fog) to be changed through a new `ambience.json` config file (more info [here](https://github.com/jbredwards/Nether-API/blob/1.12.2/README.md))!
- Config settings:
- Many new config settings to customize end caves.
- New config settings to reload `ambience.json` and control `ambience.json` server sync.
- New config settings to set the min/max length that nether fortress pillars can generate (suggestion from [#23](https://github.com/jbredwards/Nether-API/issues/23)). Note that each large pillar is actually made up of many 1x1 pillars. Probably best used for void worlds.
- New config settings to set the min/max y position of a nether fortress structure start (suggestion from [#23](https://github.com/jbredwards/Nether-API/issues/23)).
- New config setting to toggle the dragon griefing fix.
- New config settings to toggle [MC-10369](https://bugs.mojang.com/browse/MC/issues/MC-10369) fixes.
- Fix occasional Vanilla weather desync when traveling between dimensions. This fixes the nether fog sometimes being darker than it should be.
- Fix Vanilla dragon egg teleportation bugs:
- Fix teleporting into the air.
- Fix teleporting outside the world.
- Particles now show the actual direction the dragon egg went.
- Fix Vanilla ender teleportation bugs (with a config setting to disable):
- Prevent client-only teleportation. Fixes janky teleporting when fighting endermen or shulkers (for example).
- Prevent dead entity teleportation. Fixes annoying situations where enderman loot will be somewhere else.
- Modded fluids now have a more accurate fog color:
- If a fluid doesn't have a color set, use its block color or map color rather than white.
- New `/nether_api ambience reload` command the reloads `ambience.json` on the server and syncs with all clients.
**Bug Fixes:**
- Better sorting for Nether API config sub-categories.
- Don't calculate and load initial spawn chunks for non-initial spawn dimensions that permit respawning (fixes [#39](https://github.com/jbredwards/Nether-API/issues/39)).
- Due to biome registry order, it was possible for BOP or NetherEx to re-enable the Vanilla hell biome though their own default configs even if the Nether API config weight was set to was 0. This is now fixed.
- Fix biome fog color flickering when crossing between biomes.
- Fix clients referencing Vanilla's nether/end world providers instead of Nether API's if they join a server without loading a singleplayer world first. This fixes the following bugs:
- Nether/End biome fog not working on dedicated servers.
- Nether/End biome music not working on dedicated servers.
- Nether/End using overworld cave sounds (instead of none) on dedicated servers (if the biome doesn't have its own dark ambience sound).
- Probably other stuff too.
- Fix mod credits and description for prism launcher.
- Fix server lag when calculating a random respawn point with a with large spawn radius (fixes [#45](https://github.com/jbredwards/Nether-API/issues/45)).
- Fix some log output calls not using `NetherAPI.LOGGER`.
- Improve entity teleportation particle handling for very large distances (if distance is too large, don't render a trail).
- Improve magma block nether generation (now only replaces netherrack-like blocks or solid blocks with a material of `Material.GROUND` or `Material.SAND`).
- Mark non-initial spawn dimensions as initialized during world load (fixes [#44](https://github.com/jbredwards/Nether-API/issues/44) and probably some other random things).
- The `/nether_api list` command now only outputs to the log, since outputting to the chat made its formatting look weird.
**Compatibility Fixes and Improvements:**
- BetterNether:
- Add city structure to the `/locate` command.
- Add quartz stained glass to ore dictionary.
- Cacti blocks (agave, barrel cactus, nether cactus) now have the correct entity pathfinding type.
- Fix lucis mushroom generation having incorrect rotation (fixes part of [#24](https://github.com/jbredwards/Nether-API/issues/24)). BetterNether RotN/Continuation only, the original BetterNether does not have this issue.
- Fixes for quartz stained glass panes:
- BetterNether RotN/Continuation only, the original BetterNether does not have quartz stained glass panes.
- Add crafting recipes.
- Add models (fixes part of [#24](https://github.com/jbredwards/Nether-API/issues/24)).
- Add localization values (BetterNether RotN only).
- Add to ore dictionary.
- Prevent black apples from sometimes generating inside lava.
- Biomes O' Plenty:
- Bramble now has the correct entity pathfinding type.
- Fix BOP replacing all non-lava fluid fog colors with water.
- Fix BOP replacing the world provider's fog (if world provider fog is enabled).
- Nether API now accounts for BOP biome fog color configs for the nether/end fog color calculation.
- New config setting to allow End features added by BOP to generate without the world type set to "Biomes O' Plenty".
- Use different approach for block particle color fix, and resolve various conflicts caused by the old method (fixes [#41](https://github.com/jbredwards/Nether-API/issues/41) and [#43](https://github.com/jbredwards/Nether-API/issues/43)).
- CatServer:
- Fix crash (fixes [#40](https://github.com/jbredwards/Nether-API/issues/40)).
- NetherEx:
- Fix Coolmar Spider rendering bug.
- Ichor fluid now uses the correct map color.
- New config setting to apply different nether bricks to nether fortress based on its origin biome (false by default) (suggestion from [#23](https://github.com/jbredwards/Nether-API/issues/23)).
- New config setting to apply gloomy nether bricks to nether fortresses if its origin biome has a top block of soil sand (false by default).
- New config setting to use "frozen" entity instead of "blaze" entity for arctic abyss nether fortress (false by default) (suggestion from [#23](https://github.com/jbredwards/Nether-API/issues/23)).
- Stygian End:
- Cactus now has the correct entity pathfinding type.
**API Changes:**
- Many internal fields have either been moved to new config settings, or are now exposed through a new `api.util.NetherAPIProperties` class.
- The API now makes use of `org.jetbrains.annotations.ApiStatus` annotations.
- `api.audio.IDarkSoundAmbience`:
- New `IDarkSoundAmbience.DEFAULT_CHANCE_PER_TICK` field that equals the chance used by Vanilla in modern versions.
- New `IDarkSoundAmbience.DEFAULT_LIGHT_SEARCH_RADIUS` field that equals the light search radius used by Vanilla in modern versions.
- New `IDarkSoundAmbience.DEFAULT_SOUND_OFFSET` field that equals the sound offset used by Vanilla in modern versions.
- New static `modded` method that returns a new `DarkSoundAmbience` instance with custom ambience properties.
- New static `vanilla` method that returns a new `DarkSoundAmbience` instance with Vanilla ambience properties.
- `api.audio.IMusicType`:
- New static `modded` method that returns a new `IMusicType` instance with custom music properties.
- New static `vanilla` method that returns a new `IMusicType` instance with Vanilla music properties (cannot replace current music, and is not local to the current biome).
- `api.audio.ISoundAmbience`:
- New `ISoundAmbience.DEFAULT_CHANCE_PER_TICK` field that equals the chance used by Vanilla in modern versions.
- New `ISoundAmbience.of` methods.
- `api.biome.IAmbienceBiome`:
- Make it easier to use this interface by offering new sub-classes.
- New sub-classes: `IAmbienceBiome.Delegate`, `IAmbienceBiome.Impl`, and `IAmbienceBiome.Mutable`.
- `api.biome.ILavaTintBiome`:
- Restore original `getBiomeLavaColor` method from v1.0.0 (removed in v1.3.0), now marked as "override only" and with a default implementation returning -1.
- The `getBiomeLavaColor` method from v1.3.0 now has a default implementation pointing to the original method.
- `api.biome.IMusicBiome`:
- New interface.
- Allows any implementing biome to have a custom `api.audio.IMusicType` (regardless of the dimension!).
- Extracts the music logic shared between `api.biome.INetherBiome` and `api.biome.IEndBiome`, with a new `getCreativeMusicType` method.
- `api.biome.INoSpawnBiome`:
- New `denyPlayerSpawn` method with a default implementation returning true.
- `api.block.IConditionalParticleColor`:
- New interface.
- Having your Block implement this allows it to control whether its block particles will be colored.
- `api.event.BiomeStructureEvent`:
- New class.
- Contains child event classes to offer control over traits of structures that support the events. Child events are `GetBlockID`, `PrepareSpawnerLogic`, and `PrepareSpawnList`.
- Currently, the only Vanilla structure that supports these events is "Fortress". It's generally recommended for modded structures registered using Nether API to use these events, but it's not required.
- `api.structure.IBiomeStructure`:
- New interface.
- Makes it much easier for `StructureStart` and `StructureComponent StructureComponent` instances to support `api.event.BiomeStructureEvent`.
- `api.structure.MapGenSpawningStructure`:
- Internal changes to make it support `api.structure.IBiomeStructure`.
- Mark `MapGenSpawningStructure.spawnableCreatures` field as "obsolete". If you want to retrieve creature spawns, use the world-sensitive `getPossibleCreatures` getter method. If you want to add default creature spawns, use the `addSpawnableCreature` method.
- New protected methods for ease-of-use.
- `api.util.InitialSpawnUtils`:
- New class.
- Provides some utility functions relating to initial spawn dimensions.
- `api.util.NetherAPIProperties`:
- New class.
- Exposes certain internal Nether API properties in a stable, non-changing way.
- `api.util.NetherGenerationUtils`:
- New `getEndIslandHeightValue` method that exposes `ChunkGeneratorEnd.getIslandHeightValue` for other mods to use.
- `api.util.ParticleFactoryUtils`:
- New class.
- Provides some utility functions relating to `IParticleFactory`.
- `api.world.IAmbienceWorldProvider`:
- Add 4 static utlity methods to cover all use-cases for `getAmbienceOrFallback`, and mark that method as "obsolete".
release
v1.4.5-mc1.12.2
1.4.55 июн. 2026 г.6,8 тыс.Minecraft: 1.12.2forge
Что нового
**Bug Fixes:**
- Fix BOP's grass blocks missing their biome color tint when rendered outside the normal block renderer (fixes [#38](https://github.com/jbredwards/Nether-API/issues/38)).
**Compatibility Fixes and Improvements:**
- BetterNether Continuation:
- Revert (probably unintentional) change that mod made to black apple generation that let them generate in the air (fixes [#30](https://github.com/jbredwards/Nether-API/issues/30)).
release
v1.4.4-mc1.12.2
1.4.425 мая 2026 г.453Minecraft: 1.12.2forge
Что нового
**Features:**
- Add Modrinth [`updateJSON`](https://docs.minecraftforge.net/en/1.12.x/gettingstarted/autoupdate/#forge-update-checker) url.
**Compatibility Fixes and Improvements:**
- Dynamic Surroundings HUD:
- Fix error while using Dynamic Surroundings v3.6.0.0 (fixes [#24 (comment)](https://github.com/jbredwards/Nether-API/issues/24#issuecomment-4536545760)) (this bug only affected v1.4.3 of Nether API).
release
v1.4.3-mc1.12.2
1.4.325 мая 2026 г.73Minecraft: 1.12.2forge
Что нового
**Bug Fixes:**
- Add description for the "betternether.moldOnMyceliumOnly" config setting.
- Fix crashes caused by the new v1.4.0 plant types (fixes [#35](https://github.com/jbredwards/Nether-API/issues/35)).
- Fix the random player spawn position check marking all spots in unloaded chunks as invalid (fixes [#34](https://github.com/jbredwards/Nether-API/issues/34)).
**Compatibility Fixes and Improvements:**
- BetterNether:
- Fix crash when player spawn dimension is set to the nether while BetterNether is installed.
- Fix eye vines carving into terrain ([#24](https://github.com/jbredwards/Nether-API/issues/24)).
- New config setting to control 3D models for red and brown mushrooms ([#24](https://github.com/jbredwards/Nether-API/issues/24)).
- Biomes O' Plenty:
- Fix BOP eyebulb block particle color.
- Bukkit:
- Fix compatibility for Forge servers running Bukkit (by funkyra in [#31](https://github.com/jbredwards/Nether-API/issues/31)).
- Dynamic Surroundings:
- Dust storm particle color in nether now matches the fog color (instead of always being a bright red).
- Fog for non-surface dimensions no longer factors daylight. In non-surface dimensions, daytime calculations aren't applicable, which resulted in the Nether and End fog colors always being much darker than they should be.
- Support boss fog thickness and dimensional fog thickness modifiers in fog range calculation ([#24](https://github.com/jbredwards/Nether-API/issues/24)).
- Support Nether API fog colors in fog color calculation.
- Natura:
- New config setting to re-enable Natura nether generation for all nether biomes ([#36](https://github.com/jbredwards/Nether-API/issues/36)).
- NetherEx:
- Add NetherEx elder mushroom plants to creative tab ([#24](https://github.com/jbredwards/Nether-API/issues/24)).
release
v1.4.2-mc1.12.2
1.4.213 нояб. 2025 г.17,1 тыс.Minecraft: 1.12.2forge
Что нового
**Bug Fixes:**
- Fix critical client-world desync issue (fixes [#27](https://github.com/jbredwards/Nether-API/issues/27)).
- Fix end exit portal generation forcing a portal to exist at y=63.
- Fix possible JVM crash (for real this time) (fixes [#26](https://github.com/jbredwards/Nether-API/issues/26)).
release
v1.4.1-mc1.12.2
1.4.113 нояб. 2025 г.89Minecraft: 1.12.2forge
Что нового
**Bug Fixes:**
- Fix Stygian End crash (fixes [#25](https://github.com/jbredwards/Nether-API/issues/25)).
- (Maybe?) Fix possible JVM crash (fixes [#26](https://github.com/jbredwards/Nether-API/issues/26)).





