Files
rivencraft/docs/AGES.md
T
dnorberg b06fbda461
Build / build (push) Canceled after 0s
Complete Age lifecycle management (#8)
2026-09-23 00:55:26 -04:00

1.8 KiB

Age administration

Rivencraft owns each Age definition for the lifetime of a world. A definition contains the Age UUID, canonical name, seed, generation version, runtime dimension identifier, spawn, and deterministic traits. Definitions are stored in the Overworld saved data and are never rerolled during ordinary loading.

Lifecycle

An Age definition is created before its runtime dimension. If dimension creation is interrupted, the saved definition remains authoritative and the same Age is reconstructed the next time its Descriptive Book is used.

Registered Ages load when the server starts. A book also loads its destination on demand when an administrator previously unloaded it. Unloading retains the definition and world folder, so existing books continue to reference the same Age and later reload the same terrain.

Rivencraft does not automatically delete Ages. Safe permanent deletion needs a complete reference index for books in inventories, containers, Book Stands, and unloaded chunks. Until that exists, retaining the definition prevents an administrator action from silently orphaning books.

Destination-preview chunk loaders are temporary. Rivencraft releases them when the book closes, the player travels, the player disconnects, the destination Age is unloaded, or the server stops.

Commands

The commands require permission level 2.

  • /rivencraft age list lists every registered Age and whether its runtime dimension is currently loaded.
  • /rivencraft age unload <dimension> safely unloads one Age. Players in that Age are handled by Dynamic Dimensions, and its definition and world data are retained. Use the command suggestions to select a registered dimension.

Opening a Descriptive Book for an unloaded Age loads it again from its saved definition.