GlymeraMerchant - Gold, Shops, NPC Merchants & Paid Commands!

A complete economy system for your Hytale server: currency, persistent gold balances, NPC shop keepers, a full shop UI, player-to-player trading and a unique paid commands feature that lets you charge gold for any command from any plugin.

Don't miss my other exciting projects — take a look at GlymeraCraft's Profile Discord: https://discord.gg/s5NRFWfxgy

What is GlymeraMerchant?

GlymeraMerchant adds a full gold-based economy to your server. Players earn, spend and trade gold. Admins place NPC merchants in the world that sell and buy items through a visual shop interface. Every player sees their balance in a permanent HUD element in the top-right corner.

The Paid Commands feature is what makes this plugin special: you can make any command from any plugin cost gold. Want /gp claim to cost 500 gold? Just add it to the config. The player runs the command, gets asked to confirm the price, and only then is the gold deducted and the command executed. No changes to the other plugin required.

Features

• Gold currency with configurable name, symbol and max balance
• Starting balance for new players (default: 100)
• Persistent balances saved to JSON, auto-saved every 5 minutes
• Live HUD showing current gold balance (top-right corner, always visible)
• Visual shop UI with buy and sell cards, stock tracking, can-afford indicators
• NPC merchants that stand in the world, look at nearby players and open their shop on interaction
• Custom NPC skins - choose any Hytale creature model as your merchant's appearance
• Player-to-player payments via /pay
• Paid commands - charge gold for any command from any plugin
• VaultUnlocked support - registers as Economy provider so any VaultUnlocked-compatible plugin can use your gold system
• Hot-reload - edit the config and apply changes with /merchant reload, no restart needed

Commands

For Everyone

For OPs Only

Paid Commands

This is the standout feature: make any command from any plugin cost gold, without modifying that plugin.

How It Works

1. Admin adds a command to the paidCommands section in the config
2. Player types the command (e.g. /gp claim myplot)
3. The command is intercepted before it executes
4. Player sees: "Claiming a plot costs 500 G. Type /confirm within 15s to proceed."
5. Player types /confirm within the timeout
6. Gold is deducted and the command executes normally

If the player doesn't have enough gold, they are told immediately. If they don't confirm in time, the request expires and they need to run the command again.

Config Example

"paidCommandOpExempt": true,
"paidCommandTimeout": 15,
"paidCommands": {
  "gp claim": { "cost": 500, "description": "Claiming a plot" },
  "tpp set": { "cost": 100, "description": "Setting a teleport point" },
  "bw create": { "cost": 1000, "description": "Creating a biome world" }
}

• Key = command prefix without / (matches the command and anything after it)
• cost = gold price
• description = shown to the player in the confirmation message (optional, defaults to the command itself)
• paidCommandOpExempt = if true, OPs never have to pay (default: true)
• paidCommandTimeout = seconds the player has to type /confirm (default: 15)

Shop System

Setting Up a Shop (In-Game)

1. Type /merchant create myshop - a skin selection UI opens
2. Click on the appearance you want for your merchant NPC
3. The NPC spawns at your position with an empty shop
4. Hold an item and type /merchant add myshop buy 150 to add it as a buyable item for 150 gold
5. Hold another item and type /merchant add myshop sell 30 to make it sellable for 30 gold
6. Players can now interact with the NPC or use /shop myshop to open the shop

Shop UI

• Buy cards (green) show items players can purchase, with price and can-afford indicator
• Sell cards (blue) show items players can sell back to the shop
• Items can be buy-only, sell-only, or both (with different prices)
• Optional stock limits per item
• Balance updates live in the shop title bar after each transaction
• If the player's inventory is full when buying, the item drops on the ground

Configuration

The full config is at plugins/GlymeraMerchant/config.json and is auto-generated on first start.

VaultUnlocked Support

GlymeraMerchant automatically registers as an Economy provider with VaultUnlocked if it is installed. This means any plugin that uses VaultUnlocked for economy (checking balances, depositing, withdrawing) will use GlymeraMerchant's gold system - no configuration needed.

• Optional: VaultUnlocked is not required. GlymeraMerchant works perfectly fine on its own.
• Automatic: If VaultUnlocked is in your mods/ folder, the integration activates automatically.
• Compatible: Works with any plugin that uses the VaultUnlocked Economy API (Vault2).

Installation

1. Place GlymeraMerchant-2.0.0.jar in your server's mods/ folder
2. (Optional) Place VaultUnlocked-Hytale.jar in mods/ for cross-plugin economy support
3. Start (or restart) the server
4. The config and data folders are created automatically
5. Edit plugins/GlymeraMerchant/config.json to configure shops and paid commands
6. Use /merchant reload in-game to apply changes

Data Storage

All data persists across server restarts. Balances are auto-saved every 5 minutes and on shutdown.

Good to Know

• Merchant NPCs survive server restarts - they are tracked by position and respawned automatically
• NPCs use a custom role (GlymeraMerchantNPC) so cleanup never touches wild NPCs
• The gold HUD works alongside GlymeraHUD if installed (multi-HUD support)
• Paid commands use packet-level interception - they work with commands from any plugin without compatibility issues
• Skin selection UI supports filtering (type /merchant create myshop:horse to only show horse-like models)
• The /shop command can be disabled in the config to force players to visit NPC merchants in person

Made with care by Glymera for the Hytale community