Hexcraft Workshop

Chinese translation is available at the bottom of this page.

Hexcraft Workshop

A Minecraft 1.20.1 Forge augmentation mod inspired by Hextech. Roll powerful augments, enjoy unlimited attribute forging, collect unique equipment, and experience global world‑wide curses & buffs with a polished dark‑tech themed UI.

🎯 Core Features

- **170+ Hex Augments** across Silver / Gold / Prismatic tiers, with bleed, mark, slow and other combat mechanics. Toggleable content groups available in config.
- **Stack System**: Permanent, combat, timed stack types with trigger & effect tags. Tooltips automatically display stack behavior for easy reading.
- **Unlimited Attribute Forging**: Single‑pool forging system. Silver/Gold/Prismatic only change multipliers and weights, all forge traits can drop from every tier. Tooltips dynamically show real calculated values.
- **44 unique equipment items** with League of Legends inspired mechanics, purchasable and recyclable using Hexcoins.
- **Hexcoin economy**: Earn coins by killing mobs, exchange resources for hexcoins in the recharge tab.
- **TACZ (Timeless and Classics Zero) Integration**: Exclusive firearm augments and gear. Ammo can refill directly into magazines. Fully toggleable and optional.
- **World Hexes**: Global buffs and curses applying to all players in the world. Spend XP to roll new world hexes, or spend hexcoins to clear active ones.
- **Third‑Party ZIP DLC Support**: Creators can ship content packs as folders or direct `.zip` archives. Place packs inside `[version‑folder]/hexworkshop_dlc/packs/`. JSON‑only packs support hot‑reload via `/hexcraft reload dlc`.
- **Full English & Simplified Chinese localization**, auto‑matching your game language.
- **Cloth‑Config GUI support**: Critical values like forge multipliers and stack caps are server‑authoritative to prevent cheating.
- **Open‑source MIT licensed**, no obfuscated code.

🎮 Controls

- Press **H** to open the main Hexcraft Workshop UI
- Press **K** to open the World Hex panel
- Command: `/hexcraft reload [all|hexes|forging|equipment|world|dlc]` for live JSON content reload

🌐 Multiplayer Rules

Server and clients must use the exact same mod version.
All core balancing settings, world hex states and DLC enable lists are controlled by the server; client‑side edits will not take effect.

📦 Requirements

- Minecraft: 1.20.1 | Loader: Forge 47.x
- Optional: Cloth‑Config API (for graphical config menu)
- Optional: TACZ (Timeless and Classics Zero) to unlock firearm themed content

## ❓ FAQ

> Q: Where to put third‑party DLC zip packs?
> A: Put `.zip` or unpacked folder inside `[your‑mc‑version‑folder]/hexworkshop_dlc/packs/`. The folder will auto‑generate on first launch. This folder is for external creator content only, base mod works fine without it.

> Q: Can I edit forging / stack multipliers on client to cheat in multiplayer?
> A: No. These settings are fully server‑side controlled. Client‑side changes have zero effect.

> Q: Some augments say placeholder notes / not working?
> A: In v0.6.2 all formerly placeholder mechanics are implemented. If you still see placeholder notes you are running an older build.

> Q: Can I use old save files?
> A: Saves from v0.5.x / v0.6.x can be upgraded directly to v0.6.2.

 🔗 Links

- GitHub Source: https://github.com/GuJiaoYe1024/hexcraft‑workshop
- Feedback & Issues: GitHub Issues
- Chinese Community QQ Group: 576626939

---
中文版本
海克斯工坊是一款基于1.20.1 Forge、以海克斯强化为核心的模组。你可以抽取强力海克斯强化，体验无上限属性锻造，收集特色装备，在存档内生效的全局世界海克斯增益与诅咒，搭配暗科技风格UI。

🎯 核心功能

- **170+海克斯强化**，分为白银、黄金、棱彩品级，包含流血、标记、减速等战斗机制。配置内可以开关对应内容分组。
- **叠层系统**：永久叠层、战斗临时叠层、计时叠层，附带触发类型与效果标签。悬浮提示自动展示叠层规则，方便阅读。
- **无上限属性锻造**：统一锻造池。白银/黄金/棱彩仅改变倍率与权重，全部锻造词条在任意品级都有机会产出。悬浮提示动态展示真实计算后的数值。
- **44件特色装备**：参考英雄联盟机制设计，可以使用海克斯币购买、回收。
- **海克斯币经济系统**：击杀生物获取海克斯币，可以在充值标签页用资源兑换海克斯币。
- **TACZ（Timeless and Classics Zero）联动**：专属枪械类海克斯与装备，支持直接向弹夹补弹药。可开关，非强制依赖。
- **世界海克斯**：作用于存档内全部玩家的全局增益、诅咒。消耗XP抽取新世界海克斯，也可以消耗海克斯币清除已激活的世界海克斯。
- **第三方ZIP DLC扩展支持**：其他创作者可以直接发布文件夹或者zip格式内容包。放到 `[版本文件夹]/hexworkshop_dlc/packs/`。纯JSON数据包支持指令 `/hexcraft reload dlc` 热重载。
- **完整中英双语本地化**，自动跟随游戏语言。
- **支持Cloth‑Config图形配置页**：锻造倍率、叠层上限等关键数值由服务端管控，防止作弊。
- MIT协议开源，无混淆加密代码。

🎮 按键

- **H**：打开海克斯工坊主界面
- **K**：打开世界海克斯面板
- 指令：`/hexcraft reload [all|hexes|forging|equipment|world|dlc]` 热重载JSON内容

 🌐 联机规则

服务端和所有客户端必须使用完全一致的Mod版本。
所有核心平衡配置、世界海克斯状态、DLC启用列表都由服务端控制；客户端单方面修改配置不会生效。

📦 依赖

- Minecraft：1.20.1 | 加载器：Forge 47.x
- 可选依赖：Cloth‑Config API（图形配置菜单）
- 可选依赖：TACZ（Timeless and Classics Zero）解锁枪械相关内容

❓ 常见问题

> Q：第三方DLC压缩包放在哪里？
> A：把zip文件或者解压后的文件夹放入 `你的MC版本文件夹/hexworkshop_dlc/packs/`。第一次启动模组会自动生成该文件夹。这个文件夹仅用于存放外部作者的扩展包，没有它本体也能正常游玩。

> Q：我能不能在单机客户端修改锻造、叠层倍率，到服务器里作弊？
> A：不行。这些参数完全由服务端控制，客户端修改不会产生任何效果。

> Q：部分海克斯标注占位提示、功能不生效？
> A：v0.6.2版本已经把之前所有预留待实现机制全部做完。如果你还能看到占位提示，说明你在用旧版本。

> Q：旧存档还能用吗？
> A：v0.5.x、v0.6.x系列存档可以直接升级到v0.6.2，不需要新建存档。

🔗 链接

- GitHub源码：https://github.com/GuJiaoYe1024/hexcraft‑workshop
- 反馈与问题提交：GitHub Issues
- 国内玩家QQ群：576626939