description_c9bf921e-d58a-4e58-af97-1ab672ec95b2.png
description_a8face99-beed-4ec6-89d9-e9f540e83cc7.png
description_b1cbb0d9-4efa-4269-99ba-4a973194ae96.png
Server Shop
Description
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 balancesshop/- Shop configurationmarket/- Marketplace listingsvouchers.json- Vouchersauctions.json- Auctionsrewards.json- Pending rewardsmonster-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
The HyMarketPlus Team
