符文典籍

符文典籍

符文典籍给予每位玩家一本永久的魔法书，当指南书和手册进入你的背包的一瞬间，它会自动吸收它们，将杂乱替换为一座整洁的图书馆。随时打开典籍，浏览所有收集到的书籍。

符文典籍预览查看大图

符文宝典

一本宝典，收纳所有手册

厌倦了箱子里塞满重复的指南书？把你的《材料与你》手册丢进岩浆？每次搬家都要拖着八本手册来回跑？符文宝典帮你解决。

符文宝典会给予每位玩家一本独一无二、永久存在的书——符文宝典。只要任何指南书进入你的物品栏——无论是拾取、合成、任务奖励、指令，还是其他任何方式——宝典都会悄无声息地将其吸收。实体书消失，其内容作为新条目出现在宝典的图书馆中。一个物品，永久收纳。

打开宝典即可浏览你收集过的所有手册。点击条目，即可打开真正的原版书本界面。

✨ 功能特性

  • 吸收你触碰到的每一本指南书——绝不会误收其他物品。 地面拾取、合成产物、熔炼产物、任务奖励、KubeJS 发放、/give 指令、容器关闭——所有路径均被覆盖，近乎即时生效。只有当书籍被安全存入宝典后才会被移除；如果存储失败，物品将保持原样，不会被消耗。
  • 一件物品，永久有效。 首次进入世界时自动获得宝典，拥有史诗品质，最大堆叠数为 1，并且耐火。你解锁的书籍会跨死亡、物品丢失乃至宝典本身而永久保留——即使条目损坏也不会破坏你的存档。
  • 可搜索的图书馆界面。 打开宝典会显示一个可滚动的列表，列出你收集的所有书籍，并附带真实的物品图标和实时计数。支持按名称搜索，右键可将书籍（设为收藏）置顶，左键可打开原版书籍的原生界面。
  • 无物品栏杂乱。 书籍以虚拟形式存储在玩家数据中——并非真实的物品堆叠。你的物品栏将始终保持整洁。
  • 兼容一切 Patchouli 内容。 开箱即用，符文宝典可识别整合包中的所有 Patchouli 书籍——包括使用自定义书籍物品的模组（如新生魔艺的破旧笔记本、植物魔法的植物魔法辞典等）。
  • 大量内置集成。 匠魂（全部六本书）、MC 来啦、更好的动物+、沉浸工程（工程师手册）和模组百科都会被自动识别——此外，还提供了一个关键词兜底机制，可吸收未明确支持模组的指南书。
  • 支持整合包和数据包配置。 通过简单的配置项即可添加任何独立的书籍类物品，或在数据包中定义书籍（data/<命名空间>/runictome/books/*.json），并同步至客户端。无需编写代码，无需修补。
  • 对模组作者友好。 提供一个小型公共 API 和 IMC 钩子，其他模组可借此注册自己的指南系统——或注册一本可打开的书籍。

🎮 使用方法

  1. 进入世界。 符文宝典会自动出现在你的物品栏中。
  2. 获得指南书。 任何方式皆可。拾取、合成、任务奖励、/give 指令，等等。宝典会近乎即时地将其吸收——你会看到书籍消失，并收到一条提示（包含书名）确认解锁。
  3. 右键点击宝典。 一个可搜索、可滚动的图书馆界面打开，列出你收集的所有书籍，每本都带有图标。
  4. 查找并打开。 输入文字搜索，左键点击条目打开其原生界面，或右键点击将其设为收藏（收藏项会置顶显示）。
  5. 点击“完成”或按 ESC 关闭。 宝典会回到你的快捷栏中。

就这么简单。无需合成配方，无需仪式，无需学习新界面。在你想阅读之前，这个模组几乎是隐形的。

🔌 兼容性

已确认支持的指南系统：

  • Patchouli（以及所有使用它的模组——植物魔法、新生魔艺、冰与火之 delight、机械动力附属等）
  • 匠魂（全部六本书）
  • MC 来啦、更好的动物+、沉浸工程（工程师手册）、模组百科
  • 关键词兜底机制，可吸收未明确支持模组的指南书

通过配置或数据包添加更多书籍： 将任意物品 ID 添加到 config/runictome-common.toml 中的 extraBookItemIds，或在 data/<命名空间>/runictome/books/*.json 中定义书籍。配置示例：

[integrations]
extraBookItemIds = [
    "immersiveengineering:manual",
    "occultism:dictionary_of_spirits",
    "farmersdelight:cookbook",
]

对于模组作者： 符文宝典提供了一个公共的 GuideSystemAdapter API 和一条 IMC 注册路径。如果你的模组带有自己的指南系统，接入大约只需 20 行代码。详情请参阅 GitHub 仓库。

❓ 常见问题

问：这个模组会替换我现有的书籍吗？ 答：它会在首次接触时将书籍吸收到一个虚拟图书馆中。原书会消失，但你仍然可以通过宝典一键打开它们——并且保留了原模组的原生界面。

问：如果我丢失了宝典怎么办？ 答：你解锁的书籍存储在玩家数据中，而非宝典本身。重新合成一本宝典（或使用 /give 指令——如果你没有宝典，模组会在下次登录时自动重新给予），你的完整图书馆仍然完好无损。

问：它在专用服务器上有效吗？ 答：是的。该模组以服务端为权威——所有吸收决策均在服务端进行，解锁书籍列表会同步到客户端。请在两端都安装。

问：它会误收我不想吸收的东西吗？ 答：不会。关键词兜底机制仅匹配书籍类物品，会跳过方块物品和原版书籍。功能性装备绝不会被吸收： 铁咒法的法术书（以及卷轴等法术容器）会通过其物品类/能力被检测到——因此来自任何铁咒法附属模组的法术书，例如学徒法典的《异世界旅行指南》，都会被自动排除，无需逐个模组设置黑名单。RPG 传说则保留其自己的收集系统。你还可以通过模组 ID、物品 ID 或物品标签（#runictome:absorb_blocklist）在配置中排除任何其他物品——无需代码。而且，解锁失败时绝不会销毁任何物品——如果书籍无法存储，该物品会原样保留在你的物品栏中。

问：如何为我模组中的书籍添加支持？ 答：如果你的模组使用 Patchouli，那么它已经可以正常工作。如果它使用独立物品，请将物品 ID 添加到 extraBookItemIds。如果你在构建新的指南系统，请实现 GuideSystemAdapter 并通过 IMC 注册——请参阅 GitHub README。

问：性能开销如何？ 答：可忽略不计。书籍的吸收是事件驱动的（在拾取、合成、熔炼和容器关闭时触发）。默认情况下，每秒执行一次定时扫描（可通过 sweepIntervalTicks 配置），作为绕过 Forge 事件的物品栏插入（例如 /give）的安全网。

📦 安装方法

  1. 为 Minecraft 1.20.1 安装 Minecraft Forge 47.3.0+。
  2. 从此 CurseForge 页面下载最新的符文宝典 jar 文件。
  3. 将其放入你的 mods/ 文件夹。
  4. 启动 Minecraft。安装完成。

符文宝典没有硬性依赖。 如果运行时存在 Patchouli 和匠魂，它们都会被自动识别——模组会优雅地跳过无法加载的集成。

🔗 相关链接

🙏 鸣谢

  • Otectus —— 作者、代码、设计。
  • vazkii —— 感谢你创建了 Patchouli，没有它，这个模组一半的价值都将不复存在。
  • Forge MDK、Parchment 映射以及 Minecraft Forge 社区。

许可协议： MIT。可在整合包、直播、视频及衍生作品中自由使用。欢迎署名，但非强制要求。