Apothic Staff Rarities

Apothic Staff Rarities

为 Apotheotic Additions 添加 Fallen Gems & Affixes 的法杖词缀，使其支持神话级之后的稀有度（Heirloom、Artifact、Esoteric）。FG&A 的法杖词缀仅为基础稀有度定义数值，最高到远古级；这些词缀都没有声明 AA 阶级，因此不会在 AA 稀有度下生成。本模组新增了 30 个条目：

9 个自动施法词缀：

• acupuncture
• arrow_volley
• burning_dash
• ice_spikes
• shadow_slash
• sonic_boom
• stomp
• sunbeam
• volt_strike

14 个 spell_effect / mob_effect 词缀：

• acidic
• bloodletting
• bolstering
• bursting
• elusive
• ensnaring
• grievous
• ivy_laced
• revitalizing
• satanic
• sophisticated
• swift
• weakening
• withering

4 个 spell_cast 词缀：

• bastion
• hemospike
• radiant
• stormlash

3 个法杖专属词缀：

• concentration
• cooldown_reset
• mana_shield

每个 JSON 仅添加三个 AA 稀有度档位，因此普通至远古级仍由 FG&A 负责，本模组则在此基础上补充内容。

需求

• Minecraft 1.20.1
• Forge 47.x
• Apotheosis 7.4.x
• Fallen Gems & Affixes
• Apotheotic Additions
• Iron’s Spellbooks（仅当加载了 irons_spellbooks 时，相关条目才会生效）

所有依赖在 mods.toml 中均为可选项，因此即使缺少某项依赖，模组仍会加载；需要该依赖的 JSON 则不会生效。

配置

配置文件位于 config/apothic_staff_rarities-common.toml。首次启动时会自动生成，包含默认值和介绍配置结构的说明。配置分为两层，你可以根据需要选择快速调整或精细调节。

第 1 层：按稀有度设置倍率

[scaling] 中有三个倍率，分别对应三种 AA 稀有度，取值范围限制在 0.01 到 100.0。倍率的作用取决于数值类型：

• 自动施法和法术词缀：影响等级范围和冷却时间，并四舍五入为整数
• 阶梯函数数值（持续时间、cooldown_reset 和 mana_shield 的触发概率，以及采用 min / steps / step 结构编写的等级）：影响每级的阶梯增量，因此随等级变化的部分会按倍率缩放，而基础值和阶梯数保持原样
• 整数等级（单独填写的数字）：影响等级，并四舍五入到最近的整数级，因此倍率接近 1.0 时，数值可能不会改变
• concentration 是一个是/否标记，因此不受倍率影响

示例：

• heirloom_multiplier = 1.0
• artifact_multiplier = 1.0
• esoteric_multiplier = 1.25

第 2 层：逐词缀覆盖

[overrides] 中按词缀和稀有度分别设有子项。省略某个字段，即保留第 1 层倍率调整后的默认值。将字段设为任意数值，即可固定该字段，此时倍率不再作用于该字段。为兼容旧版配置，仍支持使用 -1。

[overrides.autocast.acupuncture.esoteric] 下的示例：

• cooldown = 90

省略的字段仍按第 1 阶缩放，因此这里只固定冷却时间，等级范围仍会应用倍率。

禁用类别

[disable] 会在加载时清空稀有度值映射，从而在 AA 稀有度中跳过整个词缀类别，使该词缀无法生成在传家宝/神器/奥秘稀有度中。FG&A 中从普通到远古的条目不受影响。

[disable] 下的标志：

• autocast = true
• mob_effect = false
• spell = false
• concentration = false
• cooldown_reset = false
• mana_shield = false

应用顺序

加载时，对每个词缀值执行以下操作：

1. 读取 JSON 默认值
2. 如果 [disable.<category>] 为 true，则跳过该词缀
3. 按对应稀有度的第 1 阶倍率进行缩放
4. 如果该字段存在第 2 阶覆盖值，则用覆盖值替换缩放后的值
5. 应用最终值

无需重启即可重新加载

/apothicstaffrarities reload（别名 /asr reload，op 等级 2）会重新读取配置并再次应用覆盖流程。回复为单行：配置发生变化时显示已应用的词缀数量；配置未变化时显示 config unchanged。常规的 /reload 也可使用，因为每次数据包重新加载结束时都会运行覆盖流程。

关于显示的说明

倍率较高时，生物效果的强化等级可能会超过 Minecraft 有显示名称的等级，因此效果可能显示原始键名，例如 potion.potency.8，而不是罗马数字。这是原版对高等级药水的显示限制，并非模组故障，也不会改变实际效果强度。

许可证

MIT