服主指南总览
上一页：核心概念与架构 · 下一页：遗迹模板（template.yml 全字段）
这是服主指南（02 区）的首页。这一区教你把一座遗迹从「磁盘上的一堆文件」一路配成「玩家在世界里撞见、打通、刷层」的完整体验。
提示
还没搞懂「模板 / 锚点 / 放置档案 / 蓝图 / 秘境」这些名词？先看 核心概念与架构，回来再读这一区会顺很多。
🗺️ 一座遗迹从无到有
下面这张流程图把整个服主指南的章节串成一条流水线。从上往下就是你实际配遗迹的顺序，每一步都给了对应章节链接。
text
① 准备结构本体（方块）
├─ 站在世界里框选已有建筑 ──→ /qr pos1 /qr pos2 /qr save
└─ 把 WorldEdit 的 .schem 导进来 ──→ /qr import
│
▼
② 写遗迹模板 template.yml（身份证：长啥样 / 用哪个结构 / 在哪生成 / 出什么）
│
┌───────────┼─────────────┐
▼ ▼ ▼
③ 配「在哪生成」 ④ 配「玩法层」 ⑤ 配「产出」
放置档案 Profile 蓝图 Blueprint 战利品 Loot
generators/*.yml blueprint.yml loottables/*.yml
│ │ │
└───────────┼─────────────┘
▼
⑥ 预览 & 投放：/qr stage 幽灵预览 → confirm；或交给生成总控自然生成
│
▼
⑦ endgame：玩家通关 → 钥石右键核心 → 注入层数 + 词缀 = 秘境
│
▼
⑧ 玩家体验：向导罗盘指路、图鉴收集、组队共享进度、bossbar📚 按主题找章节
造遗迹（结构 + 模板 + 玩法）
| 章节 | 你会学到 | 链接 |
|---|---|---|
| 遗迹模板 | template.yml 逐字段：id / 显示 / 图标 / 结构引用 / 生成 / 战利品 / 奖励 / 门槛 / 地基 / 标题 / 指引物 | 遗迹模板 |
| 结构文件 | .nbt vs .schem、/qr import 转换、掩码融地形、标记块、地基填充、分帧放置、旋转 | 结构文件 |
| 选区与保存 | /qr pos1 /qr pos2 框选、/qr save 存模板、/qr stage 幽灵预览、/qr remove 还原 | 选区与保存 |
| 蓝图与目标 | blueprint.yml：刷怪点 / 分阶段击杀目标 / 解锁奖励箱 / 核心 / 子结构变体 | 蓝图与目标 |
| 刷怪与通关 | 锚点激活、阶段推进、保护锁、通关解锁 | 刷怪与通关 |
| 机关系统 | 触发器（红石 / 交互 / 区域 / 计时 / 阶段 / 破坏）× 动作（填充 / 刷怪 / 传送…） | 机关系统 |
生成（在哪冒出来、冒多少）
| 章节 | 你会学到 | 链接 |
|---|---|---|
| 放置档案 | generators/*.yml：维度 / 世界 / 群系 / 生成层 / 平整度 / 间距，17 个内置档案 | 放置档案 |
| 自然生成与预加载 | 生成总控权重抽签、全局密度、活世界刷新、消退再生、快照 | 自然生成与预加载 |
| 程序化生成 | 调色板拼接、子结构变体加权随机 | 程序化生成 |
endgame 与产出
| 章节 | 你会学到 | 链接 |
|---|---|---|
| 秘境与钥石 | 钥石激活、层数曲线、净化奖励、重铸赌博、钥石天梯 | 秘境与钥石 |
| 词缀系统 | 五类词缀、危险预算、互斥分组、命令 / JS 自定义 | 词缀系统 |
| 战利品系统 | 容器战利品（每人独立 / 全服共享）、解锁奖励箱、净化老虎机、成长度缩放 | 战利品系统 |
玩家体验
| 章节 | 你会学到 | 链接 |
|---|---|---|
| 向导与图鉴 | 指引罗盘指向最近同类遗迹、发现即记图鉴攻略卡 | 向导与图鉴 |
| 组队与会话 | 进出提示、bossbar、组队共享进度 | 组队与会话 |
🚦 我该从哪开始？
- 手上已经有一座建好的建筑 → 先看 选区与保存 把它存成模板，再回 遗迹模板 完善字段。
- 手上是别人的
.schem原理图 → 看 结构文件 的/qr import一节。 - 完全从零、想搞懂全套配法 → 按上面流程图 ①→⑧ 顺序读，从 遗迹模板 入手。
- 只想让现成遗迹更肥 / 加 endgame → 直接跳 秘境与钥石 和 战利品系统。
🖼️ [图片占位] 一张「从框选建筑 → 存模板 → 自然生成出现在世界里」的三连截图 · 建议
assets/owner-workflow.png
🔧 配完别忘了
- 改完任何 YAML（模板 / 蓝图 / 档案 / 战利品表 / 词缀）→
/qr reload生效。 - 想确认遗迹能不能在脚下生成 →
/qr why <模板>//qr gentest，详见 诊断与排错。 - 全部命令、权限、配置项速查 → 命令大全 · config.yml 全配置。
下一步
- 开始配第一座遗迹 → 遗迹模板（template.yml 全字段）