Port libraries, crystal portals and instability decay to 26.3 beta

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

@@ -0,0 +1,85 @@
+# Rivencraft 26.3 beta 1.0.1.120-beta.1
+
+Collects the player-validated .116–.120 port slices since 1.0.1.115-beta.1.
+For Minecraft 26.3, NeoForge 26.3.0.99 and Java 25. The independent 1.21.1
+release is unchanged; full gameplay and optional-integration parity remain incomplete.
+
+## Libraries and writing
+
+- Ported Legacy library generation, shared schematic, chest loot and five correctly
+  oriented book/page stands. Libraries generate after decoration in eligible new
+  non-Cave Age chunks, using the 1.21.1 spacing, terrain and clearance checks.
+- Library loot defaults to `LEGACY`; optional `AGE_ONLY` limits new library Pages
+  to known symbols originally written into that Age. Original writing is saved
+  separately and restored on reload. Older Ages without it have an empty Age-only
+  pool. Ordinary Books replace stand Pages when that pool is empty.
+- Added operator library placement, candidate/probe/loot diagnostics, session-only
+  test spacing and a locator limited to nearby already-loaded chunks.
+- Hand-prepared Link Panel ink cost is server-configurable (default two). The
+  Ink Mixer still consumes one ink unit and one paper per panel. Writing Desk
+  ink handling now uses the shared service.
+
+## Crystal portals
+
+- Ported craftable Book Receptacles with all six mounting orientations and the
+  existing 1.21.1 model/book transforms. A bound Linking or Descriptive Book
+  activates a valid connected crystal frame, including supported irregular frames.
+- Reused the bounded crystal flood/tension algorithm, placement protection events,
+  rollback, owner persistence, restart repair, frame cleanup and traversal cooldown.
+- Empty-hand removal closes the portal and returns the book. Breaking the holder
+  or its crystal support closes it and drops a recoverable open-book entity.
+- Player and non-player travel reuse book destinations, safe arrival, Intra-Linking,
+  Disarm and momentum rules. Descriptive Books share the same landing resolver
+  with portals; no separate portal exit offset is added. Player Return Link policy
+  and progression remain in force.
+- The animated fallback surface renders its facing sides and uses destination sky
+  tint. The Open Portal advancement and receptacle recipe unlock are restored.
+  Live destination views are still pending optional integration work.
+
+## Instability and colored decay
+
+- New Ages save operator-only creation-time score contributions and deterministic
+  provider selections using all five Legacy decks. Existing Ages remain neutral;
+  reloads/config changes do not reroll stored plans.
+- Initial scoring covers Bright Lighting, Accelerated, Corrupted Pages, ineffective
+  Cave sky/weather modifiers, excess and biome-forced structures, and extra suns.
+  Corrupted Pages now bind successfully and retain their animated redacted text.
+- Ported 18 potion providers: local/global Blindness, Fatigue, Hunger, Nausea,
+  Poison, Slowness, Weakness and Wither, plus hostile Regeneration/Resistance.
+  General effects affect eligible Survival/Adventure players and living entities;
+  Creative/Spectator remain exempt. Local variants require sky exposure.
+- Added a bounded occupied-Age scheduler, owned-effect cleanup, provider controls
+  and operator score/status, enable/disable, session test-score and pulse commands.
+  Effects supplied or extended by another source are preserved.
+- Ported Blue, Purple, Red and White decay with the existing 16x16 textures,
+  hardness/air conversion odds, saved per-color frontiers and attempt sequence.
+  White retains stepping-contact magic damage. Decay has no item form or drops.
+- Spread uses only already-loaded candidate chunks, bounded attempts and action
+  budgets. Fluids, block entities, critical/unbreakable blocks, infrastructure,
+  protected tags and claim events prevent conversion.
+- The first resolved book/portal arrival is saved for spawn protection. Re-enter
+  an older Age once to record it. Global/Age/provider and world-mutation controls
+  gate spread; existing decay blocks remain when spreading is disabled.
+- Test a color with `/rivencraft_port instability decay blue 32` (also `purple`,
+  `red`, `white`); output includes actual changes and nearby tracked coordinates.
+  Scores are not added to ordinary book or Binder displays.
+
+## Validation and remaining work
+
+Player in-game checks passed .116–.120. Both the 26.3 and 1.21.1 builds passed;
+Gradle has no standalone test sources. Targeted disposable dedicated-server checks
+covered library placement, portal entity travel and restart ownership/cleanup,
+potion application/cleanup and persistence, all four decay colors, saved spread
+continuation, and bedrock/fluid protection. Test servers were stopped and their
+worlds removed.
+
+Full writing recovery/penalties, live material-abundance profiling, other instability
+hazards, remaining discovery/stations and optional integrations still need port work.
+Unported hazard cards remain saved and are reported as unavailable, rather than
+being replaced with different cards. Book previews remain the animated fallback.
+Machine acceleration (#112), Writing Desk model placement (#113), and the matching
+1.21.1 universal dropped-book fix (#114) remain tracked separately.
+
+Use matching client/server beta builds (catalog protocol 10). Keep Minecraft tracks
+and saves separate, back up beta worlds, and do not downgrade saves containing new
+blocks or data to earlier betas.