HUDCreator — Create Shops, Trades, Kits & HUD Overlays In-Game

HUDCreator is an all-in-one Forge 1.20.1 mod that lets admins create and manage interactive interfaces directly
in-game: shops, item trades, kits with cooldowns and persistent HUD overlays — all without external config files
thanks to a full in-game editor and an embedded web dashboard.

---
Features

4 HUD Types

Shop — Buy/sell store with economy integration
- Independent buy and sell prices per item (individually disableable)
- Configurable grid layout (1 to 5 columns)
- Player balance displayed in real time
- Full modded item and NBT support

Trade — Item-for-item barter system
- Multiple inputs and outputs per trade
- Color-coded inventory indicator (green = enough, yellow = partial, red = missing)
- No currency required

Kit — Item distribution with cooldowns
- Configurable cooldown in seconds (or unlimited)
- Live countdown timer displayed in the GUI
- Optional permission node (Vault-compatible)

Info — Persistent on-screen HUD overlay
- Elements: Player Name, Balance, Health, Food, XP Level, Custom Text
- 6 anchor points (corners + top/bottom center)
- Pixel-precise X/Y offset
- Multiple overlays active simultaneously (toggle on/off)

---
NPC System

- Spawn interactive NPCs linked to any HUD
- Custom skins: direct URL, Minecraft username (Mojang lookup), or saved presets
- Steve (wide) and Alex (slim) models auto-detected
- Invulnerable, stationary, persistent across restarts
- Option to assign a command instead of a HUD

---
3-Tier Economy (Auto-Detection)

- Vault (priority 1) — for Mohist / Magma hybrid servers (Forge+Bukkit)
- Grand Economy (priority 2) — for Forge servers with Grand Economy mod
- Built-in economy (priority 3) — vanilla Forge, no extra mods needed
- Configurable starting balance (default: 1000)
- Customizable currency symbol

---
Full In-Game Editor

- HUD Manager: lists all HUDs with Edit/Delete buttons
- HUD Editor: name, columns, type — then type-specific entry editor
- Item Picker: browses all creative tabs (includes modded NBT variants)
- Inventory Picker: pick items directly from your inventory
- All changes synced in real time to all players

---
Embedded Web Dashboard

A built-in HTTP server exposes a full dashboard and REST API:

- Full CRUD on HUDs, NPCs and players
- Transaction history with filters and aggregates (top buyers, top items, revenue per shop)
- Economy audit: arbitrage detection, duplicates, multi-shop items
- Economy health: money supply, inflow/outflow, Gini coefficient, wealth distribution
- Analytics: 7d×24h activity heatmap, peak hours, conversion funnel, dead shops
- Price history per item with timestamps
- Password-protected (Bearer token)

---
Commands

Player

/hud open <name> — Opens a HUD (or toggles an Info overlay)
/hud balance — Shows your own balance

Admin (OP level 2)

/hud create <name> <type> — Creates a HUD (shop/trade/kit/info)
/hud edit <name> — Opens the in-game editor
/hud delete <name> — Deletes a HUD
/hud list — Opens the HUD manager
/hud reload — Re-syncs all definitions to all players
/hud give <player> <amount> — Gives money to a player
/hud balance <player> — Checks another player's balance

NPC (OP level 2)

/hud npc create <hudId> [name] — Spawns an NPC linked to a HUD
/hud npc remove — Removes the targeted NPC
/hud npc skin <value> — Sets skin (URL, username, or preset)
/hud npc command <cmd> — Assigns a command to the NPC
/hud npc hud <hudId> — Reassigns a HUD to the NPC
/hud npc clear — Clears the NPC's assignment
/hud npc respawn — Re-spawns missing NPCs
/hud npc preset add/remove/list — Manages skin presets
/hud npc list — Lists all registered NPCs

---
Configuration

File: config/hudcreator-server.toml

- economy.economyEnabled (default: true) — Enables the economy system
- economy.defaultBalance (default: 1000.0) — Starting balance (built-in economy)
- economy.currencySymbol (default: "$") — Currency symbol
- web.webEnabled (default: true) — Enables the web dashboard
- web.webPort (default: 8080) — HTTP port
- web.webPassword (default: "") — Password (empty = no auth)

---
Compatibility

- Minecraft 1.20.1 — Forge 47.2.0+
- 100% standalone — works without any other mod
- Bilingual: English & French
- Compatible with all mods adding items (full NBT support)
- Compatible with Mohist/Magma hybrid servers (Vault integration)