TradeMarket

TradeMarket

A secure, item-to-item marketplace plugin for Hytale servers. Players create listings, browse offers, and trade through a safe escrow system, no real money involved, just in-game items.

Heads up: TradeMarket is still in active development. The core marketplace works and is stable enough for production use, but new stuff gets added regularly. Bug reports and feedback are always welcome.

---

How it works

Selling

Open the marketplace with /tm and hit Create Listing. Pick the items you want to offer, set what you want in return (and how much), choose how long the listing should stay up, and confirm. Your offered items get moved into escrow automatically, they're held server-side until someone buys or the listing expires.

Buying

Also /tm. Browse what's available, click into a listing to see the details, and buy if you like the deal. You get the items immediately. The seller's payment goes to their vault.

Vault

/tm vault opens your personal vault. This is where earnings from sales and returned items from expired/cancelled listings end up. Grab your stuff out of there whenever you want. It's not meant for long-term storage, just a pickup point.

Expiration

Listings expire on their own based on the duration you set. Escrowed items get returned to your vault automatically. Nothing gets lost. Remember, you do not need to be online for a sale to happen, your vault will handle it.

---

Features

What's working right now:

• Full GUI marketplace: browse all listings or filter to just yours
• Item selector with categories and search
• Favorite items panel for quick access (player and server-wide)
• Escrow system: items are locked server-side until the trade completes or expires (at the current version, players are able to cancel their listing)
• SQLite persistence with automatic migrations and backups
• Auto-save at configurable intervals, idle data gets freed from memory
• Notification system: login summaries and transaction alerts
• Admin commands for viewing trade history, reloading config, manual saves, and creating SYSTEM listings

Coming later:

• Virtual currency support
• Regional / rule-based market zones
• Auction system (bidding)
• Granular permissions per player/group (for vault size, maximum trades at once, trade limit per day/week, item categories)
• Entire category blacklisting/whitelisting as well as just specific items
• Custom market blocks and NPCs for in-world integration
• Extended admin tools for bulk operations, transaction logs, monitoring, infinite type system listings.

---

Commands

Player Commands

Regardless of what you are trying to do, you need to grant trademarket.use beforehand.

Command	What it does	Permission
/tm	Open the marketplace	trademarket.command.browse
/tm vault	Open your vault	trademarket.command.vault

Admin Commands

Command	What it does	Permission
/tm admin reload	Reload config	trademarket.admin.reload
/tm admin save	Force save data	trademarket.admin.save
/tm admin systemlisting	Create a system listing	trademarket.admin.systemlisting
/tm admin history player <player>	View player trade history	trademarket.admin.history.player
/tm admin history server	View server-wide trade history	trademarket.admin.history.server
/tm admin history listing <id>	View specific listing history	trademarket.admin.history.listing
/tm admin history stats <player>	View player trade statistics	trademarket.admin.history.stats

GUI Permissions

Action	What it does	Permission
Create Listing	Create new listings in the marketplace GUI	trademarket.listing.create
Buy Listing	Purchase listings from the marketplace GUI	trademarket.listing.buy

Minimum Setup Permissions

For Regular Players

trademarket.use
trademarket.command.browse
trademarket.command.vault
trademarket.listing.create
trademarket.listing.buy

Or using wildcards:

trademarket.use
trademarket.command.*
trademarket.listing.*

For Admins

trademarket.*

Configuration

Config lives at {server}/mods/StealthC_TradeMarket/TradeMarket.json.

Server Wide Item Favorites (example):

  "ServerFavoriteItems": 
[
  "Ingredient_Bar_Gold",
  "Ingredient_Bar_Copper",
  "Ingredient_Bar_Iron"
]

---

FAQ

Can I use this in production? Yeah. The core is stable, transactions are safe, and data is persisted. Just back up your trade-market.db before updating to ensure nothing breaks, and if it does you can go back.

What happens if the server crashes mid-transaction? In-progress listings get rolled back. Items don't vanish. The system uses at-least-once semantics with idempotent operations.

Does it work in singleplayer? Technically yes, but you'd be trading with yourself, so… you do you.

Currency support? Item-to-item only for now. Currency is planned.

---

Localization

This mod supports Hytale's native lang files. A github repository will soon be made to allow community translations. Supported languages:

• Português (Brasileiro): Autor @StealthC
• English: Author @StealthC
• Español: Autor @laz0rra

---

Support

Detailed wikis, bug reports, feature requests and general feedback should be done on the Discord server: https://discord.gg/uDKpPW5QRx