diff --git a/Server-and-Operator-Guide.md b/Server-and-Operator-Guide.md index 3fc54dd..d7451cc 100644 --- a/Server-and-Operator-Guide.md +++ b/Server-and-Operator-Guide.md @@ -14,15 +14,15 @@ The server also has writing-ink and instability settings. Review the generated N ## Allowing or blocking random Pages -Edit the world's `serverconfig/rivencraft-server.toml` and restart the server (or leave and reopen a singleplayer world). The lists use full, quoted Symbol Page IDs—not display names. To prevent **Static Sky** from being chosen for new Link-Panel-only random Ages or appearing in newly generated Age-library Pages: +Edit the world's `serverconfig/rivencraft-server.toml` and restart the server (or leave and reopen a singleplayer world). The lists use quoted Symbol Page paths—not display names. The `rivencraft:` namespace is assumed and can be omitted; existing full IDs remain valid. To prevent **Static Sky** from being chosen for new Link-Panel-only random Ages or appearing in newly generated Age-library Pages: ```toml [random_pages] allowlist = [] -blocklist = ["rivencraft:sky/static"] +blocklist = ["sky/static"] ``` -Alternatively, an allowlist can limit a particular Page family. For example, `allowlist = ["rivencraft:sky/overworld", "rivencraft:sky/end"]` limits random sky styles to those two; terrain, features, and other families stay unrestricted. An allowlist only restricts families it names, and the blocklist wins if an ID appears in both lists. Biome-distribution Pages (such as `rivencraft:biome/tiny`) are treated as a separate family from individual biome Pages (such as `rivencraft:biome/plains`). Use the Page ID visible in the symbol data (`data/rivencraft/rivencraft/symbols/`) for bundled Pages; generated biome and material Page IDs have the same IDs shown by JEI advanced tooltips. +Alternatively, an allowlist can limit a particular Page family. For example, `allowlist = ["sky/overworld", "sky/end"]` limits random sky styles to those two; terrain, features, and other families stay unrestricted. An allowlist only restricts families it names, and the blocklist wins if a path appears in both lists. Biome-distribution Pages (such as `biome/tiny`) are treated as a separate family from individual biome Pages (such as `biome/plains`). Use the path under `data/rivencraft/rivencraft/symbols/` for bundled Pages, without the `.json` extension. Generated biome and material Pages can be identified by JEI advanced tooltips; remove the `rivencraft:` prefix when adding them to these lists. This is a *future-generation policy*, not a ban on player-owned Pages. It does not remove items from Creative or JEI, reject a hand-authored Descriptive Book, or rewrite an existing Age. New random Ages save their list policy when bound. Libraries apply the current lists when they generate; existing contents are unchanged. Native Minecraft biome presets are not assembled from individual biome Pages, so blocking a biome Page does not remove that biome from a Native distribution.