GlymeraMerchant v5.0

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.

Most actual version only working for Hytale stable 5 !

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 for cross-plugin compatibility
• Hot-reload — edit the config and apply changes with /merchant reload, no restart needed

Commands — For Everyone

/money — Check your current gold balance
/pay <player> <amount> — Send gold to another player
/shop — Open the shop of the nearest merchant NPC (within 8 blocks)
/shop <type> — Open a specific shop by name (e.g. /shop weaponsmith)
/confirm — Confirm a paid command and pay the gold

Commands — OP Only

/money give <player> <amount> — Give gold to a player
/money take <player> <amount> — Take gold from a player
/merchant create <name> — Create a new shop and pick a skin
/merchant create <name>:<filter> — Create shop with skin filter (e.g. myshop:cow)
/merchant add <name> buy <price> — Add the item in your hand as a buyable item
/merchant add <name> sell <price> — Add the item in your hand as a sellable item
/merchant remove <name> — Remove the item in your hand from a shop
/merchant spawn <name> — Spawn an NPC for an existing shop at your location
/merchant delete — Delete the nearest merchant NPC
/merchant list — List all shops and their trade counts
/merchant types — List all available NPC appearances
/merchant reload — Reload config (shops, paid commands, settings)

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.

Config example:

• "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"
• paidCommandOpExempt: true (OPs never have to pay)
• paidCommandTimeout: 15 seconds

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 buyable 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

Full config at plugins/GlymeraMerchant/config.json (auto-generated on first start):

• startBalance (default: 100) — Gold given to new players on first join
• currencyName (default: "Gold") — Name of the currency
• currencySymbol (default: "G") — Short symbol after amounts
• maxBalance (default: 999999) — Maximum gold a player can hold
• allowShopCommand (default: true) — If false, players must walk to NPC merchants
• paidCommandOpExempt (default: true) — OPs skip payment for paid commands
• paidCommandTimeout (default: 15) — Seconds to confirm a paid command

VaultUnlocked Support

GlymeraMerchant automatically registers as an Economy provider with VaultUnlocked if it is installed. Any plugin that uses VaultUnlocked for economy 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).

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
• Skin selection UI supports filtering (e.g. /merchant create myshop:horse)
• The /shop command can be disabled in config to force players to visit NPC merchants in person

Installation

1. Place GlymeraMerchant.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

Made with care by Glymera for the Hytale community