diff --git a/Server-and-Operator-Guide.md b/Server-and-Operator-Guide.md new file mode 100644 index 0000000..7f640cb --- /dev/null +++ b/Server-and-Operator-Guide.md @@ -0,0 +1,25 @@ +# Server and Operator Guide + +Run the same required gameplay mods on server and clients: Rivencraft, Dynamic Dimensions AR Edition, and Bad Packets. See [Installation](Installation) for versions and optional integrations. Stop the server before making a **complete world-folder backup**; copying only a dimension folder is not enough to restore an Age and its books. + +## Useful settings + +- descriptive_books.return_link_mode: DISABLED (default), ON_CREATION, or ALWAYS. +- libraries.loot_mode: LEGACY or AGE_ONLY (Pages describing the containing Age). +- serene_seasons.auto_whitelist_ages: automatically enroll eligible Ages when the optional season mod is installed. +- Client-side book_preview.mode: AUTO, IMMERSIVE_PORTALS, PONDER, or LEGACY. + +The server also has writing-ink and instability settings. Review the generated NeoForge config and make a backup before changing a live world. Client preview settings do not change server-side Age generation or travel rules. + +## Operator commands + +- /rivencraft age list shows registered Ages and whether each runtime dimension is loaded. +- /rivencraft age unload unloads an Age while retaining its definition and world data. Opening its Descriptive Book can load it again. +- /rivencraft library nearest looks for a generated Age library and teleports the operator to a suitable one if found. It may generate candidate chunks while searching. +- /rivencraft binder messages enable and /rivencraft binder messages disable control detailed Binder diagnostics. Only OPs see these messages when enabled. + +The creative-only **Link Modifier** can change link properties and deliberately retire an unoccupied Age. Retirement marks its UUID dead and archives its data in a sibling retired-Ages folder. It is not routine maintenance; back up the entire world first. See [Age administration and recovery](https://git.paddedcell.org/dnorberg/rivencraft/src/branch/main/docs/AGES.md). + +Library testing commands exist for development, including /rivencraft library test-place and test-spacing. They can place structures or generate extra candidate chunks; do not use them as ordinary gameplay commands. The [library audit](https://git.paddedcell.org/dnorberg/rivencraft/src/branch/main/docs/LEGACY_M7_AUDIT.md) documents their behavior. + +When reporting a server issue, include the Rivencraft, Minecraft, NeoForge, and required-mod versions; whether optional mods are present; reproduction steps; and a relevant log excerpt. Remove account tokens, private server addresses, and personal information before attaching logs. [File an issue](https://git.paddedcell.org/dnorberg/rivencraft/issues).