Public Access
140 lines
7.3 KiB
Markdown
140 lines
7.3 KiB
Markdown
# 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
|
|
|
|
1. Create Link Panel → Standard → Native Nether. Explore new terrain:
|
|
natural oceans/aquifers should use lava rather than water.
|
|
2. Repeat with Cave → Native Nether: any natural fluid is lava.
|
|
3. Create Standard → Native End, then Cave → Native End. Natural terrain should
|
|
be dry; explore new chunks to check for unexpected water.
|
|
4. Check Native Caves remains dry on Cave, and ordinary Standard + Native still
|
|
generates normal water. Flat/Void should not acquire new natural oceans.
|
|
5. Test Native End + Flooded and Native Nether + Flooded to confirm explicit
|
|
water authoring still works. Fluid-feature Pages keep their chosen fluid.
|
|
6. 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.
|
|
7. 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.
|