Hexcraft Workshop

海克斯工坊 Hexcraft Workshop — 使用说明 / 注意事项 / 更新说明
================================================================
模组版本：v0.3.18（hexworkshop-1.20.1-0.3.18.jar）
适用游戏：Minecraft Java 版 1.20.1
加载器：Forge 47.x（FML）
作者：GuJiaoYe、豆包
开源：GitHub https://github.com/GuJiaoYe1024/hexcraft-workshop （MIT 协议）

────────────────────────────────────────────
〇、致歉与说明
────────────────────────────────────────────
【致歉与说明】
本人能力有限，该模组绝大部分开发工作由 AI 辅助完成，可能无法达到大家预想中的
完成度，兼容性也可能存在不足，还请大家谅解。此前发布时我并不知道已有开发者制作
过海克斯相关的模组，如有雷同或借鉴之处，敬请包涵。项目已开源（MIT 协议），后续
我会继续努力更新维护（虽然仍主要依赖 AI 协助）。如遇任何问题，欢迎到 GitHub
Issues 反馈：https://github.com/GuJiaoYe1024/hexcraft-workshop/issues

────────────────────────────────────────────
一、模组简介
────────────────────────────────────────────
「海克斯工坊」是以「双资源 → 三选一构筑」为核心的玩法强化模组，灵感来自
英雄联盟海克斯大乱斗与斗魂竞技场。主要内容：

· 131 种海克斯增幅（白银 / 黄金 / 棱彩三档）：
  - 战斗、防御、生存、成长、经济、枪械、附魔、矿物、趣味等九大玩法分类；
  - 复合机制、永续成长、附魔与矿物联动，可随游戏进程不断构筑。
· 属性锻造器：9 种基础属性 + 16 种机制词条，锻造无上限、数值消毒防崩坏，
  三档配色（白银/黄金/棱彩）对应不同词条强度。
· 44 件词条装备：无尽之刃、饮血剑、心之钢、守护天使等 LOL 风格机制移植，
  可购买、可锻造、可出售折算晶币。
· 完整经济系统：击杀怪物掉落海克斯晶币；6 种金属锭（铜/铁/金/青金/红石/钻石）
  与晶币双向兑换，支持批量兑换（至 ×256）。
· TACZ 自动联动：安装「永恒枪械工坊（TACZ）」即自动解锁枪械海克斯/装备/
  锻造词条；未安装时联动内容自动剔除，不产生报错。

────────────────────────────────────────────
二、使用说明
────────────────────────────────────────────
【安装要求】
1. 游戏版本：Minecraft 1.20.1；
2. 加载器：Forge 47.x（推荐 47.4.x 及以上）；
3. 建议安装：Cloth Config API（≥10，推荐 11.1.136）——用于标准配置界面；
   不安装也可正常游玩，配置会回退到游戏自带的 Forge 原生配置界面；
4. 可选联动：Timeless and Classics Zero（永恒枪械工坊，1.20.1 版）。

【安装步骤】
1. 下载 hexworkshop-1.20.1-0.3.18.jar；
2. 放入 .minecraft/mods/ 文件夹（无需解压）；
3. 启动游戏，主菜单 Mods 列表中应能看到「Hexcraft Workshop 海克斯工坊」
   （带金色徽章图标）；
4. 进入存档即可开始游玩。

【基础玩法】
1. 击杀任意怪物有概率掉落「海克斯晶币」；
2. 按 H 键（可在 按键设置-海克斯工坊 中改绑）打开海克斯页面：
   - 消耗晶币随机抽取海克斯（白银 12 晶币 / 黄金 30 晶币 / 棱彩 60 晶币）；
   - 页面左上角可切换 玩法分类 过滤（全部/战斗/生存/成长/经济/枪械/附魔/矿物/趣味）；
   - 同一种海克斯可叠层成长，叠角龙等联动效果按描述生效；
3. 海克斯页面还可使用「属性锻造器」与「装备」页签：
   - 锻造器：消耗晶币随机锻造 属性词条 或 机制词条，可反复锻造、无上限叠加；
   - 装备：晶币购买装备（三选一），穿戴获得词条加成，可卖出折算晶币；
4. 与村民交易或矿物冶炼等玩法可与海克斯联动（见各海克斯描述）。

【配置界面】（Mods 列表 → 海克斯工坊 → Config）
安装 Cloth Config 后为标准 Cloth 界面，共五个分类：
· 海克斯抽取：抽取开关、初始晶币、上限、保底等；
· 经济系统：击杀掉落、兑换比率等；
· 联动内容：TACZ 联动总开关 + 海克斯/锻造器/装备细分开关（默认全开）；
· 客户端：界面、按键相关；
· 游戏规则：死亡保留规则（是否保留海克斯/锻造/装备/晶币，默认死亡清零）。

────────────────────────────────────────────
三、注意事项
────────────────────────────────────────────
1. 【可选依赖】Cloth Config API 为可选依赖：未安装时游戏 Mods 列表的
   Config 按钮会打开 Forge 原生配置界面，功能一致，不会崩溃；
2. 【TACZ 联动】未安装 TACZ 时，联动海克斯/装备/锻造词条自动从抽取池剔除，
   无需手动配置；安装后默认开启，可在配置「联动内容」中关闭；
3. 【弹药联动】TACZ 联动海克斯的弹药回复直接回填当前手持枪械的枪内子弹
   （原版 NBT 键 GunCurrentAmmoCount），满弹不补、不会只回背包弹药；
4. 【属性兼容】模组属性全部走原版 AttributeModifier 标准 API，并做数值消毒
   （NaN/Infinity 钳制），兼容 AttributeFix 等属性修复类 MOD；
5. 【数值安全】锻造器已做数值消毒与倍率克制，适配大型整合包；属性数值
   极值上限 ±1e6，不会溢出崩溃；
6. 【数据驱动】131 海克斯 / 44 装备均为 JSON 数据文件（data/hexworkshop/），
   整合包作者可自行增删改数值，无需改代码；
7. 【死亡保留】默认死亡后海克斯/锻造/装备/晶币全部清零（原版风格），
   如需保留请在配置「游戏规则」中开启对应 gamerule；
8. 【多人/存档】服务端与客户端需使用相同版本；配置以服务端为准（交易、
   抽取、锻造均为服务端结算，客户端改价格无效）；
9. 【反馈】发现 Bug 或建议请到 GitHub Issues 反馈，附上游戏日志与版本号。

────────────────────────────────────────────
四、更新说明（v0.3.18 与近期版本）
────────────────────────────────────────────
【v0.3.18 — 联动海克斯体系】
· 新增 7 个联动海克斯：
  - 海克斯增幅（棱彩）：所有海克斯属性效果 +35%/级；
  - 织装大师（棱彩）：已装备装备的属性效果 +35%/级；
  - 锻造宗师（棱彩）：所有锻造属性效果 +35%/级；
  - 六神装（黄金）：每装备 1 件装备 攻击+0.5/护甲+0.5/生命+2（按等级强化）；
  - 精明商人（黄金）：工坊晶币消费（刷新/锻造器/装备三选一）8%/级折扣；
  - 财源滚滚（黄金）：卖出装备/重复装备折算晶币 +15%/级；
  - 汇率高手（白银）：物品兑换晶币额外 +20%/级；
· 属性三乘区机制：海克斯增幅/锻造宗师/织装大师互相乘算、对应放大；
· 交易折扣与加成全部服务端结算，客户端改价格无效。

【v0.3.17 — 矿物系海克斯联动链路打通】
· 修复「矿脉共鸣」连锁挖掉的子方块不吃熔炼/时运翻倍/磁铁拾取的根因问题；
· 主方块与连锁子方块共用统一矿物处理链路：原版掉落（含时运附魔）→ 海克斯
  时运翻倍 → 冶炼之触熔炼 → 磁铁拾取 → 经验 → 连锁开采；
· 兼容其它 mod 矿石：熔炼升级为「静态表 + 冶炼配方兜底」，熔炉能烧的矿石
  自动烧制成锭。

【v0.3.16 — Cloth Config 标准配置界面】
· 配置界面重写为 Cloth Config 标准样式（五分类、支持搜索/重置/即时保存）；
· 修复背包页签、按键绑定在生产环境不生效的问题；
· 按键设置中必然出现「海克斯工坊」→「打开海克斯页面」（默认 H 键）。

【v0.3.15 — 分类矩阵化 + 三端优化】
· 来源大类（原版 / TACZ 联动 / 未来联动）× 内容小类（海克斯 / 锻造器 / 装备）
  完整划分，按来源自动检测 + 配置开关；
· 新增 TACZ 联动锻造词条：枪械之刃 / 枪械暴击 / 弹药补给。

【v0.3.14 — 叠角龙修复 + TACZ 弹药直通枪内子弹】
· 修复叠角龙自叠层 Bug（自身不再叠层，其它成长海克斯叠层翻倍 100%）；
· TACZ 弹药回复改为回填当前枪械枪内子弹（GunCurrentAmmoCount）。

【v0.3.13 — 命名校准 + 相似提炼（182→124）】
· 13 个海克斯按效果校准命名（中英同步）；
· 相似效果提炼压缩 58 个（182→124），同 key 双胞胎并一、属性子集吞并。

【v0.3.12 — 游戏规则可配 + 界面适配】
· 配置界面纳入 4 条死亡保留 gamerule（服务端权威）；
· 海克斯页面 9 类玩法过滤；
· 锻造器大界面适配（GUI Scale=4x 不再间隔巨大）；
· 新增燃烧免疫海克斯 ×2：耐火之躯 / 烈焰壁垒（被近战攻击点燃攻击者）。

【v0.3.11 — 附魔/矿物海克斯 + 属性修复 MOD 适配】
· 新增 12 个海克斯：附魔系 6（锋利真伤/火焰附加/圣光制裁/节肢克星/击退/
  经验修补）+ 矿物系 6（时运降临/冶炼之触/矿脉共鸣/矿工智慧/探矿之眼/自动拾取）；
· 标准 Forge 配置界面；按键 H 为标准 KeyMapping 可改绑；
· 属性全走原版 AttributeModifier 标准 API + 数值消毒，兼容 AttributeFix。

────────────────────────────────────────────
五、开源与下载
────────────────────────────────────────────
· 源码与 Release（含本 jar 下载）：
  https://github.com/GuJiaoYe1024/hexcraft-workshop
· 许可：MIT，可自由使用、修改、分发（请保留作者署名）。
· 联动物料：TACZ（永恒枪械工坊）属第三方模组，其版权归原作者所有。