[TACZ] HUDcreator

 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)