Create persistent runtime Ages

README.md

@@ -5,9 +5,9 @@ Rivencraft is a clean, incremental port of the ideas and gameplay of
 1.21.1 on NeoForge.
 
 The bootstrap and books/linking milestones are complete. The project currently
-provides functional Linking Books and temporary vanilla-dimension Descriptive
-Book destinations with generated Return Links. Age generation, symbols,
-instability, and writing mechanics have not been ported yet.
+provides functional Linking Books and randomly seeded, persistent vanilla-like
+Ages created from page-free Descriptive Books. Symbols, instability, and the
+full writing mechanics have not been ported yet.
 
 ## Linking Book
 
@@ -33,13 +33,16 @@ independently validates every link.
 
 ## Descriptive Book
 
-Until generated Ages arrive in Milestone 3, written Descriptive Books resolve
-deterministically to the Overworld, Nether, or End according to their Age UUID.
-The Rivencraft creative tab includes one sample book for each. Linking creates
-a bound Return Link to the exact source position and orientation on an Age's
-first successful visit. Descriptive
-Book destinations additionally require solid footing beneath the player. If
-their recorded arrival is unsafe, they search nearby terrain for a footed spot.
+Open a page-free Descriptive Book, name its Age, and press Create. Rivencraft
+assigns the book a permanent Age UUID, creates a dedicated vanilla-like runtime
+dimension, and prepares a five-by-five cobblestone arrival platform at the
+highest suitable nearby terrain. If no sturdy surface is available, the
+platform is generated at Y=63. Reopen the book and click its preview to travel.
+Copies of the written book continue to resolve to the same persistent Age
+across server restarts.
+
+Linking creates a bound Return Link to the exact source position and orientation
+according to the configured Return Link policy.
 
 Server owners can set `descriptive_books.return_link_mode` in Rivencraft's
 server config to `ON_CREATION` (default), `ALWAYS`, or `DISABLED`.
@@ -50,6 +53,7 @@ server config to `ON_CREATION` (default), `ALWAYS`, or `DISABLED`.
 - Minecraft 1.21.1
 - NeoForge 21.1.251 or newer in the 21.1 line
 - Ponder 1.0.82 for Minecraft 1.21.1 (client)
+- Dynamic Dimensions AR Edition 0.9.1 and Bad Packets 0.8.2 (client and server)
 
 ## Build and run