Server Owner Guide Overview

Previous: Core Concepts & Architecture　·　Next: Ruin Template (full template.yml fields)

This is the home page of the Server Owner Guide (zone 02). This zone teaches you how to take a ruin all the way from "a pile of files on disk" to "a complete experience where players stumble into it in the world, clear it, and grind tiers."

Tip

Still fuzzy on terms like "template / anchor / placement profile / blueprint / realm"? Read Core Concepts & Architecture first; coming back to this zone afterward will go a lot more smoothly.

🗺️ A Ruin from Nothing

The flowchart below strings together all the chapters of the Server Owner Guide into a single pipeline. Top to bottom is the actual order in which you configure a ruin, with each step linking to its corresponding chapter.

text

 ① Prepare the structure body (blocks)
    ├─ Select an existing build in the world ──→ /qr pos1 /qr pos2 /qr save
    └─ Import a WorldEdit .schem ──────────────→ /qr import
                        │
                        ▼
 ② Write the ruin template template.yml (its ID: what it looks like / which structure / where it generates / what it drops)
                        │
            ┌───────────┼─────────────┐
            ▼           ▼             ▼
 ③ Configure "where"  ④ Configure "gameplay"   ⑤ Configure "output"
   Placement Profile    Blueprint               Loot
   generators/*.yml     blueprint.yml           loottables/*.yml
            │           │             │
            └───────────┼─────────────┘
                        ▼
 ⑥ Preview & deploy: /qr stage ghost preview → confirm; or hand it to the Director for natural generation
                        │
                        ▼
 ⑦ Endgame: player clears → right-clicks the core with a Keystone → injects tiers + affixes = Realm
                        │
                        ▼
 ⑧ Player experience: guide compass points the way, codex collection, party-shared progress, bossbar

📚 Find a Chapter by Topic

Building Ruins (structure + template + gameplay)

Chapter	What you'll learn	Link
Ruin Template	`template.yml` field by field: id / display / icon / structure reference / generation / loot / reward / entry / foundation / titles / guide item	Ruin Template
Structure Files	`.nbt` vs `.schem`, `/qr import` conversion, mask-blend into terrain, marker blocks, foundation fill, frame-spread placement, rotation	Structure Files
Selection & Saving	`/qr pos1` `/qr pos2` selection, `/qr save` to store a template, `/qr stage` ghost preview, `/qr remove` to restore	Selection & Saving
Blueprint & Objectives	`blueprint.yml`: spawn points / phased kill objectives / unlock reward chests / core / sub-structure variants	Blueprint & Objectives
Spawning & Clearing	anchor activation, phase progression, protection lock, clear-unlock	Spawning & Clearing
Mechanism System	triggers (redstone / interact / region / timer / phase / break) × actions (fill / spawn / teleport…)	Mechanism System

Generation (where it appears, how much)

Chapter	What you'll learn	Link
Placement Profiles	`generators/*.yml`: dimension / world / biome / generation layer / flatness / spacing, 17 built-in profiles	Placement Profiles
Natural Generation & Pre-load	Director weighted draws, global density, live-world ticking, fade-and-regen, snapshots	Natural Generation & Pre-load
Procedural Generation	palette tiling, weighted-random sub-structure variants	Procedural Generation

Endgame & Output

Chapter	What you'll learn	Link
Realms & Keystones	keystone activation, tier curve, purge rewards, reforge gambling, keystone ladder	Realms & Keystones
Affix System	five affix categories, danger budget, mutual-exclusion groups, command / JS customization	Affix System
Loot System	container loot (per-player / server-shared), unlock reward chests, purge slot machine, growth scaling	Loot System

Player Experience

Chapter	What you'll learn	Link
Guide & Codex	guide compass points to the nearest ruin of the same kind, codex strategy card recorded on discovery	Guide & Codex
Party & Session	enter/leave prompts, bossbar, party-shared progress	Party & Session

🚦 Where Should I Start?

Already have a finished build in hand → first read Selection & Saving to store it as a template, then return to Ruin Template to flesh out the fields.
Have someone else's .schem schematic → read the /qr import section in Structure Files.
Starting from scratch, want to understand the whole setup → follow the flowchart above in order ①→⑧, starting from Ruin Template.
Just want to fatten up an existing ruin / add endgame → jump straight to Realms & Keystones and Loot System.

🖼️ [Image placeholder] A three-shot sequence of "select a build → save template → naturally generated appearing in the world" · suggested assets/owner-workflow.png

🔧 Don't Forget After Configuring

After editing any YAML (template / blueprint / profile / loot table / affix) → /qr reload to apply.
To confirm whether a ruin can generate where you stand → /qr why <template> / /qr gentest, see Diagnostics & Troubleshooting.
Quick reference for all commands, permissions, and config keys → Command Reference · config.yml full configuration.

Next Step

Start configuring your first ruin → Ruin Template (full template.yml fields)

Server Owner Guide Overview ​

🗺️ A Ruin from Nothing ​

📚 Find a Chapter by Topic ​

Building Ruins (structure + template + gameplay) ​

Generation (where it appears, how much) ​

Endgame & Output ​

Player Experience ​

🚦 Where Should I Start? ​

🔧 Don't Forget After Configuring ​

Next Step ​