一款以 Minecraft 1.20.1（Forge） 为主的玩法强化模组。 灵感来自《英雄联盟》海克斯大乱斗（ARAM Mayhem）与斗魂竞技场（Arena）： 以 「双资源 → 三选一构筑」 为核心——抽取海克斯增幅、购买属性锻造器、穿戴词条装备，构筑属于你的流派。
- 作者：GuJiaoYe、豆包
- 许可：MIT License
- 支持版本：Minecraft 1.20.1（Forge 47.x）
- 开发状态：v0.6.2（持续迭代中）
本人能力有限，该模组的绝大部分开发工作由 AI 辅助完成，可能无法达到大家预想中的完成度，兼容性也可能存在不足，还请大家谅解。此前发布时我并不知道已有开发者制作过海克斯相关的模组，如有雷同或借鉴之处，敬请包涵。项目已开源（MIT 协议），后续我会继续努力更新维护（虽然仍主要依赖 AI 协助）。如遇到任何问题，欢迎在 GitHub Issues 反馈。
| 系统 | 说明 |
|---|---|
| 海克斯增幅 | 184 种（白银 / 黄金 / 棱彩三档），消耗经验抽取、三选一构筑。含 4 大体系： • 复合机制（回响之刃 / 刽子手 / 连杀狂潮 / 死之舞 / 屠龙者 / 熵之力等，多机制组合而非单数值） • 成长系（叠角龙：其它叠层翻倍；坦克引擎：每层 +生命；逐日之矛：每层 +攻击；掷骰狂人：击杀几率免费锻造） • 附魔系（锋利真伤 / 火焰附加 / 亡灵与节肢增伤 / 击退 / 经验修补） • 矿物系（时运翻倍 / 自动烧炼 / 连锁开采 / 挖矿经验 / 探矿掉宝 / 自动拾取） • v0.6.2 叠层体系 + 14 个新叠层海克斯（战伤突进 / 固垒 / 浴血坚甲 / 痛愈迅敏 / 血契传承 / 鏖战屏障 / 战魂兼备 / 时之焚刃 / 负伤汲取 / 驰往永恒 / 永世征伐 / 不灭躯壳 / 生死交织 / 刹那万象）+ 8 个旧叠层海克斯补标签；6 个预留事件（流血/减速/反点燃/流血扩散/标记/处决）全部实装 |
| 联动体系（v0.3.18） | 7 个联动海克斯打通 海克斯×装备 / ×锻造器 / ×交易 / ×海克斯：海克斯增幅（所有海克斯属性效果 +35%/级）、织装大师（装备属性效果 +35%/级）、锻造宗师（锻造属性效果 +35%/级）、六神装（每件装备 +攻/甲/血）、精明商人（工坊消费折扣）、财源滚滚（卖出加成）、汇率高手（兑换加成） |
| 属性锻造器 | 晶币购买三选一属性（白银 50 / 黄金 150 / 棱彩 400 晶币），另有「随机锻造」；v0.6.0 单总静态属性池（13 条）：力量/护甲/生命/迅捷/攻速/幸运/击退/壁垒/玄铁/跳跃/迈步/生命增幅 +5%/级/攻速增幅 +3%/级——三档共用同一词条池，机制词条已全部迁入海克斯（积聚之刃等机制刃变为海克斯）；段位强度：白银 ×1 / 黄金 ×2 / 棱彩 ×3 倍率（v0.6.1 起倍率可在 Cloth 配置中修改，服务端生效防作弊）+ 高段位词条权重（跳跃/迈步/百分比增幅在白银档权重压低但可抽出），"棱彩最好 > 黄金其次 > 白银最差"由倍率保证；v0.6.2 tooltip 占位符模板（lang 改 {tierName} {displayValue}，运行时读基础值 × 档位倍率渲染——「白银锻造：每级护甲 +1.0」「棱彩锻造：每级生命增幅 +15%」，改倍率后自动跟随）；modifier 路径天然突破原版属性上限（maxValue 仅钳制基础值），锻造次数无上限，数值经消毒防崩坏 |
| 装备系统 | 44 件（黄金 25 / 棱彩 19），LOL 风格机制移植（无尽之刃 / 饮血剑 / 死之舞 / 三相之力 / 心之钢 / 狂徒铠甲等）；2500 / 4000 晶币随机三选一；6 槽位，重复自动折算卖出价、满槽自动替换最旧 |
| 经济系统 | 击杀掉落晶币（普通 1-3 / 精英 5-10 / 首领 20-50，反刷衰减）；「充值」页 6 种材质 ↔ 晶币双向兑换（绿宝石 1:30 ~ 下界合金 1:64，支持批量 ×256）；金属锭合成晶币物品右键存入 |
| TACZ 联动 | 自动检测 + 可配置：安装《永恒枪械工坊》(TACZ) 后自动启用联动海克斯（枪械增伤 / 枪械暴击 / 弹药回复 / 距离增伤 / 战地医疗等）+ 联动装备；未安装则自动从抽取池剔除；弹药回复直接回填当前枪械子弹（读 NBT + 弹容钳制） |
| 界面 | 背包/合成界面「◆」页签、H 键（海克斯工坊）或 K 键（世界海克斯）打开；五页签（属性 / 海克斯 / 锻造器 / 装备 / 充值）；海克斯科技风（深蓝紫渐变 + 霓虹光效）；三选一抽取按海克斯大乱斗原版风格（稀有度辉光 + 缎带标签 + 入场动画）；属性页显示全部隐藏属性（暴击 / 吸血 / 增伤 / 减伤 / 成长层数） |
| 世界海克斯（v0.6.2） | 40 个作用于整个存档的全局增强/诅咒（通用 / 友好生物 / 中立生物 / 敌对生物 × 白银/黄金/棱彩，含机制型：受击反扑 / 死亡召唤 / 吸血+Debuff / 全掉落封锁 / 受伤增幅 / 死亡惩罚 / 攻势易散 / 钝器百炼 / 永续成长 / 厚积战场，以及 v0.6.2 叠层联动：永恒增殖 / 战消 / 久战 / 转瞬），经验抽取三选一、抽到全服即时生效且所有玩家可见、晶币取消、每类上限可配置；开放数据包覆写（world_hexes/*.json）；独立 UUID 属性修饰符 + 玩家侧独立乘区，不与其它 mod 冲突 |
| DLC 外接包（v0.6.2） | 游戏根目录 hexworkshop_dlc/packs 放置第三方内容包（文件夹或 zip，根目录需 dlc_meta.json），Cloth 配置页或 /hexcraft reload dlc 启用；zip 内存读取不落盘；本体全部内容内置、不依赖任何 DLC |
| 配置 | Cloth Config 标准配置界面（游戏内 Mods → 配置打开）：海克斯抽取 / 经济系统 / 联动内容 / 世界海克斯 / 客户端 / 锻造与叠层规则（含 v0.6.2 永久叠层全局获取倍率与上限，服务端权威）/ DLC 外接包（v0.6.2）/ 游戏规则（4 条死亡保留 gamerule）分类，支持搜索、重置、即时保存；全部数值进 TOML |
| 兼容性 | 属性全走原版 AttributeModifier 标准 API + 数值消毒 → 适配 AttributeFix 等属性修复 MOD、大型整合包；矿物判定兼容其它 mod 的 *_ore；冶炼配方兜底兼容其它 mod 矿石 |
- Minecraft 1.20.1 + Forge 47.4.23 及以上（1.20.1 系）
- Java 17（Forge 要求）
- 可选依赖：Cloth Config API（v10+）——未安装时 MOD 正常运行，仅配置界面不显示（配置仍可在
config/下 TOML 手动修改） - 可选联动：TACZ（永恒枪械工坊） ——自动检测，未安装不影响
- 安装 Forge 1.20.1（47.x）
- 将
hexworkshop-1.20.1-<版本>.jar放入.minecraft/mods/ - （可选）安装 Cloth Config API 以使用游戏内配置界面
- 启动游戏，背包界面右上角点击「◆」或按 H 键打开海克斯工坊
客户端与服务端都放入即可；仅服务端有该 MOD 时，联机玩家无需安装（数据由服务端权威，客户端界面依赖 MOD 本体，推荐双方都装）。
/hexcraft coins add <玩家> <数量> # 添加晶币
/hexcraft coins set <玩家> <数量> # 设置晶币
/hexcraft view <玩家> # 查看玩家数据
/hexcraft clear <玩家> # 清空玩家数据
/hexcraft reload [all|hexes|forging|equipment|world] # 分模块重载数据包定义（热更新，客户端界面自动刷新）
配置文件：config/hexworkshop-common.toml（服务端权威）与 config/hexworkshop-client.toml。
| 分组 | 主要项 |
|---|---|
| 海克斯抽取 | 经验消耗（500）、刷新价格（20）、槽位上限、稀有度权重（40/35/25）、保底（黄金 4 次 / 棱彩 8 次）、满级补偿 |
| 经济系统 | 击杀晶币区间、反刷窗口/衰减、锻造器三档价格、锻造上限、金属兑换 |
| 联动内容 | TACZ 总开关 × 海克斯/锻造器/装备 三小类细分（默认全开，自动检测） |
| 游戏规则 | 死亡保留：海克斯 / 锻造 / 装备 / 晶币（4 条 gamerule，默认死亡清零） |
| v0.6.0 | 额外护甲减伤独立乘区（阈值/每点减伤/封顶）、同词条叠加规则（STACK 无上限 / BEST_ONLY 高段位顶替回收） |
| v0.6.1 | 锻造档位倍率配置化（forgeMultiplierSilver/Gold/Prismatic，默认 1.0/2.0/3.0，服务端生效、客户端修改不生效防作弊） |
| v0.6.2 | 永久叠层全局获取倍率（0.1 |
| 客户端 | UI 缩放、特效开关 |
海克斯 / 装备 / 世界海克斯全部由 数据包 JSON 驱动（data/hexworkshop/hextech/*.json、equipment/*.json、world_hexes/*.json，v0.6.0 起锻造词条池也可经数据包覆写），
无需改代码即可增删改内容；事件效果由 event 字段效果 key 驱动（吸血 / 暴击 / 复合机制 / 成长层数 / 矿物 / 枪械 / 叠层等）。
联动 mod 接入：注册一个 id 前缀即自动检测 + 默认启用 + 可配置关闭。
详细文档：
# 需要 JDK 17；项目自带 Gradle Wrapper
.\gradlew.bat build
# 产物：build/libs/hexworkshop-1.20.1-<版本>.jar# 开发环境直接运行（需要先配置 ForgeGradle 环境）
.\gradlew.bat runClient
.\gradlew.bat runServer欢迎提交 Issue、PR 或新的海克斯/装备 JSON 定义。
- 数据内容（JSON）：放入
src/main/resources/data/hexworkshop/，同时补zh_cn.json/en_us.json翻译（每个定义必须有 name + desc，中英同步） - 提交前请运行
tools/audit_release.py自检（翻译完整性 / JSON 可解析 / 内容统计） - 代码风格：遵循现有注释风格（中文注释、全限定名 MC 类）
完整历史见 CHANGELOG.md。近期版本：
- 海克斯 / 锻造器 / 装备列表全部支持悬停查看具体效果（名称 + 描述 + 来源角标 / 卖出价）
- 纯客户端显示层改动，联机无冲突
- ForgeConfigSpec 全部配置项/分类接入官方翻译 key，Configured / MezzConfig 等第三方配置界面跟随游戏语言（中文 / English）
- 配置条目名、分类名、说明 tooltip 全翻译，不再显示英文 key 名；lang 补 Configured 所需 tooltip 镜像 key
- 新增 7 个联动海克斯（海克斯增幅 / 织装大师 / 锻造宗师 / 六神装 / 精明商人 / 财源滚滚 / 汇率高手）
- 属性三乘区 + 交易折扣/加成全部服务端结算
- 冶炼之触 × 矿脉共鸣联动：连锁子方块共用统一处理，熔炼 / 时运翻倍 / 磁铁拾取全生效
- 冶炼配方兜底：其它 mod 矿石只要熔炉能烧即可熔炼
- 标准 Cloth 配置界面（五分类 + 搜索 + 重置 + 即时保存）
- 背包页签 / 按键绑定生产环境修复
- 来源大类（原版 / TACZ / 未来联动）× 内容小类（海克斯 / 锻造器 / 装备）自动检测 + 配置开关