Complete milestone 3 book previews and Age generators

docs/PORTING.md

@@ -215,6 +215,92 @@ player-assigned name. Names are converted to safe lowercase resource paths,
 and folder conflicts receive `_2`, `_3`, and later numeric suffixes. Existing
 UUID-based dimension folders remain unchanged for save compatibility.
 
+Version 0.2.10.6 prevents a Descriptive Book from reopening while its Age is
+being generated. Screen opening now waits for the server's current copy of the
+held or displayed book, so a delayed interaction opens only the completed Age.
+
+Version 0.2.11.0 adds a dependency-free, legacy-style portal bloom as the
+fallback destination preview for Linking and Descriptive Books. Clients with
+Create installed retain the rotating Ponder snapshot; clients without Create
+use the destination-tinted animation with the original effect's paired noisy
+spirals.
+
+Version 0.2.11.1 makes Create genuinely optional. Ponder remains a compile-time
+API for the Create integration, while generated mod metadata no longer requires
+Ponder and marks Create as an optional client dependency.
+
+Version 0.2.12.0 introduces the first legacy-inspired Age generator profiles.
+New page-free Ages deterministically select and persist Standard, Amplified,
+Island, Cave, Flat, or Void base terrain. Existing `random_vanilla` Ages remain
+mapped to their original Overworld generator for save compatibility. Terrain
+alterations such as Skylands, Tendrils, Spheres, and Floating Islands remain
+future Age-grammar work layered above these base profiles.
+
+Version 0.2.12.1 displays the persisted terrain generator on the description
+side of written Descriptive Books. Newly written books receive the synchronized
+profile immediately, while older books are backfilled from the server-owned Age
+registry when opened.
+
+Version 0.2.13.0 constructs Standard, Amplified, Cave, and Island terrain from
+Minecraft's worldgen registries instead of borrowing generator instances from
+the vanilla levels. Noise settings and biome-source parameter lists therefore
+honor the server's loaded data packs. Automated coverage also verifies that a
+live Age's seed equals its immutable saved definition; Dynamic Dimensions
+derives both from the Overworld seed and the Age dimension identifier.
+
+Version 0.2.14.0 restores the legacy Linking and Descriptive Book artwork for
+inventory items and gives each book its matching open-book texture when placed
+on a Book Stand. Return Linking Books created inside another Age also retain and
+display that Age's saved name instead of exposing its dimension identifier.
+
+Version 0.2.14.1 gives every newly bound Linking Book a friendly destination
+label. Standard books and Return Links use saved Age names inside Rivencraft
+Ages and the familiar Overworld, The Nether, and The End names in vanilla
+dimensions. Existing vanilla links receive the same presentation at display
+time without requiring item migration.
+
+Version 0.2.15.0 adds the client-side book-preview mode configuration and the
+selection policy for `AUTO`, `IMMERSIVE_PORTALS`, `PONDER`, and `LEGACY`.
+`AUTO` uses Ponder when Create is present and otherwise uses the built-in
+legacy animation. Explicit optional modes fall back to `LEGACY` when their
+renderer is unavailable.
+
+Version 0.2.16.0 implements the optional Immersive Portals GUI renderer. Its
+default view orbits the live destination like the Ponder snapshot. The Explore
+control switches to a movable remote camera using movement keys and mouse drag;
+right-click resets the camera and restores the passive book GUI. A validated
+per-player chunk loader exists only while the screen is open and is released
+on close. `AUTO` now prefers Immersive Portals, then Ponder, then `LEGACY`.
+
+Version 0.2.16.1 corrects Immersive Portals detection to use its NeoForge mod
+ID, `immersive_portals_core`. Rivencraft now also refreshes Immersive Portals'
+integer dimension map whenever saved or newly created Ages are loaded, before
+their chunks can be synchronized to a player.
+
+Version 0.2.16.2 routes book travel through Immersive Portals' seamless
+teleport API when that mod is installed, preserving its client-world registry
+during links between Ages and vanilla dimensions. The Explore control is also
+positioned fully below the live snapshot window on both book screens.
+
+Version 0.2.16.3 restores the full window viewport immediately after drawing
+an Immersive Portals snapshot. Book titles, destination details, and controls
+therefore render in their normal page positions instead of being compressed
+inside the snapshot rectangle.
+
+Version 0.2.16.4 clears the Immersive Portals GUI framebuffer between remote
+world renders, preventing moving camera frames from accumulating into a sky
+smear. The framebuffer now follows Immersive Portals' shared-target lifecycle
+so a queued end-of-frame render cannot target a texture destroyed on GUI close.
+
+Version 0.2.16.5 expands live-preview chunk loading to Immersive Portals'
+reference eight-chunk radius. Rivencraft prepares the central 3x3 destination
+chunks and requests an immediate tracking update when the GUI opens, providing
+terrain for the first useful snapshot while the remaining chunks stream in.
+
+Version 0.2.16.6 makes Linking and Descriptive Book screens non-pausing. The
+integrated server now continues ticking in single-player while a book is open,
+allowing live preview chunks to generate and stream into the snapshot.
+
 The preview code is separated behind a renderer interface and uses an isolated
 Ponder level populated from server-authoritative destination snapshots.