铁之法术调整器 GUI

🪄 Iron's Spell Tweaker GUI

一个直观、现代化的游戏内 GUI 模组，适用于 Minecraft NeoForge 1.21.1，允许玩家和整合包作者自由调整、平衡和自定义来自 Iron's Spells 'n Spellbooks 及其附属模组的所有法术——可直接从标题界面或游戏内暂停菜单操作，无需重启游戏！

---

功能

交互式法术浏览器

• 即时搜索：输入即可按显示名称、法术 ID 或模组 ID 实时搜索法术。
• 学派筛选：按火焰、冰霜、闪电、神圣、末影、鲜血、唤魔、自然、异界或任何自定义学派筛选。
• 附属/模组筛选：自动发现所有已安装的法术附属模组，并允许按模组进行筛选。
• "仅已编辑"筛选：快速切换以仅查看具有自定义配置或未保存调整的法术。
• 动态主题：每张法术卡片都带有对应学派的真实颜色点缀与边框。

实时属性调整

• 强度倍率：调整伤害和法术效力（0.1 倍至 10.0 倍）。
• 法力消耗倍率：调整法力消耗（0.1 倍至 10.0 倍）。
• 冷却时间：精确设置冷却时间，从 0.0 秒到 120.0 秒。
• 最大等级：调整升级上限，从 1 级到 10 级。
• 最低稀有度：在普通、罕见、稀有、史诗和传说之间循环切换。
• 学派重新分配：自由地将法术重新分配到不同的魔法学派。
• 启用/禁用切换：禁用施法以及卷轴生成。
• 合成切换：切换是否可以在铭文台上合成法术卷轴。

基础属性与描述预览

• 基础属性行：在应用倍率之前，查看原始施法类型（瞬发、蓄力、持续、被动）、基础施法时间（秒）、基础法力消耗和基础法术强度。
• 描述文本：从语言定义中直接提取的多行自动换行指南/描述。

批量调整模式（大规模调整）

• 目标学派选择器：对特定学派中的所有法术或所有学派应用调整。
• 百分比滑块：
  • 强度：−50 至 +200（步长 5）。
  • 冷却时间：−80 至 +100（步长 5）。
  • 法力消耗：−80 至 +100（步长 5）。
• 快速预设芯片：+20 强度、+50 强度、−20 冷却、−50 冷却。
• 批量切换：一键为整个学派启用全部/禁用全部。

安全确认弹窗与恢复出厂设置

• 屏幕内模态对话框：防止对破坏性操作（Delete JSON、Batch Apply、Disable All、Reset All）的误点击。
  • 完整键盘支持：ESC 取消，ENTER 确认。
  • 完整的点击拦截，防止背景点击穿透。
• 恢复出厂设置：一键按钮，清除 .minecraft/config/irons_spellbooks_spell_config/ 中的所有自定义配置文件，并将所有法术恢复为模组默认值。

零游戏性能开销

• 经过审核的架构：世界游玩期间 0% 后台 CPU / 内存开销。
• 无 Tick 处理器，无后台线程：模组仅在 GUI 显式打开时执行。

面向服务器管理员 / 整合包作者的说明 如果你正在开服或为朋友制作整合包，你可以使用此模组来帮助平衡服务器。 首先在客户端进行配置： 启动游戏进入主菜单，按需自定义法术，并保存更改。 将配置文件复制到服务器： 点击 GUI 左下角的"打开配置文件夹"按钮。 复制 irons_spellbooks_spell_config 文件夹。 将其粘贴到专用服务器的 config/ 文件夹中，覆盖原有文件夹。

📄 工作原理

Iron's Spells 'n Spellbooks 原生读取位于以下位置的各个 JSON 配置文件：

.minecraft/config/irons_spellbooks_spell_config/<namespace>/<spell_path>.json

 

Iron's Spell Tweaker GUI 作为此系统的可视化界面：

1. 读取真实默认值，直接从每个法术内存中的 DefaultConfig 获取。
2. 生成并保存与手动配置格式完全相同的标准 Iron's Spells JSON 配置文件。
3. 在保存或删除配置时调用 SpellRegistry.onConfigReload()，允许实时更新属性，无需重启游戏或服务器。

---

📜 许可证

本项目采用 MIT 许可证 授权——欢迎在你的整合包中使用、修改和分发此模组！