Ars 'n Spells

Ars 'n' Spells

Ars 'n' Spells 架起了 Ars Nouveau 和 Iron's Spells 'n Spellbooks 之间的桥梁，打造无缝的魔法体验。统一法力值，共享法系进度，跨模组扩展你的力量——甚至可以将 Ars 法术编入真正的 Iron's 法术书，直接从 Iron's 原生的法术轮盘中施放。所有功能均可自由配置。

支持 Minecraft 1.20.1 的 Forge 版本。

---

3.0.x 版本新特性

• 法术织机 (Spell Loom) — 一个全新的工作台，可将任何 Ars Nouveau 法术导出到真正的 Iron's 卷轴上，并可自定义名称、属性和图标。
• 法术书绑定 (Spellbook Binding) — 将导出的卷轴绑定到真正的 Iron's 法术书中；该 Ars 法术会作为 Iron's 原生法术选择轮盘中的独立条目 出现（每本法术书最多 8 个）。
• 3.0.1 强化 — 法术转录和法术书绑定石板在安装了 Iron's 模组后再次可合成，LP 切换设置在所有地方均一致生效，配置界面进行了全面的可读性重制（在服务器上具有适当的只读模式），并修复了未安装 Iron's 时启动崩溃的问题。
• 3.0.2 优化 — 亲和度衰减现在遵循其文档中描述的平缓曲线（之前启用时衰减速度约快 20 倍）；新增 进度链 引导你从合成法术织机到首次跨模组施法；织机界面获得了高对比度可读性处理，每个槽位都有悬停提示；整合包作者 可以获得用于自定义诅咒/美德戒指、渎神灵咒和魔源罐方块的数据包标签，以及一个新的 aura_failure_mode 选项，在圣约集成失效时可阻止（而非免费允许）戒指施法；模组现在会在聊天中提示未经测试的圣约版本，并支持 Forge 更新检查器。

---

需求

模组	必需？
Ars Nouveau (4.12.7+)	是
Iron's Spells 'n Spellbooks (3.15.0 – 3.x)	否 — 若未安装则回退至原版 Ars 行为
Covenant of the Seven (Sanctified Legacy)	否 — 启用 LP 和光环戒指系统（推荐 2.2.6 版本以使用光环 HUD）
Blood Magic	否 — 作为七诅咒戒指的可选 LP 来源
Apotheosis + Apothic Curios	否 — 允许将饰品上的词缀/凹槽法力属性同步到统一法力池

(Curios 是 Ars Nouveau 的依赖，因此它总是存在。)

---

法力值统一

Ars 'n' Spells 的核心：五种可配置的模式，控制两个法力池如何互动。

模式	工作原理
ISS 为主 (默认)	Iron's 的法力是唯一来源。Ars 读取和消耗 Iron's 法力池。
Ars 为主	Ars 法力具有权威性。Iron's 法术消耗 Ars 法力。
混合	共享双向法力池。可选择显示哪个 HUD 条。
分离	独立法力池。跨模组施法时，成本在两个池之间分摊（可配置分摊比例）。
禁用	无集成 — 每个模组使用自己的法力池。

两种法力系统之间的转换率完全可以配置，跨系统的法力 恢复 也能正确进行单位转换（Iron's 的百分比恢复 vs Ars 的固定值恢复），因此叠加的恢复装备永远不会失控。

模组会自动隐藏多余的法力条，保持你的 HUD 整洁。

更改模式（实时生效，无需重启）：在单人游戏中，打开模组 → Ars 'n' Spells → 配置，点击 法力模式 行进行循环切换；服务器管理员可以运行 /ans mode set <模式>；或直接编辑配置文件。使用 /ans mode 命令确认当前激活的模式。

---

装备与法术集成

• 装备属性互通 — Ars 护甲加成分作用于 Iron's 法力池（反之亦然），取决于你当前激活的模式。
• 饰品 & Apotheosis 词缀 — 已装备饰品（戒指、护符、腰带）上的法力属性也会互通，包括由 Apotheosis / Apothic Curios（以及 Magical Jewelry、Jewelcraft 等）赋予的词缀和凹槽属性。其读取方式是通用的 — 没有硬性的 Apotheosis 依赖 — 并且可以通过 read_curio_attribute_modifiers 配置项关闭。（暴击或护甲穿透等纯战斗属性不属于法力/法术强度，因此不会被桥接。）
• 法术强度缩放 — Ars 法术强度会随着 Iron's 的法术强度属性按加法叠加（而非乘法）进行缩放。基于你的首个雕文应用元素加成。可配置的 spell_power_cap（默认 3.0）防止数值极端。
• 附魔 — 无论哪个法力池处于激活状态，两个模组中与法力相关的附魔都会被识别。

---

共鸣

当你的法力值接近满时（默认高于 95%），你会获得一个 共鸣加成，提升法术伤害。这是对法力高效利用玩法的奖励。每个模组均可配置，可调整强度、持续时间和伤害上限。

---

魔源罐协同

站在 Ars Nouveau 魔源罐附近会被动提升你的法力恢复速度。加成效果可通过 source_jar_synergy_multiplier 配置（默认 5.0），并带有可调的扫描间隔和半径，以及专用的关闭开关 (enable_source_jar_synergy)。扫描基于位置缓存以优化性能，且永远不会强制加载区块。

---

跨模组进度与亲和度

• 进度共享 — 施放 Ars 法术可获得 Iron's 学派进度，反之亦然。
• 亲和度追踪 — 模组会追踪你一段时间内的法术学派使用情况，并可选择让未使用的学派逐渐衰退。

---

跨法术铭刻

使用来自 另一 模组的物品施放 任一 模组的法术，通过石板驱动的铭刻/去铭刻仪式流程实现。两个仪式石板均在 附魔装置 处合成，并且完全由数据包定义，因此整合包作者无需修改代码即可调整材料。

法术转录 — 将外部法术绑定到物品上

1. 合成法术转录石板。 核心材料：一本初级的 Ars Nouveau 法术书。基座材料：任意等级的 Iron's 法术书、一根远古木原木和一个魔源宝石块。消耗 2000 魔源。
2. 设置祭坛。 将石板放置在仪式祭坛上，并在约 3 格范围内放入两样物品：
   • 恰好一个 来源 — 一张已填充的 Ars Nouveau 法术羊皮纸、聚焦水晶或法术书，或一张 Iron's Spellbooks 卷轴
   • 恰好一个空白的 目标 物品用于接受铭刻
3. 激活。 严格消除歧义：如果任一类别有多于一个物品，或范围内有任何已铭刻的物品，仪式将失败，并在聊天中显示它看到的物品及违反的规则。根 NBT 已携带 Ars Nouveau 法术的物品将被拒绝作为目标，以确保右键解析无误。成功后，来源被消耗，目标获得跨模组铭刻，并伴有附魔雕文粒子 + 附魔台音效的绑定特效。
4. 施法。 右键点击目标物品。潜行+右键可在同一物品上的多个铭刻之间循环。

法力消耗遵循当前激活的统一模式，并尊重你配置的转换率。在 分离 模式下，成本根据你的双成本百分比在两个池之间分摊。跨模组施法需要支付由 cross_cast_cost_multiplier 设定的额外开销（默认 1.25 = 25% 额外）— 双向对称应用，每次施法在法力扣除前计算一次。

法术去铭刻 — 干净地移除铭刻

如果你改变主意了，法术去铭刻 仪式可以将已铭刻的物品恢复到位完全相同的全新空白状态，以便可以重新干净地铭刻。

1. 合成法术去铭刻石板。 核心材料：一张空白羊皮纸。基座材料：一个水桶、一个魔源宝石和一个远古木原木。消耗 500 魔源。
2. 激活 时，范围内恰好有一个已铭刻物品且别无他物 — 来源或多余的空白物品会导致仪式失败，以避免错误地剥离错误的物品堆。
3. 跨模组铭刻的 NBT 被干净移除（法术列表、循环索引和任何空的残留标签），伴有灰烬 + 烟雾的消散特效。

即使在未加载 Iron's Spellbooks 的情况下，去铭刻仪式也能正常工作，因此在移除 Iron's 后，遗留的已铭刻物品仍可被清理。

---

法术织机 — 将 Ars 法术导出到 Iron's 法术书 (3.0.0)

使用 Ars Nouveau 的工具设计法术，在法术织机上将其编织到一张 真正的 Iron's 卷轴 上，将其绑定到一本 真正的 Iron's 法术书 中 — 然后从 Iron's 自身的原生法术轮盘 中施放它，与你 Iron's 的法术并列。Ars 法术作为 Ars 'n' Spells 的附加数据存在于真正的 Iron's 物品上，因此法术书中 Iron's 自身的法术从未被触及。此功能需要 Iron's Spellbooks 模组。

1. 编织。 合成 法术织机（在工作台上用金锭、2× 青金石、一本书和 3× 黑曜石），然后右键点击它。将你的 Ars 法术来源（羊皮纸、聚焦水晶或法术书）和一张 空白的 Iron's 卷轴 放入槽位，然后给你的法术起一个 名字，选择一个 属性，挑选一个 图标，然后按下 铭刻。一张携带你法术的真正的 Iron's 卷轴就出来了。(管理员也可以使用 /ans export_to_irons_scroll 进行快速、无需元数据的导出。)
2. 绑定。 运行 法术书绑定 仪式（其石板仅在安装了 Iron's 时出现 — 消耗 2500 魔源），将卷轴和一本 Iron's 法术书放在祭坛附近，或同时持有两者并运行 /ans bind_scroll_to_irons_book。卷轴被消耗，法术以你选择的名字和图标追加到法术书中；重复绑定相同法术会被拒绝（根据法术载荷去重）。
3. 施法。 你的 Ars 法术作为 Iron's 原生法术选择轮盘中的独立条目 出现。像任何 Iron's 法术一样选择它并右键点击 — 它将通过完整的跨模组施法管道（法力模式、消耗倍率、缩放、冷却时间）施放真正的 Ars 法术。每本法术书最多 8 个 Ars 法术，而你原生的 Iron's 法术施放方式完全不变。

整合包作者：使用 allow_ars_spells_in_irons_spellbooks 控制此功能的开关，或使用 max_ars_cross_spells_per_irons_spellbook 限制每本书的法术数量。

(非 Iron's 法术书的通用已铭刻物品仍然通过右键点击施放，潜行右键点击进行循环。)

---

统一冷却时间

一个可选系统，将两个模组中相似的法术归入共享的冷却类别。通过在一个法术施放后锁定相关联的法术来防止法术滥用。默认禁用。

---

Covenant of the Seven 集成

当安装了 Covenant of the Seven (Sanctified Legacy) 模组时，两个强大的戒指系统将解锁。

七诅咒戒指 — 生命点数施法

佩戴诅咒戒指会将所有法力消耗转化为 生命点数 (LP)。

• Blood Magic 优先 (默认) — 首先从 Blood Magic 的灵魂网络中汲取 LP，不足时回退到玩家生命值。
• 仅 Blood Magic — 仅从灵魂网络汲取。
• 仅生命值 — 始终消耗生命值（100 LP = 5 颗心）。

如果你 LP 耗尽：

• 安全模式 (默认) — 法术被取消，你受到少量伤害（你永远不会因此死亡）。
• 死亡模式 — 法术会施放……但你会因此死亡。

LP 消耗会随可配置的基础倍率、Ars 雕文的等级缩放以及 Iron's 法术的等级和稀有度缩放。整个系统有一个主开关 (enable_lp_system)，所有 LP 路径都遵循此开关 — 卷轴也不例外。

七美德戒指 — 光环施法

佩戴美德戒指会将你的 Ars 法力消耗转化为 光环 — Covenant of the Seven 自身可再生的资源，带有独立的 HUD 条。Covenant 拥有该资源池、恢复机制和持久性；Ars 'n' Spells 仅将法力消耗映射到它之上，通过 ars_virtue_aura_multiplier 进行缩放。在此戒指下，Iron's 法术由 Covenant 原生处理。如果你消耗殆尽，法术只是简单地施放失败。

戒指冲突： 同时佩戴两枚戒指会取消两者的效果 — 你将使用常规法力，并收到警告通知。

渎神灵咒 — 学派折扣

十三种渎神灵咒变体（火焰、冰霜、闪电、神圣、末影、鲜血、召唤、自然、异界、水流、大地、风、休眠）每种提供：

• 所有法术基础法力消耗减少 15%
• 当法术学派与灵咒元素匹配时，额外获得 +10% 折扣（总计 25%）

折扣与戒指成本乘法叠加，匹配的渎神灵咒还会大幅折扣 LP 成本 (blasphemy_lp_discount，默认减免 85%)。

---

卷轴成本强制

Iron's Spellbooks 卷轴会遵守你的资源消耗：

模式	行为
完整 (默认)	卷轴消耗法力以及 LP/光环，如同常规施法。
仅 LP	卷轴免费使用法力，但诅咒戒指佩戴者的 LP 仍会被消耗。
免费	卷轴无资源消耗（诅咒戒指产生的 LP 消耗仍然适用）。

---

配置

一切均可通过每个世界的服务器配置文件 <world>/serverconfig/ars_n_spells-server.toml 进行配置（服务器权威且自动同步 — 在多人游戏中，游戏内配置界面为只读状态）。主要选项包括：

• 主开关 用于法力统一、共鸣、冷却时间、进度、亲和度、LP 和光环
• 法力转换率、双成本分摊比例和跨系统恢复转换
• LP 系统 — 来源模式、死亡惩罚、基础/等级/稀有度倍率、最小消耗
• 光环系统 — 主开关和法力→光环成本倍率（资源池本身属于 Covenant）
• 饰品折扣 — 基础折扣、匹配学派奖励、渎神灵咒 LP 折扣
• 饰品属性桥接 — read_curio_attribute_modifiers（默认开启）：将 Apotheosis/Apothic Curios 词缀及凹槽的法力属性镜像到统一法力池
• 法术强度缩放 — Iron's 属性叠加的强度上限
• 魔源罐协同 — 关闭开关、恢复倍率、扫描间隔和半径
• 跨模组施法 — 消耗倍率、法术书绑定开关和每本书的法术上限
• 卷轴消耗模式
• 调试模式，带有端到端的跨模组施法追踪，用于故障排除

所有选项均配有平衡的默认值 — 安装即玩，或根据喜好微调。

---

命令

命令	权限	描述
/ans mode	--	显示当前法力统一模式
/ans mode set <模式>	Op 2	实时切换法力统一模式（无需重启）
/ans mana getdefault	--	查看当前默认最大法力值
/ans mana setdefault <数值>	Op 2	设置默认最大法力值
/ans info <玩家>	Op 2	显示法力、光环、共鸣和戒指状态
/ans debug	Op 2	运行时切换调试模式
/ans aura	--	显示你自己当前的光环值
/ans export_to_irons_scroll	Op 2	将持有的 Ars 法术导出到真正的 Iron's 卷轴上 — 法术织机 是生存模式途径
/ans bind_scroll_to_irons_book	Op 2	将持有的已导出卷轴绑定到持有的 Iron's 法术书中

---

常见问题 / 故障排除

问：在 ISS 为主模式下，Ars 法力值没有变化。 答：确保安装了 Iron's Spells 'n Spellbooks (3.15.0+)。检查日志中是否有 Mixin 加载失败信息。

问：我无法合成法术转录或法术书绑定石板。 答：在 3.0.1 版本中已修复 — 更新模组。配方现在接受任何等级的 Iron's 法术书。

问：我看到了两个法力条。 答：确认你的法力模式设置正确。检查是否有来自其他 UI 模组的覆盖冲突。

问：即使我有足够的心，也提示 "LP 不足"。 答：确保 lp_source_mode 没有在未安装 Blood Magic 的情况下设置为 BLOOD_MAGIC_ONLY。默认设置 (BLOOD_MAGIC_PRIORITY) 会回退到生命值。

问：卷轴施法不消耗任何东西。 答：检查 scroll_cost_mode 是否设置为 full（默认值）。

---

许可证

GNU GPLv3