Hexcraft Workshop

Chinese description below

海克斯工坊

一款《Minecraft 1.20.1 Forge》海克斯科技风格RPG增强模组。

🚧 开发状态：当前正式版 v0.9.10（持续迭代更新中）。v1.0.0 重大版本正在打磨中——界面全面重置优化（抽取交互、全屏大卡牌、图鉴详情、交互与显示系统整体升级），打磨完成后发布。v0.x 期间持续更新，欢迎反馈。

✨核心玩点

• **184+海克斯强化词条**：白银 / 黄金 / 棱彩三种稀有度。包含流血、暴击、吸血、叠层成长、元素伤害、枪械特化等大量战斗机制。拥有永久叠层、战斗叠层、计时叠层三类成长体系，部分海克斯可以无限堆叠变强。
• **无上限属性锻造**：13种锻造词条，不断锻造持续放大角色属性；不同稀有度提供不同倍率加成。
• **44件英雄联盟风格装备**：全套独特被动机制，使用晶币抽取、回收，构建你的BD配装。
• **世界海克斯全局系统**：40+条全局增益与诅咒，作用于整个存档，所有玩家实时共享生效，改变整个世界的战斗环境。
• **多模组联动**：原生支持TACZ枪械、Iron's Spells 'n Spellbooks法术、冰与火：龙、Alex's Caves、暮色森林；安装对应mod自动解锁对应内容，未安装自动隐藏。
• **HUD自定义布局编辑器【L键】**：全透明画布拖拽调整提示、状态栏、背包页签位置，一键恢复默认布局，无需修改配置文件。
• **滚动提示系统**：击杀、叠层、馈赠等信息统一滚动显示，可自定义同屏最大提示数量，文案精简不遮挡画面。
• **第三方DLC数据包支持**：外部创作者可以使用zip数据包扩展海克斯、装备、锻造词条，游戏内指令热重载，无需重启游戏。
• **双语完整本地化**：简体中文 / 英文，跟随游戏语言自动切换。
• **服务端权威规则**：锻造倍率、叠层上限、抽取消耗全部由服务端管控，客户端修改配置无法作弊。
• **死亡保留配置**：可配置死亡是否保留海克斯、锻造属性、装备与晶币。

🎮 快捷键

• H：打开海克斯工坊主界面
• K：打开世界海克斯界面
• L：打开HUD布局编辑器
• 指令 /hexcraft reload [all|hexes|forging|equipment|world|dlc] 热重载数据包内容

🌐 联机重要说明

• **所有联机玩家必须使用完全一致的模组版本，协议版本锁定**。版本不一致会连接失败。
• 世界海克斯、平衡参数、DLC启用列表保存在存档，由服务端控制，客户端单方面修改配置不会生效。

📦 安装

1. 安装 Minecraft 1.20.1 + Forge 47.x
2. 将mod jar放入mods文件夹
3. 【可选】安装 Cloth Config API，解锁完整图形配置界面

📎 可选依赖

• TACZ (Timeless and Classics Zero)：解锁枪械相关海克斯与装备
• Iron's Spells 'n Spellbooks：解锁法术体系海克斯与装备
• Cloth Config API：图形配置界面
• Alex's Mobs（Alex 的生物)：16 个海克斯 + 2 件装备 + 1 锻造词条
• 暮色森林联动 — 18 个海克斯 + 2 件装备 + 1 锻造词条
• Alex's Caves 联动 — 20 个海克斯 + 2 件装备 + 2 锻造词条
• 冰与火之歌（Ice and Fire CE）联动 — 20 个海克斯 + 2 件装备 + 1 锻造词条

🔗 项目链接

• GitHub仓库：https://github.com/GuJiaoYe1024/hexcraft‑workshop
• Bug反馈与功能建议：https://github.com/GuJiaoYe1024/hexcraft‑workshop/issues
• QQ中文玩家交流群：576626939

> 免责声明：本模组大量借助AI辅助开发，兼容性视运行环境存在差异，遇到BUG欢迎提交Issue反馈。

Hexcraft Workshop

Hex‑tech themed RPG‑enhancement mod for Minecraft 1.20.1 (Forge).

🚧 Dev Status: Current release v0.9.10(still iterating). v1.0.0 major overhaul is in progress — full UI redesign (draw interaction, fullscreen card display, codex details, overall interaction & display upgrade). Ships once polished. v0.x keeps getting updates; feedback is welcome.

✨ Core Features

• **184+ Hex Augments**: Silver/Gold/Prismatic rarities. Includes bleed, crit, lifesteal, stacking growth, elemental damage, firearm‑specialized mechanics. Three stacking types: permanent stack, combat stack, timed stack. Some augments can stack infinitely for greater power.
• **Unlimited Attribute Forging**: 13 forge traits. Keep forging to amplify your stats; different rarities grant different multiplier bonuses.
• **44 League‑of‑Legends‑inspired Equipment**: Unique passives. Use hex‑coins to roll and recycle items to build your own build.
• **World‑Hex Global System**: 40+ global buffs & curses applying to the whole world. Real‑time shared effect for every player, reshaping your world's combat rules.
• **Cross‑mod Compatibility**: Native integration for TACZ firearms, Iron's Spells 'n Spellbooks, Ice and Fire: Dragons, Alex's Caves, Twilight Forest. Content auto‑enables when the target mod is present, auto‑hides otherwise.
• **Drag‑and‑drop HUD Layout Editor【Hotkey L】**: Fully‑transparent canvas. Drag tips, status‑bar, inventory tab positions. One‑click reset without editing config files.
• **Rolling‑tip Notification System**: Kill‑event, stack‑gain, gift messages roll on‑screen. Configurable on‑screen message limit, compact text without screen clutter.
• **Third‑party ZIP DLC Support**: Creators can add custom hexes, equipment and forge traits via zip packs. In‑game command hot‑reload without game restart.
• **Full Localization**: Simplified Chinese & English, auto‑matches your in‑game language setting.
• **Server‑authoritative Rules**: Forge multiplier, stack cap, roll costs are server‑side controlled. Client‑side config edits cannot be used to cheat in multiplayer.
• **Death‑keep Option**: Toggle whether hexes, forging stats, equipment and hex‑coins are kept upon death.

🎮 Hotkeys & Commands

• H: Open Hexcraft Workshop Main UI
• K: Open World‑Hex UI
• L: Open HUD Layout Editor
• Command: /hexcraft reload [all|hexes|forging|equipment|world|dlc] — hot‑reload custom DLC packs.

🌐 Multiplayer Notes

• **All players must run exactly the same mod version with matching protocol number**. Mismatched versions cause connection failure.
• World‑Hex status, balance values and DLC lists are world‑saved & server‑controlled. Client‑only config changes take no effect.

📋 Installation

1. Minecraft 1.20.1 + Forge 47.x
2. Drop jar file into your mods folder
3. Optional: Install Cloth Config API for full graphical config UI

📎 Optional Dependencies

• TACZ (Timeless & Classics Zero): Unlock firearm‑themed hexes & gear
• Iron's Spells 'n Spellbooks: Unlock spell‑system hexes & gear
• Cloth Config API: Graphical configuration menu
• Alex's Mobs: 16 Hexes + 2 pieces of equipment + 1 Forge Affix
• The Twilight Forest Collaboration — 18 Hexes + 2 pieces of equipment + 1 Forge Affix
• Alex's Caves Collaboration — 20 Hexes + 2 pieces of equipment + 2 Forge Affixes
• Ice and Fire CE Collaboration — 20 Hexes + 2 pieces of equipment + 1 Forge Affix

🔗 Links

• GitHub Repository: https://github.com/GuJiaoYe1024/hexcraft‑workshop
• Bug reports & feature requests: https://github.com/GuJiaoYe1024/hexcraft‑workshop/issues
• QQ Community Group: 576626939 (Chinese‑speaking players)

> Disclaimer: This mod is largely AI‑assisted developed. Compatibility may vary with different environments. Please submit feedback if you encounter issues.