HyMarket+ - Hytale Economy & Trading System

This mod is currently still in beta. Please report any bugs here. Features request are welcome

💰 Currency System

Three-tier currency: Gold, Silver, Copper (1g = 100s = 10,000c)
Automatic formatting (e.g., "5g 25s 50c")
Persistent player balance storage

🛒 Server Shop

Admin-configured shop with categories (Weapons, Armor, Materials, etc.)
Separate buy and sell prices
Limited or unlimited stock per item
Time-limited offers available
Shop Tabs are 100% customizable (Name,Order)
Rarity display (Common to Legendary)

🏪 Player Marketplace

Players can sell items to other players
Up to 20 active listings per player
Configurable tax rate on sales (default: 5%)
Listings expire after 7 days (configurable)
Sort by price or date
Filter by rarity

🔨 Auction House

Admins create auctions with starting bid and duration
Players can bid in real-time
Automatic refund when outbid
Server-wide announcements for new bids
Won items are delivered automatically (even offline)

🎟️ Voucher System

Create promo codes with coin rewards
Set maximum redemptions
Optional expiration date
Each player can only redeem each code once
Vouchers can include item rewards
Server admins can create "Starter Packs" or reward bundles

👹 Monster Drop System

Earn coins from killing monsters
Configurable per monster: Min/Max copper, drop chance
Admins can create monster groups (e.g., "Low Mobs", "High Mobs", "Bosses") with unified drop configurations
Each group has configurable: Min Copper, Max Copper, and Drop Chance (%)
Can be globally enabled/disabled

📦 Reward Delivery System

Items are delivered even to offline players
Automatic retry when inventory is full

🗣️Multiple Languages Support

EN,DE now supported
Server Owners can translate the mod into their own language themselves (see below)

🎮 Mod Integration

RPGLeveling Mod Integration (www.curseforge.com/hytale/mods/rpg-leveling-and-stats)
- Integrated with the RPGLeveling mod for level-restricted shop items
VaultUnlocked Integration
- HyMarketPlus now intergrates with VaultUnlocked economy system
- Your coin balance is now shared across all VaultUnlocked.compatible mods

Player Commands

Command	Description
`/balance`	View your current balance
`/pay`	Send coins to another player
`/shop`	Open the Server Shop
`/market`	Open the Player Marketplace
`/marketsell`	List an item for sale
`/auction`	Open the Auction House
`/voucher`	Redeem a voucher code
`/mplang`	Change Language

Admin Commands

Command	Description
`/admin`	Open the Admin Control Panel
`/addcoins`	Add 1 gold to yourself (testing)

undefined

Admin Control Panel

The /admin panel provides a graphical interface with tabs:

Economy - Manage player balances, view statistics, global actions
Shop - Add/edit items, manage categories
Market - Marketplace settings
Vouchers - Create and manage vouchers
Drops - Configure monster drop rates
Auctions - Create and manage auctions
Statistics - Server-wide economy statistics
Settings - Plugin settings

Data Storage

All data is automatically saved to mods/HyMarketPlus/:

economy.json - Player balances
shop/ - Shop configuration
market/ - Marketplace listings
vouchers.json - Vouchers
auctions.json - Auctions
rewards.json - Pending rewards
monster-drops.json - Drop configuration

Adding new Languages

## Adding a New Language

Server admins can easily add new languages:

1. Navigate to `mods/HyMarketPlus/lang/`

2. Copy `en.json` to a new file (e.g., `fr.json` for French)

3. Translate all values (keep the keys unchanged!)

4. Update the `language.name` and `language.code` entries

5. Restart the server

### Example: French (`fr.json`)

```json

{

"language": {

"name": "Français",

"code": "fr"

"common": {

"balance": "Solde: {0}",

"close": "Fermer",

"confirm": "Confirmer"

"shop": {

"title": "Boutique du Serveur",

"buy_success": "Achat de {0}x {1} réussi!"

}

```

### Translation Tips

- Keep all JSON keys exactly as they are in the English file

- Missing translations will automatically fall back to English