7.3 KiB
Native terrain fluids — issue #119
Released in 1.21.1.1.0 and 26.3.1.0. Player in-game checks passed on both; issue #119 closed.
Behavior
Native Nether replaces the noise terrain's default fluid with lava and disables Overworld water aquifers. This includes Cave terrain, which keeps its preset fluid height for Native Nether instead of the ordinary dry-Cave override.
Native End uses air as its default fluid, disables aquifers, and places the fluid cutoff below the terrain's minimum Y. Vanilla's fluid picker can otherwise introduce low-level lava even after changing the default fluid to air.
Terrain still determines geometry and the ordinary fluid cutoff for Nether: Standard, Amplified, Island and Cave retain their noise shape and vertical range. This does not raise Island terrain's below-world cutoff into an ocean. Flat and Void retain their existing empty/flat generation; the Native Page does not add an ocean to either.
The change follows the frozen Native family choice, including recognized modded members. It does not infer a family merely from a particular biome appearing in a custom Single/Tiled/region distribution. Native, Native Caves, and explicitly authored non-Native biome distributions retain existing rules. The fluid rule does not change season, biome-pool or material-rule selection. Native-family sky defaults are described below.
Native sky defaults
When no explicit Sky Page is active, Native Nether defaults to the Nether sky and Native End defaults to the End sky. This applies independently of terrain. A written Overworld, Nether, End or Static Sky Page takes precedence, including when Sun/Moon Pages are also present. Celestials alone do not override the Native-family default. Color/celestial authoring remains intact.
Native and Native Caves keep their previous fallback selection. 1.21.1 derives the default from the saved family plan for server effects and the synchronized sky profile. 26.3 freezes the resolved style through its existing Age sky save and dimension-type variant, rather than consulting mutable worldgen state.
Explicit authoring and saves
Flooded still deliberately adds water at the authored/default height after terrain and decorations. Explicit fluid features retain their selected fluid. Thus Native End + Flooded intentionally has water, and Native Nether + Flooded is not an implicit lava Flooded Page. These are separate authoring instructions.
The Native family already persists in the biome plan. The effective noise fluid, aquifer policy and cutoff are included in the generator's existing codec. No new Page or config is introduced. Tooltips explain the natural-fluid rules.
Existing generated chunks are not rewritten. Use newly created Ages for visual validation; older Native-family Ages may use the new fluid rules in future chunks when their generator is reconstructed.
Focused verification
Run sequentially:
python3 scripts/regression_native119.py mc1211
python3 scripts/regression_native119.py mc263
Each run creates one temporary server world and isolated fixture output, holding the host-wide server lock. It removes the world on pass/fail; if a run stalls after 60 seconds, it stops and hands the remaining check to the player without retrying. Logs remain under build/verification/native119/.
The fixture builds real authored generators for all six terrain choices and three explicit Native families, checks generator codec reload and the actual vanilla fluid picker over the full vertical range. Flat/Void must remain flat. This establishes settings and fluid-picker behavior, not completed decorated terrain, modded lake behavior, or visual/client acceptance.
Player checks — both versions
- Create Link Panel → Standard → Native Nether. Explore new terrain: natural oceans/aquifers should use lava rather than water.
- Repeat with Cave → Native Nether: any natural fluid is lava.
- Create Standard → Native End, then Cave → Native End. Natural terrain should be dry; explore new chunks to check for unexpected water.
- Check Native Caves remains dry on Cave, and ordinary Standard + Native still generates normal water. Flat/Void should not acquire new natural oceans.
- Test Native End + Flooded and Native Nether + Flooded to confirm explicit water authoring still works. Fluid-feature Pages keep their chosen fluid.
- Native Nether/End without a Sky Page should show the corresponding sky. Add Overworld Sky or Static Sky and verify the written Sky wins; repeat with a Sun Page to verify celestial authoring does not change that priority.
- Save/reopen, revisit, and check sky and new chunks retain the intended behavior.
The prior fluid-only candidates passed 76 focused checks per version. The sky-default extension adds checks for defaults, explicit precedence with celestials, dimension effects and saved/serialized styles. Player visual checks were subsequently accepted by the player for the combined candidates.
Combined fluid/sky results: 134 checks on 1.21.1, 122 on 26.3, run sequentially. Both production builds and JAR audits passed; both Dev candidates installed. Temporary worlds removed; no stalls. Player visual acceptance subsequently passed.
Flat biome materials
Flat generation previously wrote the vanilla grass/dirt layers directly without running noise terrain's biome surface rules. Both targets now choose materials from the biome at each column/layer. 26.3 also routes single End/Nether biome plans through the custom flat generator, rather than the vanilla flat bypass.
| Biome | Flat cap | Flat soil |
|---|---|---|
| End family | End Stone | End Stone |
| Nether Wastes / other recognized Nether | Netherrack | Netherrack |
| Crimson Forest | Crimson Nylium | Netherrack |
| Warped Forest | Warped Nylium | Netherrack |
| Soul Sand Valley | Soul Sand | Soul Soil |
| Basalt Deltas | Basalt | Blackstone |
| Other biomes | Existing Flat layers | Existing Flat layers |
This is a biome-aware Flat material preset, not Nether noise geometry or a reproduction of every mod's custom surface decorator. Tagged End biomes use End Stone; tagged or TerraBlender-region Nether biomes use the Nether fallback. Vanilla family IDs remain recognized even when broad tags are missing. TerraBlender-region IDs are captured into generator state and codec; no optional API call or mutable Age data is read per generated block.
Bedrock, air, terrain height and non-base layer blocks remain intact. Materials are chosen during base filling, before authored features and biome decoration, so a rock/tendril material is not recolored by a later broad cleanup scan. The base-column query uses the same material decision as block placement. Mixed End/Nether/Overworld distributions retain their own materials locally.
Visual checks: create fresh Flat + Native End, Flat + Native Nether, and Flat with a single End/Nether biome. Check the surface and exposed dirt layers at edges; also test a mixed distribution and an ordinary Plains Flat Age. Authored material features and Flooded should retain their own blocks/fluids. Existing chunks are not changed.
Latest combined checks (including actual Flat block placement and mixed columns): 219 on 1.21.1 / 213 on 26.3. They passed sequentially without stalls; temporary worlds were removed. The player subsequently reported in-game acceptance. Optional mod-specific custom surface decorators remain outside this Flat material preset.