玩家玩法
操作速查
| 操作 | 结果 |
|---|---|
| 点击物品栏底部的辑录册页签 | 打开辑录册。 |
| Shift + 点击物品栏底部的辑录册页签 | 直接进入揭秘界面。 |
| 手持辑录册右键 | 同步进度并打开辑录册。 |
| 手持辑录册 Shift + 右键 | 进入揭秘界面。 |
| 手持普通辑录页右键 | 直接阅读该页记录的单条辑录。 |
| 手持共享辑录页右键 | 收录其中自己尚未拥有的辑录，并消耗该页。 |
| 手持旧版揭秘集右键 | 进入揭秘界面。 |
获得辑录册
默认配置下，每名玩家第一次进入世界时会获得一本 reveal:index_book。这里只发放辑录册，不会发放旧版揭秘集。
首次发放只执行一次：辑录册丢失后不会自动补发；如果玩家第一次进入时服务器关闭了自动发放，之后重新开启也不会给这名玩家补发。当前版本没有内置的辑录册合成配方。
管理员可以直接给予：
/give @s reveal:index_book
整合包可以关闭 give_index_book_on_first_join，改用任务、商店、战利品表或自定义配方发放。
打开辑录册
玩家不必把辑录册拿在手上。打开物品栏后，底部会出现一个与原版物品栏相连的伸缩页签：
- 点击页签打开辑录册。
- 按住 Shift 点击页签，直接进入揭秘界面。
- 同时安装支持同一底部页签规范的潮汐系列模组时，各模组按钮会并排排列。
手持辑录册普通右键和 Shift + 右键仍然保留。每次打开时，模组会合并玩家数据、主背包和副手中所有辑录册的进度。
默认配置的 vanilla_tips.initial_unlocked 为 3，玩家第一次打开辑录册时会获得该篇章排序最前的 3 条辑录。隐藏篇章不会通过 initial_unlocked 自动解锁。
目录与阅读
book_clean 先显示篇章列表；book_old 会把篇章和辑录排列在同一页。右上角“样式”按钮可以在两种外观之间切换。
- 点击篇章进入对应的辑录列表。
- 点击已解锁辑录进入阅读页。
- 未解锁辑录只显示剪影，不能打开正文。
- 新获得但尚未阅读的辑录会显示金色五角星。
- 打开该辑录后即视为已读；返回目录时五角星立即消失。
- 隐藏篇章只有在玩家至少获得其中一条辑录后才会出现。
- 鼠标滚轮和页面两侧按钮均可翻页。
阅读页支持同一辑录内翻页，以及切换到同篇章相邻的已解锁辑录。空格、物品栏键或“返回辑录册”按钮会回到刚才的目录位置。
解锁方式
1.2.0 支持四种解锁条件：
| 类型 | 触发方式 |
|---|---|
materials | 在揭秘界面放入一件或两件指定物品并点击“揭秘”。 |
kill_entity | 玩家亲自击杀指定生物。 |
enter_biome | 玩家进入指定群系。 |
advancement | 玩家完成指定原版或数据包进度。 |
后三种由服务器自动检测，不需要玩家打开揭秘界面。每条解锁方式既可以从整个篇章中按篇章策略选取下一条辑录，也可以直接指向某一条辑录。
材料揭秘
- 把一件或两件线索物品放入 线索 A / 线索 B。
- 界面会显示“可揭秘”“无法揭秘”或“已经完成”等状态。
- 点击“揭秘”。
- 成功后写入玩家进度和背包中的辑录册，并按配置发放经验或普通辑录页。
单物品条件可放在任意一个槽位；双物品条件不区分 A、B 顺序。Shift + 点击可从背包快速移入材料。关闭界面时，未使用的物品会退回背包，背包已满时掉落在玩家附近。
每条材料解锁方式都能单独设置 consume_inputs：
true：生存模式成功揭秘后，每个命中的槽位消耗 1 个物品。false：成功揭秘后保留材料。- 创造模式是否消耗还受根配置
creative_consumes控制。 - 条件未命中、目标不存在或目标已经完成时不会消耗材料。
默认材料条件
| 材料 | 目标 |
|---|---|
| 纸 | vanilla_tips 篇章 |
| 哭泣的黑曜石 + 墨囊 | omitted_note 篇章 |
| 书 + 荧光墨囊 | unknown_language 篇章 |
| 紫水晶碎片 + 墨囊 | whisper 篇章 |
任意 minecraft:creeper_drop_music_discs 标签物品 | creeper_secret 篇章 |
| 铁镐 + 面包 | survival_notes 篇章 |
| 已填写的地图 + 回响碎片 | world_rumors 篇章 |
| 指南针 | misc/compass，材料保留 |
| 时钟 | misc/clock，材料保留 |
| 命名牌 | misc/name_tag，材料保留 |
实际内容以服务器的 config/reveal/reveal.json 为准。
辑录册右上角按钮
揭秘
不退出辑录册即可进入材料揭秘界面。
共享
点击“共享”会生成一张共享辑录页，其中包含玩家当前拥有的全部有效辑录。如果背包已满，共享页会掉落在玩家附近。
共享页的提示为“玩家名的 N 条辑录”。其他玩家右键使用后：
- 只收录自己尚未拥有的有效辑录。
- 把更新后的进度写入玩家数据和背包中的辑录册。
- 消耗一张共享页。
共享不会移除导出者自己的进度。
日志
研究日志最多保存最近 50 条记录，包括：
- 解锁了哪条辑录；
- 导出了包含多少条辑录的共享页；
- 收录了哪名玩家的共享页，以及新增了多少条辑录。
普通辑录页与共享辑录页
两者使用同一个物品 ID：reveal:story_page，但保存的数据和用途不同。
- 普通辑录页只对应一条辑录，右键直接阅读，不会把内容加入玩家进度。
- 共享辑录页保存导出者名称与多条进度，右键后写入玩家进度并消耗。
give_story_page_on_unlock只控制解锁时是否发放普通辑录页。
经验与篇章策略
经验奖励按“辑录 → 篇章 → 根配置”的顺序确定。experience_reward 为 -1 时继续继承，为 0 时明确不奖励经验。
| 策略 | 行为 |
|---|---|
ordered | 按 order 和辑录 ID 依次解锁。 |
pool | 只在当前最小 order 的一组辑录中按 weight 抽取。 |
random | 在该篇章全部未解锁辑录中按 weight 抽取。 |
当解锁方式指定了 target_entry 时，不再进行随机或顺序选择，而是直接解锁目标辑录。
JEI 联动
安装 JEI 后，可以查看当前非隐藏的材料揭秘条件，并使用配方转移按钮把材料移入两个线索槽。JEI 会注明该条件揭秘后是否保留材料。
击杀生物、进入群系和完成进度属于事件触发条件，不作为材料配方显示在 JEI 中。
进度同步
Reveal 同时在玩家数据和辑录册物品中保存进度。打开辑录册或揭秘界面时，会合并：
- 当前玩家的进度；
- 主背包中所有辑录册的进度；
- 副手辑录册的进度。
新解锁或从共享页收录的内容也会写回这些辑录册。箱子、潜影盒和地面掉落物中的辑录册不会自动参与同步，需要先取回背包。
旧版揭秘集
reveal:reveal_codex 仅为旧存档和旧配方保留：右键直接进入揭秘界面，不提供目录、日志和共享入口，也不会在首次进入世界时自动发放。