Port live instability, writing recovery and Link Modifier controls to 26.3

ports/mc263/RELEASE_NOTES_1.0.1.129-beta.1.md

@@ -0,0 +1,68 @@
+# Rivencraft 26.3 beta 1.0.1.129-beta.1
+
+Collects the player-validated .121–.129 port slices since 1.0.1.120-beta.1.
+For Minecraft 26.3, NeoForge 26.3.0.99 and Java 25. The independent Minecraft
+1.21.1 release is unchanged. Full parity and optional integrations remain in progress.
+
+## Instability hazards and live profiling
+
+- Ported lightning, explosions, falling meteor effects, burning and erosion with
+  bounded loaded-chunk scans, spawn protection, claim events and configurable
+  world/entity damage. Meteor flight uses the existing sound and particle effects.
+- Natural hazards choose randomized locations; operator test commands provide
+  targeted checks with independent cooldowns. Erosion retains its requested testing
+  default of enabled above 10,000 effective instability, outside the Legacy deck.
+- Ported persistent live material profiling, including native ores, valuable blocks,
+  recognized installed-mod materials and configurable modded block weight overrides.
+  No content mod is required. Profiling starts scoring after 401 Age and 500
+  Overworld baseline samples, with bounded gradual background sampling while an
+  eligible Age is occupied. A chunk snapshot is counted once.
+- Effective instability and deterministic provider selection now update as material
+  abundance is measured; the original writing contribution remains frozen. Added
+  difficulty scaling and operator-only sampling/score diagnostics. Older neutral
+  Ages remain neutral. Normal book/Binder screens do not reveal scores.
+
+## Ordered writing recovery
+
+- Repeated singular terrain, distribution, weather, lighting and sky controllers
+  use the last choice, adding 500 instability per duplicate/conflict. Category-order
+  mistakes add 100. Native distribution ignores supplied biomes; Single retains the
+  first biome when too many are supplied, with conflict penalties.
+- Repeated celestial modifiers use the final pending value of each kind. Dangling
+  modifiers and misplaced/trailing numbers allow binding and add 100 instability.
+  Numbers only attach to the immediately following supported target.
+- Preserved original book/library pages, ordered color mixing and independent
+  celestial chains. A trailing modifier cannot change an earlier sun or moon.
+  Unported pages, unsupported combinations and body limits remain enforced.
+
+## Link Modifier station
+
+- Added the creative-only Link Modifier with its existing model, textures and
+  Legacy single-book GUI. There is no crafting recipe.
+- Books can be renamed and edited through all six controls: Disarm, Intra-Linking,
+  Intra-Linking Only, Maintain Momentum, Relative Link and Generate Platform.
+- Intra-Linking Only enables Intra-Linking and prevents cross-dimension Linking
+  Book travel. Both intra controls are unavailable for Descriptive Books.
+- Relative Link preserves the traveller's offset from the source dimension spawn
+  at the destination spawn. Linking Book platform generation defaults off;
+  Descriptive Book fallback platforms default on and can be disabled.
+- Player and non-player portal paths share the new properties. Book contents and
+  flags persist in the station. Removal releases its stored book.
+- Fixed the controls ignoring real clicks: 26.3 left-click is button 1, not 0.
+  Registered native button widgets now handle input, focus, sound and state tooltips.
+
+## Validation and remaining work
+
+The player passed every included slice, including the six controls and click fix.
+Both Minecraft builds pass (no standalone Gradle test sources). Targeted temporary
+checks covered grammar/celestial recovery, component serialization, station actions,
+platform rules and dedicated-server save/restart behavior. Live profiling was checked
+with real snapshots plus synthetic threshold records; natural gameplay was validated
+by the player. Temporary servers were stopped and their test worlds removed.
+
+Link Modifier seed editing/retirement, remaining discovery/config policy and optional
+integrations are not complete. Live previews remain unavailable; books and portals
+use the animated fallback. Crumble has no active 1.21.1 handler and is not invented
+in this port. The dual-version follow-up issues and full multiplayer/parity gate
+remain open. Use matching client/server beta builds and keep Minecraft version
+tracks and their saves separate.