Complete X.1.0 milestone for Minecraft 1.21.1 and 26.3
Build and smoke / changes (push) Waiting to run

This commit is contained in:
dnorberg committed 2026-11-18 22:55:03 -05:00
1 parent 6630ed7ab1
commit 10a70e3b6a
39 files changed
+1308 -65

No files matched your search

+14
View File
@@ -115,3 +115,17 @@ above remains historical; unchanged earlier artifacts are not relabeled.
## 2026-11-17 release update
Player-approved 1.21.1.0.6 and 26.3.0.10 collect #108 desert vegetation, #109 Static Sky resolution and #111 Native biome families. The 26.3 release also includes #117 optional Seamless live rendering. #118 remains open for Reborn/Seamless failures, including the recovered caves_on_top acknowledgement disconnect. Both JARs retain their player-tested hashes.
## Completed Milestone X.1.0 releases (2026-11-18)
Versions **1.21.1.1.0** and **26.3.1.0** mark completion of the X.1.0 milestone.
The Minecraft version remains the prefix; the milestone/release slice is now 1
and the fix/additional-work counter resets to 0. Later work increments that
last counter, for example 26.3.1.1. Both use ordinary release channels.
Native fluid/sky/Flat-material changes passed player checks on both tracks;
the final 26.3 transition guards also passed player acceptance. Historical
open-issue notes above describe older releases; #118 and #119 are now complete.
Automated evidence remains bounded: 219/213 Native checks and 47 isolated
26.3 client-guard checks, plus the player reports.
+10
View File
@@ -64,3 +64,13 @@ consolidation; issue #84 records the final milestone acceptance. See the
[M7 acceptance](MILESTONE_7_ACCEPTANCE.md), [M7 Legacy audit](LEGACY_M7_AUDIT.md),
[M7 regression matrix](MILESTONE_7_REGRESSION.md), and
[M7 compatibility review](MILESTONE_7_COMPATIBILITY_REVIEW.md).
## Version X.1.0 — complete (2026-11-18)
The post-port improvement milestone is complete in **1.21.1.1.0** and **26.3.1.0**.
The final issues were #119 (Native Nether/End fluids, sky defaults and Flat
ground materials) and #118 (26.3 portal transition guards), both accepted by the
player. See [Native generation](NATIVE_FLUIDS.md) and
[portal guard evidence](PORTAL_TRANSITION_GUARDS.md). Each Minecraft track keeps
its own artifact, dependencies and saves.
+11 -4
View File
@@ -13,8 +13,9 @@ Release builds: **1.21.1.0.6** and **26.3.0.10**. Player in-game validation pass
The three explicit family controllers work with Standard, Amplified, Island,
Cave, Flat and Void terrain. The **Terrain Page still controls geometry**.
Void stays empty; its biomes can affect weather and seasons. These controllers
do not select a sky style, dimension type or season.
Void stays empty; its biomes can affect weather and seasons. In the original family release these controllers did not select a sky style.
Releases 1.21.1.1.0 / 26.3.1.0 add Nether/End sky defaults
unless a Sky Page is explicitly written. They do not select a season.
The player chose **seeded regional layout including modded biomes** for Native
Nether/End, rather than vanilla climate or End-island placement. The family
@@ -77,8 +78,8 @@ On 26.3, authored noise-terrain generation can now construct a vanilla noise
baseline when the primary Overworld is Flat/custom rather than a Noise generator.
This allows the independent Native-family/terrain pairing in that setup instead
of failing with “Overworld generator cannot accept authored noise settings.”
The existing path for an ordinary noise Overworld is unchanged. Issue #115's
separate material-abundance baseline work is not completed by this fix.
The existing path for an ordinary noise Overworld is unchanged. The later material-abundance baseline work is documented separately in
[block baselines](BLOCK_BASELINE.md).
## Creative, JEI and loot policy
@@ -137,3 +138,9 @@ BOP/TerraBlender**. Coverage includes:
5. Verify all three Pages appear under biome generation in Creative and JEI.
6. Reopen an older Native Cave Age if available. Its saved mixed pool is kept;
create a new Age to test the new default rather than expecting migration.
## Natural fluids — issue #119
Releases 1.21.1.1.0 / 26.3.1.0 apply lava to Native Nether
natural fluids and remove Native End natural water. Explicit Flooded/fluid
features remain separate. See [Native fluid rules](NATIVE_FLUIDS.md).
+139
View File
@@ -0,0 +1,139 @@
# 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.
+97
View File
@@ -0,0 +1,97 @@
# Portal transition guards — issue #118
Released with **26.3.1.0**; NeoForge 26.3.0.99 / Java 25.
Only 26.3 client code changed for issue #118; the 1.21.1.1.0 release includes
the separately accepted Native-generation updates.
## Evidence and attribution
The installed Seamless 1.0.0 and Reborn 7.0.12 bytecode has the same unchecked
redirectHandleBlockChangedAck path: getClientWorlds asserts that the portal
engine is initialized, then iterates its worlds. Its own world-replacement
cleanup can leave initialization false until a later initialization point.
Rivencraft does not call that cleanup. Its existing workaround was Reborn-only.
Two newer Seamless reports (2026-11-18 21:51:41 and 22:05:32) still show this
same assertion. That establishes an ongoing compatibility gap, not an Age
generation exception. Local reports are retained outside the repository.
The Reborn exploration crash dereferenced a null RenderSection in its wrapped
compileAsync path. Both vanilla 26.3 and NeoForge's patched compileSections
loop retrieve the current section for an extracted job and dereference it
without a null check. ViewArea can return null for a section outside its current
storage. Reborn wraps the compile call; Seamless modifies the priority decision
instead. The observed origin of the stale job is still not conclusively
attributed to vanilla, the portal engine, or their interaction. No independent
full-client reproduction without Rivencraft is claimed.
The [Seamless project](https://www.curseforge.com/minecraft/mc-mods/immersive-portal)
links to [its upstream tracker](https://github.com/fmpapierz/SeamlessPortals/issues).
No new report has been submitted by this change. An unrelated report there does
not establish a match to these failure paths.
## Acknowledgement guard
ImmersiveBlockAckMixin runs on the client/game thread, only when either supported
fork is installed. During an uninitialized-world-map interval, it acknowledges
the packet listener's own ClientLevel directly and skips the failing multiworld
redirect. With an initialized map the fork handles the packet normally,
including remote worlds. Off-thread packets retain vanilla scheduling. With no
packet world, there is no valid local prediction state to acknowledge.
The helper and mixin were renamed from their old Reborn-only names. Optional
portal API classes remain behind the installed-engine check; no new required
dependency or configuration switch is introduced.
## Unavailable section jobs
At compileSections entry, when a supported fork is present, only jobs whose
section is absent from the current ViewArea are removed. The check uses an
invoker for the same section lookup vanilla performs later.
Every valid job retains its object identity, order, region, additional renderers
and dirty state. The whole render pass is not canceled. There is no try/catch
around rendering, permanent coordinate blacklist, terrain scan or new chunk
loading. A newly allocated section can be extracted and compiled normally.
Other exceptions propagate. This is a targeted mitigation for the observed
null receiver, not a claim to fix every renderer or world-ownership issue.
## Verification
./gradlew -p ports/mc263 build
python3 scripts/regression_client118.py
The isolated script passed **47 checks** using production guard/mixin bytecode.
It extracts and runs the acknowledgement redirect bytecode from both installed
forks, reproducing the old uninitialized-map assertion before testing guarded
delivery. Coverage includes warm/cold maps, exact-once local acknowledgement,
normal remote acknowledgement, off-thread noninterference, no-fork bypass,
missing packet world, stale/valid renderer jobs, retained job identity/payload
and dirty state, newly available sections, null view area and unrelated errors.
Minecraft lifecycle and renderer types in this script are small isolated stubs.
It starts no Minecraft client, GPU, server or test world. It does not prove
runtime Mixin application, live portal graphics or end-to-end network timing.
No stall occurred and no stalled server probe was retried. Temporary test
outputs are deleted; result retained in build/verification/issue118/guards.txt.
## Player acceptance checklist
Test each installed renderer separately; never enable both together.
1. Start with Seamless and confirm the client loads. Create/open/close a new Age
book, travel repeatedly and return. Include normal block placement/breaking
around travel to exercise prediction acknowledgements.
2. Open live book previews, enter/exit look-only exploration, close/reopen and
use a live crystal portal. Verify the view stays correct and travel works.
3. Explore across chunks, rebuild terrain (F3+A), and change render distance.
Confirm no section crash and that terrain continues rebuilding visibly.
4. Disconnect/rejoin and fully restart; repeat travel to existing/new Ages.
5. Repeat with Reborn alone, particularly sustained exploration/rebuilding.
6. Optionally check animated fallback with no portal mod. Neither renderer is
required for normal Rivencraft travel.
The user reported in-game pass and authorized publication after testing the
26.3.0.19 candidate. Issue #118 and Milestone X.1.0 are complete. This records
player acceptance; no independent exhaustive GPU/network/renderer matrix or
standalone external-fork reproduction is claimed.
+3 -1
View File
@@ -29,6 +29,8 @@ See the [installation guide](https://git.paddedcell.org/dnorberg/rivencraft/wiki
- Preview destinations with the built-in Legacy-style animation or an optional rendering integration for your Minecraft version.
- Set an Age’s water level with Flooded and Number Pages.
- Select Native Caves, Nether or End biome pools independently of terrain, grow desert vegetation with Trees/Huge Trees/Flowers, and control Static Sky resolution with Number Pages.
- Native Nether defaults to lava and Nether sky; Native End to dry terrain and End sky. Explicit Sky and Flooded Pages retain control. Flat terrain uses appropriate End/Nether ground in those biomes.
- Right-click dropped open books to read/link, or shift-right-click to collect; walking over them does not pick them up.
## Getting started
@@ -46,7 +48,7 @@ Optional integrations include **JEI**, **TerraBlender** and compatible biome mod
Destination previews depend on the Minecraft version:
- **1.21.1:** optional Create/Ponder snapshots or Immersive Portals live views.
- **26.3:** optional **Immersive Portals Reborn or Seamless Portals** live book and crystal-portal views, including look-only exploration inside the book panel. Install only one fork per instance. **Known Reborn/Seamless crashes and travel disconnects remain under investigation:** [issue #118](https://git.paddedcell.org/dnorberg/rivencraft/issues/118).
- **26.3:** optional **Immersive Portals Reborn or Seamless Portals** live book and crystal-portal views, including look-only exploration inside the book panel. Install only one fork per instance. The 26.3.1.0 release includes player-accepted guards for portal world-reset acknowledgements and unavailable section rebuilds; see [scope and verification](https://git.paddedcell.org/dnorberg/rivencraft/src/branch/main/docs/PORTAL_TRANSITION_GUARDS.md).
Built-in animated previews remain available without a portal renderer. Create/Ponder scenes are not currently included in the 26.3 build.
+12 -3
View File
@@ -1,8 +1,8 @@
# Optional Seamless Portals integration — issue #117
Local candidate **26.3.0.9**, Minecraft 26.3 / NeoForge 26.3.0.99 / Java 25.
Pending real-client validation; not committed or published. Minecraft 1.21.1
is unchanged by this issue.
Current release: **26.3.1.0**, Minecraft 26.3 / NeoForge 26.3.0.99 / Java 25.
Seamless integration and the later transition guards passed player in-game
checks. Earlier candidate/release notes below retain their historical scope.
## Supported engines and API boundary
@@ -134,3 +134,12 @@ Inspected Seamless artifact SHA-256: `5d2bfc2a811a6526e3f6722c521d97e5de2869a6ea
## Release validation (2026-11-17)
Player in-game checks passed. Included in releases 1.21.1.0.6 and 26.3.0.10 (Seamless integration applies to 26.3 only). Earlier candidate notes above describe development history. Known Reborn/Seamless acknowledgement and rendering failures remain tracked in [#118](https://git.paddedcell.org/dnorberg/rivencraft/issues/118); this release does not resolve them.
## Accepted transition guards — issue #118
Release **26.3.1.0**, validated as candidate **26.3.0.19**, extends the acknowledgement reset guard
to Seamless as well as Reborn, and removes unavailable section jobs before the
vanilla renderer dereferences them. The older Reborn-only notes describe the
published releases. See [transition investigation](PORTAL_TRANSITION_GUARDS.md)
for evidence, exact scope, isolated tests and remaining client validation.