Pufferfish’s Skills: Iron’s Spellbooks Compat

Iron’s Spellbooks ↔ Pufferfish’s Skills 兼容

桥接 Iron’s Spells ‘n Spellbooks 与 Pufferfish’s Skills。将施法与铭刻法术锁定在已解锁的技能节点之后，或直接授予无需法术书、通过快捷键施放的天生法术。

---

特性

主要有 2 个特性：将施法与铭刻法术锁定在 Pufferfish 技能节点之后，以及允许玩家获得无需任何法术书即可施放的天生法术。

施法与铭刻限制

技能门控的施法与铭刻。 当玩家尚未解锁配置的技能时，在所有施法来源（法术书、剑、卷轴）以及铭刻台上阻止该法术。一种数据驱动的规则格式将法术与其所需技能分组（AND 语义）。一旦玩家解锁该法术，就能再次使用它。

天生法术

天生法术。 Pufferfish 技能节点可以直接授予玩家一个法术。无需法术书、剑或卷轴，通过快捷键即可施放。施放仍会消耗法力并遵守冷却；它们同样会经过上述门控，因此两个系统可以组合使用。这包括一个专为天生法术设计的新法术轮盘和施法快捷键：

这是它在玩家 HUD 上的样子。这是一个相当强大的特性，尤其是如果你愿意制作一些自定义法术。你可以配置 Iron’s 使其不掉落该法术或不允许合成，然后将其加入技能树。轻松创建仅限技能树的自定义能力，或只是让玩家访问现有法术。

 

---

默认快捷键

特意选择以避开 Iron’s Spellbooks 的默认按键（R/V/L-Alt）。均可在原版控制中重新绑定。

• 按住 C 打开天生法术轮盘。松开以将高亮的法术提交为新的选择。
• X 施放当前选中的天生法术。
• 按住 Z + 滚轮 在不打开轮盘的情况下循环切换天生法术。
• 切换轮盘，已注册但默认未绑定；如果你更喜欢切换而非按住打开，请自行绑定。

---

入门 — 技能门控施法

在 data/your_pack/spell_skill_requirements/anything.json 放置一个文件。一条规则列出其涵盖的法术以及每个法术所需的技能：

{
  "spells": [
    "irons_spellbooks:fireball",
    "irons_spellbooks:fire_arrow",
    "irons_spellbooks:fire_breath"
  ],
  "requires": [
    { "category": "your_pack:apprentice_mage", "skill": "asdf6rv3a8dgs" }
  ]
}

语义： spells 中的每个法术都需要 requires 中的每个技能（AND）。玩家在解锁所有列出的技能之前无法施放或铭刻这些法术中的任何一个。文件名仅用于组织，法术 ID 位于 JSON 内部。

这一种格式涵盖了你可能想到的两个方向：

• 一个技能门控多个法术 — 列出多个 spells，在 requires 中列一个条目（上面的示例）。
• 一个法术需要多个技能 — 列出一个法术，多个 requires：

{
  "spells": ["irons_spellbooks:fireball"],
  "requires": [
    { "category": "your_pack:apprentice_mage", "skill": "pyromancy_gate" },
    { "category": "your_pack:apprentice_mage", "skill": "fire_mastery" }
  ]
}

如果你有多条规则命名同一个法术，则需要解锁所有这些节点才能解锁该法术。这允许你制作多技能解锁（如果你愿意）。不过，直接让节点消耗更多技能点可能更合理，但就这样吧。

---

入门 — 天生法术

在 data/your_pack/innate_spells/anything.json 放置一个具有以下格式的文件：

{
  "category": "your_pack:apprentice_mage",
  "skill": "innate_firebolt",
  "spell": "irons_spellbooks:firebolt",
  "level": 1
}

当玩家解锁 innate_firebolt 节点时，他们会在自己的先天法术池中获得 1 级火焰弹，可通过快捷键施放。法力消耗和冷却时间仍然适用。

level 如果省略则默认为 1，且必须至少为 1。如果你设置的 level 高于该法术实际支持的等级，它会被限制到该法术的最大等级（并记录一条警告），这样即使打错字也不会以不可能的等级施放法术。

升级链

河豚节点是二元的（已解锁 / 未解锁），没有每个节点的“升级”概念。要让玩家提升先天法术的等级，可以添加多个技能节点，每个节点都以逐步更高的 level 授予相同的 spell，并通过 connections.json 链接：

[innate_firebolt    level 1]  →  [innate_firebolt_2  level 2]  →  [innate_firebolt_3  level 3]

该模组会按法术 ID 去重，并保留 最高等级的授予。解锁了全部三个节点的玩家在轮盘中只会看到一个 3 级的火焰弹条目。较低等级的定义仍然有用：它们界定了链条（你必须先解锁 1 级才能解锁 2 级），并且它们指定了每个等级的解锁花费。

---

客户端配置

首次启动后位于 config/irons_spellbooks_pufferfish_compat-client.toml：

[SelectedInnateSpell] —— 快捷栏左侧的常驻徽章，显示当前选中的先天法术。

• display —— Always、 Contextual （在选择变更/施放时淡入），或 Never。
• xOffset / yOffset —— 相对于默认位置（快捷栏左侧）的像素偏移。

[InnateWheel] —— 按住打开的径向菜单。

• ignoreGuiScale —— 如果 true，则无论 GUI 缩放选项如何，轮盘都保持其大小。
• ignoreGuiScaleSizeMultiplier —— 当 ignoreGuiScale 开启时，将轮盘的大小乘以该值。

---

常见问题

问：这在未安装 Iron’s Spellbooks 的情况下能运行吗？

答：不能。Iron’s Spells ‘n Spellbooks 和 Pufferfish’s Skills 都是硬性依赖。这是一个兼容层，不是独立模组。问：你会移植到 Fabric / Forge / 更旧的 Minecraft 版本吗？

答：本模组面向 NeoForge 1.21.1。没有向后移植或移植到其他加载器的计划。

问：我可以在我的整合包中或我的服务器上使用这个吗？

答：当然可以。