HBMtweak

HBM Tweaks

精细调整 HBM 核科技的每一项数值——逐子弹、逐枪械、逐生物、逐工具。你的整合包，你的数值。

HBM Tweaks 是一个基于配置驱动、用于调整数值的插件，适用于 Minecraft 1.12.2 上的 HBM 核科技 - 社区版 (NTM-CE) 2.5.0.5。它将以清晰且文档化的 JSON 配置形式暴露 HBM 的内部机制——这样整合包作者（以及喜欢折腾的玩家）无需改动一行 Java 代码就能重新平衡任何内容。

简而言之： 安装，打开 config/hbmtweak/hbmtweaks.json，更改一个数值，重启。没有预设值，没有强制元数据——直到 你 做出修改，该模组本身不会做任何事。

---

主要特性

157 项逐子弹配置	伤害、穿甲、阈值免疫、击退、爆头倍率、扩散、速度、穿透——针对每一种单独的子弹类型
逐枪械覆盖	通过覆盖整把枪的基础伤害，修复共用口径的怪癖（例如：多种枪共用同一种 .22 子弹）
手榴弹	全部 13 种通用手榴弹填充物（从火药到核装药）以及 TNT 棒
生物	生命值（倍率 或绝对值）、造成伤害、受到伤害、速度、击退抗性、单次伤害上限、火焰/魔法免疫
近战与工具	剑、镐、斧、锹、电锯、扳手——工具提示与实际伤害始终一致
炮塔	索敌范围、能量消耗、旋转速度，以及直接伤害（Tauon/微波）倍率
爆炸	火炮（Arty / HIMARS）爆炸伤害
食物	任意物品的饥饿值与饱和度
核弹	所有 BombConfig 字段（爆炸半径等），并带有安全开关门控
自动 ID 参考	hbm_tweaks_ids.txt 在每次启动时重新生成，包含所有可调整 ID 的完整列表

---

设计原则

1. 默认 = 原版。 所有开关默认关闭，所有倍率默认为 1.0。安装后不会有任何变化。
2. 零硬编码数值。 该模组不附带任何关于你 应该 使用什么数值的意见。
3. 模组 ≠ 整合包。 该模组是一个通用工具；你的数值存放在 你的 配置中。更新模组绝不会影响你的平衡性设置。
4. 显式优于隐式。 每个配置的数值都是一个 最终 值——没有隐藏的计算，没有意外的倍率。
5. 结构上安全。 所有 Mixin 注入都是 required=false；如果未来 HBM 更新破坏了其中一项，只有该功能会静默降级。游戏永远不会因为 HBM Tweaks 而崩溃。

---

安装

1. 依赖项
   • Minecraft 1.12.2 (Forge 14.23.5.2864+)
   • HBM 核科技 - 社区版 2.5.0.5（必需）
   • MixinBooter（基于 Mixin 的功能所必需）
2. 将 hbmtweaks-1.3.0.jar 放入你的 mods/ 文件夹。
3. 启动游戏一次。模组会生成：
   • config/hbmtweak/hbmtweaks.json — 你的配置文件
   • config/hbmtweak/hbm_tweaks_ids.txt — 所有可调整 ID，自动更新
4. 编辑配置，重启。完成。

请使用 UTF-8 无 BOM 编辑器（VS Code、Notepad++ 等）。JSON 开头若有 BOM 将导致游戏回退到默认值。

---

配置快速入门

// config/hbmtweak/hbmtweaks.json
{
  // 将 12 号口径鹿弹伤害减半
  "weapons": [ { "bulletName": "g12", "damageMult": 0.5 } ],

  // AM180: 基础伤害 ×5
  "guns": [ { "item": "hbm:gun_am180", "damageMult": 5.0 } ],

  // UFO: 生命值固定为正好 100（绝对值——无任何计算）
  "mobs": [ { "entityClass": "com.hbm.entity.mob.EntityUFO", "healthSet": 100 } ],

  // 陨石剑: 每次攻击造成正好 4 点伤害（工具提示一致）
  "tools": [ { "item": "hbm:meteorite_sword", "damageSet": 4 } ],

  // HE 手榴弹填充物: 爆炸 ×0.2
  "enableGrenadeOverride": true,
  "grenades": [ { "filling": "HE", "damageMult": 0.2 } ],

  // 面包: 恢复全部饥饿值
  "foods": [ { "item": "minecraft:bread", "hunger": 20 } ]
}

所有地方都有两种数值风格：

• damageSet / healthSet — 绝对目标值（填写 4 表示造成 4 点伤害；零计算）
• damageMult / healthMult — 倍率（填写 0.5 表示减半）

每个类别在配置中都有一个 "_xxx_usage" 注释来解释其字段，而 hbm_tweaks_ids.txt 则列出了所有有效的 ID。

---

常见问题

问：这个模组开箱后会改变任何东西吗？ 不会。所有开关默认关闭，所有倍率默认为 1.0。在你配置它之前，它只是一个空白工具。

问：我设置了数值但没有任何变化。

• 你重启游戏了吗？所有数值都在启动时加载。
• 将子弹/物品/类名与 hbm_tweaks_ids.txt 对照检查（拼写错误会记录为警告）。
• 生物的 entityClass 必须与 运行时 类完全匹配——子类需要自己的条目。

问：我的剑上，工具提示仍然显示旧的数值。 近战工具会就地更新，因此工具提示是匹配的。如果你指的是枪械——枪械的工具提示显示基础伤害 × 弹药倍率，这会正确反映 guns/weapons 配置。

问：当 HBM 更新时这个模组会失效吗？ 个别功能可能会失效，但绝不会致命：失败的注入会静默降级（记录为警告），其余功能继续正常工作。

问：这会修改 HBM 的文件吗？ 不会。所有操作都在运行时通过反射、Forge 事件和 Mixin 完成。HBM 的 jar 文件永远不会被修改。

---

更新日志

1.3.0

• 完整的模组/整合包分离：所有数值配置驱动，所有开关默认关闭
• healthSet（绝对生物生命值）、damageSet（绝对近战伤害）
• 近战工具提示现在与实际伤害一致（就地属性编辑）
• 手榴弹逐填充物覆盖；炮塔直接伤害和火炮倍率
• 逐枪、数组子弹（火箭）、手榴弹与近战缓存；自动 ID 文档

1.2.0

• 逐枪伤害、生物造成伤害、炮塔/火炮/手榴弹压缩、glyphid 与 BOT-Prime 支持、Mixin 扩展

1.1.0

• 生物伤害上限、抛射物/爆炸倍率、火焰/魔法免疫、炮塔 Mixin、配置模板

1.0.0

• 首次发布：子弹、旧枪械、生物、食物、核弹、炮塔属性

---

许可证与致谢

HBM Tweaks 基于 MIT 许可证开源。 源代码可在 GitHub 上获取。

这是一个独立插件，不是官方 HBM 项目。它在运行时根据该项目（GPL/LGPL）的开源许可证与 HBM 核科技 - 社区版互操作，并且不包含任何 HBM 代码的副本。基础游戏的所有功劳归于 HBM 模组团队和 NTM-CE 社区。

---

支持

发现错误或有平衡性问题？在下方留言并提供：

• logs/latest.log（来自你的游戏文件夹）
• 你的 hbmtweaks.json 中的相关部分

祝你调校愉快！