结构百科全书

结构百科全书

探索世界，解锁遗迹，填满一本皮面装订的发现之书。结构百科全书将结构探索转化为百科全书页面——包含传说、描述、生物和知名战利品——并以书本风格的界面呈现。

特性

• 探索解锁 — 页面初始为锁定状态（???）。站在已收录的结构内即可解锁。
• 随时打开 — 按 K 键（可配置）或使用可合成的百科全书物品。
• 可合成书本 — 书 + 指南针 + 紫水晶碎片。
• 索引与详情页 — 分页网格展示结构图标；打开页面可查看传说、生物和战利品（图标带有悬停名称）。
• 原版覆盖 — 内置了众多原版结构的精选条目。
• 数据包可扩展 — 其他模组和数据包可以添加或替换条目，无需编写 Java 代码。

玩法指南

1. 合成结构百科全书（或从创造模式物品栏中获取）。
2. 使用物品或按键绑定打开它。
3. 探索 — 当你进入一个已收录的结构时，操作栏会显示消息确认解锁。
4. 返回书本阅读该页面。

---

给数据包与模组作者

条目是普通的数据包 JSON。任何位于 data/<命名空间>/structure_encyclopedia/*.json 下的内容都会在服务器端加载并同步至客户端。

添加新结构

创建一个新的 JSON 文件。structure 字段必须是准确的注册表 ID（来自 /locate structure 或结构注册表），例如 minecraft:desert_pyramid 或 yourmod:cool_dungeon。

{
  "structure": "yourmod:cool_dungeon",
  "icon": "minecraft:mossy_cobblestone",
  "sort_order": 200,
  "lore": "yourpack.entry.cool_dungeon.lore",
  "description": "yourpack.entry.cool_dungeon.desc",
  "mobs": ["minecraft:zombie", "minecraft:skeleton"],
  "loot_items": ["minecraft:diamond", "minecraft:emerald"],
  "loot_tables": ["yourmod:chests/cool_dungeon"],
  "tags": ["overworld", "dungeon"]
}

字段参考

字段	必需	说明
structure	是	注册表 ID。每个 ID 对应一个百科全书页面。
icon	是	在索引和详情页标题中显示的物品 ID。
lore / description	是	翻译键（在语言文件中添加字符串）。
sort_order	否	默认 0。数值越小在索引中越靠前。
mobs	否	实体类型 ID。
loot_items	否	用于“知名战利品”图标行的物品 ID。
loot_tables	否	可选的元数据（战利品表 ID）。
tags	否	用于自行分类的自由标签。

可选的显示名称覆盖（资源包 / 模组语言文件）：

"structureencyclopedia.name.yourmod.cool_dungeon": "酷炫地牢"

如果缺少该键，客户端会回退到原版的 structure.<命名空间>.<路径> 翻译。

覆盖现有条目

页面通过 structure ID 唯一标识——书本不会为同一结构显示两个页面。

• 推荐： 替换你要更改的条目所对应的相同资源路径。示例——通过在你的数据包或模组 JAR 中放置以下文件来覆盖本模组的堡垒页面： data/structureencyclopedia/structure_encyclopedia/fortress.json 并确保其加载顺序在结构百科全书之后。Minecraft 只会保留该路径下的最终文件。
• 同样有效： 使用一个不同的文件名，但仍然设置 "structure": "minecraft:fortress"。加载器会为每个结构 ID 保留一个条目（你可能会在日志中看到重复警告）。当包加载顺序重要时，优先使用同路径替换。

提示

• 查看 data/structureencyclopedia/structure_encyclopedia/ 下内置的原版 JSON，以获取可用的示例。