[TACZ] HUDcreator

HUDCreator — 在游戏中创建商店、交易、礼包与 HUD 叠加界面

HUDCreator 是一个全能的 Forge 1.20.1 模组，让管理员可以直接在游戏中创建和管理交互式界面：商店、物品交易、带冷却时间的礼包以及持久的 HUD 叠加界面——所有这些都无需外部配置文件，这要归功于内置的游戏内编辑器和嵌入式网页仪表板。

---
功能

4 种 HUD 类型

商店 — 集成经济的买卖商店
- 每个物品可独立设定买入和卖出价格（可单独禁用）
- 可配置网格布局（1 到 5 列）
- 实时显示玩家余额
- 完整支持模组物品和 NBT

交易 — 物物交换系统
- 每笔交易支持多种输入和输出
- 彩色库存指示器（绿色=足够，黄色=部分，红色=缺少）
- 无需货币

礼包 — 带冷却时间的物品分发
- 可配置冷却时间（以秒为单位，或设为无限）
- 在 GUI 中显示实时倒计时器
- 可选权限节点（兼容 Vault）

信息 — 持久的屏幕 HUD 叠加界面
- 元素：玩家名称、余额、生命值、饱食度、经验等级、自定义文本
- 6 个锚点位置（四角 + 顶部/底部居中）
- 像素级精确的 X/Y 偏移
- 可同时激活多个叠加界面（开/关切换）

---
NPC 系统

- 生成与任意 HUD 关联的交互式 NPC
- 自定义皮肤：直接 URL、Minecraft 用户名（Mojang 查询）或已保存的预设
- 自动检测 Steve（宽）和 Alex（瘦）模型
- 无敌、静止、重启后持久存在
- 可选为 NPC 分配命令而非 HUD

---
3 层经济系统（自动检测）

- Vault（优先级 1）— 用于 Mohist / Magma 混合服务器（Forge+Bukkit）
- Grand Economy（优先级 2）— 用于装有 Grand Economy 模组的 Forge 服务器
- 内置经济（优先级 3）— 原生 Forge，无需额外模组
- 可配置初始余额（默认：1000）
- 可自定义货币符号

---
完整的游戏内编辑器

- HUD 管理器：列出所有 HUD，带有编辑/删除按钮
- HUD 编辑器：名称、列数、类型——然后是类型特定的条目编辑器
- 物品选择器：浏览所有创造模式标签页（包含模组 NBT 变体）
- 背包选择器：直接从你的背包中选取物品
- 所有更改实时同步给所有玩家

---
嵌入式网页仪表板

内置 HTTP 服务器提供完整的仪表板和 REST API：

- 对 HUD、NPC 和玩家进行完整的增删改查操作
- 带有过滤器和汇总的交易历史记录（顶级买家、热门物品、商店收入）
- 经济审计：套利检测、重复项、跨店物品
- 经济状况：货币供应、流入/流出、基尼系数、财富分布
- 分析：7 天x24 小时活动热图、高峰时段、转化漏斗、废弃商店
- 每个物品带时间戳的价格历史
- 密码保护（Bearer 令牌）

---
命令

玩家

/hud open <名称> — 打开一个 HUD（或切换信息叠加界面）
/hud balance — 查看自己的余额

管理员（OP 等级 2）

/hud create <名称> <类型> — 创建一个 HUD（shop/trade/kit/info）
/hud edit <名称> — 打开游戏内编辑器
/hud delete <名称> — 删除一个 HUD
/hud list — 打开 HUD 管理器
/hud reload — 将所有定义重新同步给所有玩家
/hud give <玩家> <金额> — 给玩家钱
/hud balance <玩家> — 检查其他玩家的余额

NPC（OP 等级 2）

/hud npc create <hudId> [名称] — 生成一个与 HUD 关联的 NPC
/hud npc remove — 移除目标 NPC
/hud npc skin <值> — 设置皮肤（URL、用户名或预设）
/hud npc command <命令> — 为 NPC 分配一个命令
/hud npc hud <hudId> — 为 NPC 重新分配一个 HUD
/hud npc clear — 清除 NPC 的关联
/hud npc respawn — 重新生成丢失的 NPC
/hud npc preset add/remove/list — 管理皮肤预设
/hud npc list — 列出所有已注册的 NPC

---
配置

文件：config/hudcreator-server.toml

- economy.economyEnabled（默认：true）— 启用经济系统
- economy.defaultBalance（默认：1000.0）— 初始余额（内置经济）
- economy.currencySymbol（默认："$"）— 货币符号
- web.webEnabled（默认：true）— 启用网页仪表板
- web.webPort（默认：8080）— HTTP 端口
- web.webPassword（默认：""）— 密码（空=无认证）

---
兼容性

- Minecraft 1.20.1 — Forge 47.2.0+
- 100% 独立运行 — 无需任何其他模组
- 双语：英语和法语
- 兼容所有添加物品的模组（完整 NBT 支持）
- 兼容 Mohist/Magma 混合服务器（Vault 集成）