logo

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 &lt;player&gt;`	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 &lt;id&gt;`	View specific listing history	`trademarket.admin.history.listing`
`/tm admin history stats &lt;player&gt;`	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