TradePost Documentation
Installation
1. Download the latest TradePost.jar
2. Place it into your server's plugins/ folder
3. Start or restart the server
4. Configure the plugin inside the TradePost folder
TradePost supports
Paper 1.21+
No
Vault or external economy plugin is required.
Currency System
TradePost uses a
built-in item economy.
Admins choose the server's global currency.
Supported currencies:
Code (Text):
EMERALD
DIAMOND
GOLD
IRON
REDSTONE
NETHERITE
Example configuration:
Code (Text):
defaultCurrency: DIAMOND
Players cannot switch currencies, ensuring a
consistent and fair market economy.
Selling Items
Players can sell items through the TradePost GUI.
Steps:
Code (Text):
1. Open the market with /ah
2. Place the item in the listing slot
3. Set the price
4. Confirm the listing
The item will immediately appear on the market.
Listings can optionally expire based on server configuration.
Buying Items
Players can browse listings and purchase items directly.
TradePost includes several protections:
• Purchase confirmation (optional)
• Clear GUI indicators
• Prevention of buying your own listings
• Affordability checks
Shulker Box Preview
Players can
right-click shulker boxes in the market to preview their contents before buying.
This prevents scams and improves market transparency.
Offline Payouts
If an item sells while the seller is offline:
• The currency payout is stored
• The seller can claim it later
Players claim their earnings through the
Claim Payouts menu.
GUI Customization
TradePost allows servers to customize GUI item icons.
Example:
Code (Text):
gui:
items:
main:
create: ANVIL
claim: CHEST
my_listings: BOOK
This allows servers using
resource packs to replace GUI icons with custom textures.
Default icons remain compatible for servers without resource packs.
Taxes (Optional)
Servers may enable a market tax.
Example configuration:
Code (Text):
tax:
enabled: true
mode: PERCENT
percent: 5.0
Tax can be paid by:
Code (Text):
BUYER
SELLER
Translations
TradePost supports multiple languages.
Available languages include:
Code (Text):
English
Spanish
German
French
Portuguese
Japanese
Chinese
Turkish
Vietnamese
Dutch
Hindi
To change language:
Code (Text):
language: en
All messages can also be customized inside
messages.yml.
PlaceholderAPI
TradePost includes built-in placeholders.
Available placeholders:
Code (Text):
%tradepost_iron%
%tradepost_gold%
%tradepost_redstone%
%tradepost_emerald%
%tradepost_diamond%
%tradepost_netherite%
%tradepost_total%
Placeholders count:
• Player inventory
• Ender chest
• Pending payouts
If the player is offline, placeholders return
pending payouts only.
Commands
Code (Text):
/ah
/market
/auction
/tradepost
/tradepost sell - Create a listing
/tradepost my - View your listings
/tradepost claim - Claim sales/returns
/tradepost watch [material] - Watch an item
/tradepost unwatch <material> - Remove a watch
/tradepost watchlist - View your watchlist
/tradepost reload
/tradepost currency
/tradepost info <listingId>
/tradepost remove <listingId> [return]
/tradepost return <listingId>
/tradepost purge [return]
Permissions
Code (Text):
tradepost.use (players have this by default)
tradepost.admin (admin controls & reload)
tradepost.watch (watch features)
tradepost.limit (listing limit)
Players automatically have
tradepost.use.
Support
TradePost is actively maintained.
If you encounter issues or have questions:
• Ask in the discussion section
• Report bugs with server logs
Source Code Policy
TradePost is
closed source.
Source code requests will be declined.
Questions about plugin behavior and configuration are always welcome.