ModsJava
AsterionTrades | Advanced Trading System | Items, Money, XP & Multi-Economy
Trades
⬇ Download on SpigotA modern, secure and fully configurable trading plugin for Minecraft servers. Trade items, money, experience and custom currencies through an intuitive GUI with double confirmation, countdown protection, automatic item recovery, detailed trade logs, administration tools, multiple languages and much more.
ASTERIONTRADES
A modern, secure and configurable player trading system.
Items • Money • Experience • Custom Currencies • Logs • Administration
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ WHAT IS ASTERIONTRADES?
AsterionTrades is a complete player-to-player trading system designed for modern Minecraft servers.
Players can safely exchange items, money, experience and custom server currencies through a clean inventory-based interface.
Trades can be started using commands or simply by interacting with another player. Every transaction is protected by confirmations, offer locking, resource validation and recovery systems designed to prevent item or currency loss.
Almost everything important can be customized through YAML files without modifying the plugin.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ MAIN FEATURES
❆ HOW TRADING WORKS
Send another player a trade request:
/trade
The target player can accept it with:
/trade accept
Or deny it with:
/trade deny
When interaction trading is enabled, players can also use:
Sneak + Right Click
to send or accept a trade request.
Once accepted, both players are placed inside the trading interface.
Each side can add its own:
Items
Money
Experience
Custom Currencies
Both players can see the complete offer before accepting.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ ITEM TRADING
AsterionTrades provides separate item areas for both players.
The default interface contains 20 offer slots for each player, allowing large trades without requiring multiple transactions.
Players can freely add and remove their items until the trade is confirmed.
If one player changes their offer after someone has accepted:
Both confirmations are automatically reset.
This prevents last-second modifications from being silently accepted.
If the trade is cancelled or interrupted, the plugin safely handles the offered items instead of simply deleting them.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ MONEY TRADING
AsterionTrades supports money trading through EssentialsX.
Players can click the money button inside the trade GUI and enter an amount directly in chat.
Example:
5000
Players can also type:
max
to automatically use the maximum available amount.
Or:
cancel
to leave amount input mode.
The message used to enter the amount is intercepted and will not be sent to public chat.
Money options can be configured:
currency:
money:
step : 100
large-step : 1000
max-offer : 1000000000000
decimals : 2
The player's balance is checked again before the transaction is completed.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ EXPERIENCE TRADING
Experience points can also be added directly to a trade.
Click the experience button and enter the amount in chat:
100
You can also use:
max
cancel
The plugin validates that the player still has enough XP before completing the transaction.
Example configuration:
currency:
experience:
step : 10
large-step : 100
max-offer : 100000000
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ CUSTOM CURRENCIES
AsterionTrades is not limited to normal server money.
You can create additional currencies for systems such as:
Coins
Tokens
Gems
Credits
Astros
Event Points
The plugin includes support for
ServerVariables-backed currencies and also contains support for
placeholder + command based economies.
The default configuration includes an example custom currency:
custom-economies:
astros:
enabled : true
placeholder : "%servervariables_value_astro%"
Custom currencies can have their own GUI buttons, materials, names and lore.
Example:
custom-economies:
astros:
display-name : "Astros"
own-slot : 1
other-slot : 7
item:
material : PRISMARINE_SHARD
name : "EF5E5&lASTROS"
lore:
- "&7Current offer : EF5E5%amount% %economy%"
- ""
- "&eClick to enter an amount"
- "&7The amount is entered in chat."
This allows AsterionTrades to adapt to servers using their own secondary currencies.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ DOUBLE CONFIRMATION
AsterionTrades does not immediately complete a transaction when one player accepts.
Both players must confirm their offers.
The GUI displays the current state using configurable items:
NOT ACCEPTED
OFFER ACCEPTED
TRADE IN 3s
If either player changes anything in their offer, both confirmations are removed automatically.
Once both players accept, the final countdown begins.
Example:
settings:
countdown-seconds : 3
During the countdown:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ SAFE TRANSACTIONS
Before finishing a trade, AsterionTrades verifies the resources involved in the transaction.
This includes:
The plugin also includes handling for failed transactions and pending item recovery.
If inventory space is not available when items need to be restored, remaining stacks can be safely dropped at the player's feet instead of disappearing.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ AUTOMATIC ITEM RECOVERY
AsterionTrades contains a pending transaction recovery system.
If items need to be restored after an interrupted or failed transaction, the plugin can keep the pending delivery and restore it when possible.
Players can receive a message such as:
Your pending trade items were restored automatically.
If their inventory is full, remaining item stacks can be dropped safely at their location.
This provides additional protection for valuable trades.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ TRADE REQUESTS
Request behavior is configurable:
settings:
request-timeout-seconds : 30
request-cooldown-seconds : 3
countdown-seconds : 3
active-trade-timeout-seconds : 300
input-timeout-seconds : 45
allow-empty-trades : false
This provides protection against:
/trade toggle
and enable them again using the same command.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ INTERACTION TRADING
Players do not always need to type commands.
Interaction trading can be configured using:
settings:
shift-right-click : true
shift-right-click-fallback : true
shift-left-click : false
With the default configuration, players can:
Sneak + Right Click another player
to quickly send or accept a trade request.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ DISABLED WORLDS
Trading can be completely disabled in selected worlds.
Example:
settings:
disabled-worlds :
- world_pvp
- event_world
Administrators can grant the bypass permission:
asteriontrades.bypass.disabledworld
to players or staff members that should still be able to trade there.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ TRADE LOGS
AsterionTrades stores trade history for administration and investigation.
Every transaction receives its own unique Trade ID.
Logs can include information about:
settings:
log-cancelled-trades : true
Log options:
logs:
time-zone : America/Argentina/Buenos_Aires
folder : logs
human-readable-file : trades.log
page-size : 8
The time zone, log folder, human-readable log filename and results per page can all be configured.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ ADMINISTRATIVE TOOLS
AsterionTrades includes dedicated tools for server staff.
/atrade logs [player] [page]
Browse trade history.
Logs can also be filtered by player and displayed using pages.
/atrade view
Open a stored trade by its Trade ID.
/atrade inspect
Inspect a player's active trade.
/atrade copy <a|b|all> [player]
Create an administrative copy of items stored in a logged trade.
This can be useful when investigating reports or restoring items.
/atrade cancel
Force-cancel a player's active trade.
/atrade reload
Reload AsterionTrades configuration.
The administration command also has the alias:
/asteriontrades
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ COMMANDS
/trade
/trade accept
/trade deny
/trade toggle
/trade help
/atrade logs [player] [page]
/atrade view
/atrade copy <a|b|all> [player]
/atrade inspect
/atrade cancel
/atrade reload
/asteriontrades
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ PERMISSIONS
Player permissions:
asteriontrades.use
asteriontrades.click
asteriontrades.command
asteriontrades.bypass.disabledworld
Administrative permissions:
asteriontrades.admin.logs
asteriontrades.admin.view
asteriontrades.admin.copy
asteriontrades.admin.inspect
asteriontrades.admin.cancel
asteriontrades.admin.reload
Full administrator permission:
asteriontrades.admin
asteriontrades.admin grants all AsterionTrades administration permissions.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ FULLY CONFIGURABLE GUI
The trade interface is controlled through:
plugins/AsterionTrades/gui.yml
You can customize:
title : "&8Trading with &b%player%"
size : 54
items:
accept-pending:
material : RED_WOOL
name : "&c&lNOT ACCEPTED"
lore :
- "&7Review the entire offer carefully."
- ""
- "&eClick to accept"
accept-ready:
material : LIME_WOOL
name : "&a&lOFFER ACCEPTED"
lore :
- "&7Your side is confirmed."
- ""
- "&eClick to cancel your acceptance"
accept-locked:
material : LIME_WOOL
name : "&a&lTRADE IN %seconds%s"
lore :
- "&7The offers are locked."
- ""
- "&cClick to cancel the countdown"
The default menu uses a 54-slot inventory with separate trading areas for both players.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ HEX COLOR SUPPORT
AsterionTrades configurations support colors such as:
&aGreen
&cRed
&bAqua
HE7FF
&#FFD65A
EF5E5
This makes it easy to match the plugin interface with your server's visual style.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ LANGUAGES
AsterionTrades includes 10 languages:
en_US
es_ES
pt_BR
fr_FR
de_DE
it_IT
ru_RU
zh_CN
ja_JP
ko_KR
Select the language from
config.yml:
language : en_US
Each language has its own editable YAML file.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ OPTIONAL INTEGRATIONS
ServerVariables
Can be used as a provider for custom currencies, allowing server-specific balances to be traded directly.
PlaceholderAPI
AsterionTrades includes an optional PlaceholderAPI hook and supports placeholder-based custom economy configurations.
These plugins are optional unless you configure functionality that depends on them.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ REQUIREMENTS
EssentialsX is required by the plugin and provides the built-in money economy.
ServerVariables and PlaceholderAPI are optional integrations.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ INSTALLATION
/atrade reload
A full server restart is recommended when replacing the AsterionTrades JAR.
Do not use PlugMan or similar plugin managers to replace the plugin while the server is running.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ TRADE SAFELY. TRADE EVERYTHING. ❆
Items, money, experience and custom currencies combined into one secure trading system.
ASTERIONTRADES
A modern, secure and configurable player trading system.
Items • Money • Experience • Custom Currencies • Logs • Administration
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ WHAT IS ASTERIONTRADES?
AsterionTrades is a complete player-to-player trading system designed for modern Minecraft servers.
Players can safely exchange items, money, experience and custom server currencies through a clean inventory-based interface.
Trades can be started using commands or simply by interacting with another player. Every transaction is protected by confirmations, offer locking, resource validation and recovery systems designed to prevent item or currency loss.
Almost everything important can be customized through YAML files without modifying the plugin.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ MAIN FEATURES
- Secure player-to-player trading GUI.
- Trade multiple items at the same time.
- Trade EssentialsX money.
- Trade experience points.
- Support for custom server currencies.
- ServerVariables currency integration.
- Placeholder + command based custom economy support.
- Sneak + Right Click trading.
- Optional Sneak + Left Click interaction.
- Command-based trade requests.
- Clickable Accept and Reject request buttons.
- Trade request expiration.
- Configurable request cooldowns.
- Per-player trade request toggle.
- Active trade timeout protection.
- Double confirmation system.
- Configurable final countdown.
- Offers are locked during the countdown.
- Changing an offer resets both confirmations automatically.
- Players can cancel their confirmation.
- Players can cancel an active countdown.
- Empty trade protection.
- Disabled world support.
- Balance validation before completing transactions.
- Experience validation before completing transactions.
- Custom currency validation.
- Safe trade cancellation.
- Automatic pending item recovery.
- Inventory overflow protection.
- Failed transaction rollback handling.
- Unique Trade IDs.
- Completed trade logs.
- Optional cancelled trade logs.
- Searchable administrative logs.
- Administrative trade viewer.
- Active trade inspection.
- Item recovery/copy tools for administrators.
- Force-cancel active trades.
- Fully configurable GUI.
- Custom materials, names and lore.
- HEX color support.
- 10 included languages.
- Command autocompletion.
- Configurable time zone for logs.
❆ HOW TRADING WORKS
Send another player a trade request:
Code (Text):
/trade
Code (Text):
/trade accept
Code (Text):
/trade deny
Code (Text):
Sneak + Right Click
Once accepted, both players are placed inside the trading interface.
Each side can add its own:
Code (Text):
Items
Money
Experience
Custom Currencies
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ ITEM TRADING
AsterionTrades provides separate item areas for both players.
The default interface contains 20 offer slots for each player, allowing large trades without requiring multiple transactions.
Players can freely add and remove their items until the trade is confirmed.
If one player changes their offer after someone has accepted:
Both confirmations are automatically reset.
This prevents last-second modifications from being silently accepted.
If the trade is cancelled or interrupted, the plugin safely handles the offered items instead of simply deleting them.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ MONEY TRADING
AsterionTrades supports money trading through EssentialsX.
Players can click the money button inside the trade GUI and enter an amount directly in chat.
Example:
Code (Text):
5000
Code (Text):
max
Or:
Code (Text):
cancel
The message used to enter the amount is intercepted and will not be sent to public chat.
Money options can be configured:
Code (YAML):
currency:
money:
step : 100
large-step : 1000
max-offer : 1000000000000
decimals : 2
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ EXPERIENCE TRADING
Experience points can also be added directly to a trade.
Click the experience button and enter the amount in chat:
Code (Text):
100
Code (Text):
max
cancel
Example configuration:
Code (YAML):
currency:
experience:
step : 10
large-step : 100
max-offer : 100000000
❆ CUSTOM CURRENCIES
AsterionTrades is not limited to normal server money.
You can create additional currencies for systems such as:
Code (Text):
Coins
Tokens
Gems
Credits
Astros
Event Points
The default configuration includes an example custom currency:
Code (YAML):
custom-economies:
astros:
enabled : true
placeholder : "%servervariables_value_astro%"
Example:
Code (YAML):
custom-economies:
astros:
display-name : "Astros"
own-slot : 1
other-slot : 7
item:
material : PRISMARINE_SHARD
name : "EF5E5&lASTROS"
lore:
- "&7Current offer : EF5E5%amount% %economy%"
- ""
- "&eClick to enter an amount"
- "&7The amount is entered in chat."
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ DOUBLE CONFIRMATION
AsterionTrades does not immediately complete a transaction when one player accepts.
Both players must confirm their offers.
The GUI displays the current state using configurable items:
Code (Text):
NOT ACCEPTED
OFFER ACCEPTED
TRADE IN 3s
Once both players accept, the final countdown begins.
Example:
Code (YAML):
settings:
countdown-seconds : 3
- Offers are locked.
- Items cannot be silently changed.
- The transaction has not completed yet.
- The countdown can still be cancelled safely.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ SAFE TRANSACTIONS
Before finishing a trade, AsterionTrades verifies the resources involved in the transaction.
This includes:
- Offered items.
- EssentialsX money.
- Experience.
- Custom currencies.
The plugin also includes handling for failed transactions and pending item recovery.
If inventory space is not available when items need to be restored, remaining stacks can be safely dropped at the player's feet instead of disappearing.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ AUTOMATIC ITEM RECOVERY
AsterionTrades contains a pending transaction recovery system.
If items need to be restored after an interrupted or failed transaction, the plugin can keep the pending delivery and restore it when possible.
Players can receive a message such as:
Code (Text):
Your pending trade items were restored automatically.
This provides additional protection for valuable trades.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ TRADE REQUESTS
Request behavior is configurable:
Code (YAML):
settings:
request-timeout-seconds : 30
request-cooldown-seconds : 3
countdown-seconds : 3
active-trade-timeout-seconds : 300
input-timeout-seconds : 45
allow-empty-trades : false
- Request spam.
- Permanently pending requests.
- Abandoned active trades.
- Players remaining inside amount input forever.
- Completely empty trades.
Code (Text):
/trade toggle
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ INTERACTION TRADING
Players do not always need to type commands.
Interaction trading can be configured using:
Code (YAML):
settings:
shift-right-click : true
shift-right-click-fallback : true
shift-left-click : false
Code (Text):
Sneak + Right Click another player
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ DISABLED WORLDS
Trading can be completely disabled in selected worlds.
Example:
Code (YAML):
settings:
disabled-worlds :
- world_pvp
- event_world
Code (Text):
asteriontrades.bypass.disabledworld
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ TRADE LOGS
AsterionTrades stores trade history for administration and investigation.
Every transaction receives its own unique Trade ID.
Logs can include information about:
- Trade ID.
- Date and time.
- Trade status.
- Player A.
- Player B.
- Offered items.
- Money.
- Experience.
- Custom currencies.
- Cancelled transactions.
Code (YAML):
settings:
log-cancelled-trades : true
Code (YAML):
logs:
time-zone : America/Argentina/Buenos_Aires
folder : logs
human-readable-file : trades.log
page-size : 8
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ ADMINISTRATIVE TOOLS
AsterionTrades includes dedicated tools for server staff.
/atrade logs [player] [page]
Browse trade history.
Logs can also be filtered by player and displayed using pages.
/atrade view
Open a stored trade by its Trade ID.
/atrade inspect
Inspect a player's active trade.
/atrade copy <a|b|all> [player]
Create an administrative copy of items stored in a logged trade.
This can be useful when investigating reports or restoring items.
/atrade cancel
Force-cancel a player's active trade.
/atrade reload
Reload AsterionTrades configuration.
The administration command also has the alias:
Code (Text):
/asteriontrades
❆ COMMANDS
Code (Text):
/trade
/trade accept
/trade deny
/trade toggle
/trade help
/atrade logs [player] [page]
/atrade view
/atrade copy <a|b|all> [player]
/atrade inspect
/atrade cancel
/atrade reload
/asteriontrades
❆ PERMISSIONS
Player permissions:
Code (Text):
asteriontrades.use
asteriontrades.click
asteriontrades.command
asteriontrades.bypass.disabledworld
Code (Text):
asteriontrades.admin.logs
asteriontrades.admin.view
asteriontrades.admin.copy
asteriontrades.admin.inspect
asteriontrades.admin.cancel
asteriontrades.admin.reload
Code (Text):
asteriontrades.admin
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ FULLY CONFIGURABLE GUI
The trade interface is controlled through:
Code (Text):
plugins/AsterionTrades/gui.yml
- Inventory title.
- Offer slots.
- Divider slots.
- Money position.
- Experience position.
- Custom currency positions.
- Confirmation buttons.
- Materials.
- Display names.
- Lore.
- HEX colors.
- Other player's offer summaries.
Code (YAML):
title : "&8Trading with &b%player%"
size : 54
items:
accept-pending:
material : RED_WOOL
name : "&c&lNOT ACCEPTED"
lore :
- "&7Review the entire offer carefully."
- ""
- "&eClick to accept"
accept-ready:
material : LIME_WOOL
name : "&a&lOFFER ACCEPTED"
lore :
- "&7Your side is confirmed."
- ""
- "&eClick to cancel your acceptance"
accept-locked:
material : LIME_WOOL
name : "&a&lTRADE IN %seconds%s"
lore :
- "&7The offers are locked."
- ""
- "&cClick to cancel the countdown"
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ HEX COLOR SUPPORT
AsterionTrades configurations support colors such as:
Code (Text):
&aGreen
&cRed
&bAqua
HE7FF
&#FFD65A
EF5E5
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ LANGUAGES
AsterionTrades includes 10 languages:
- English
- Spanish
- Portuguese
- French
- German
- Italian
- Russian
- Chinese
- Japanese
- Korean
Code (Text):
en_US
es_ES
pt_BR
fr_FR
de_DE
it_IT
ru_RU
zh_CN
ja_JP
ko_KR
Code (YAML):
language : en_US
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ OPTIONAL INTEGRATIONS
ServerVariables
Can be used as a provider for custom currencies, allowing server-specific balances to be traded directly.
PlaceholderAPI
AsterionTrades includes an optional PlaceholderAPI hook and supports placeholder-based custom economy configurations.
These plugins are optional unless you configure functionality that depends on them.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ REQUIREMENTS
- Java 21
- Minecraft 1.21.x
- Paper / compatible modern server software
- EssentialsX
EssentialsX is required by the plugin and provides the built-in money economy.
ServerVariables and PlaceholderAPI are optional integrations.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ INSTALLATION
- Install EssentialsX.
- Download AsterionTrades.
- Place the JAR inside your server's plugins folder.
- Start or restart the server.
- Configure config.yml.
- Customize gui.yml if desired.
- Select or edit your language file.
- Install ServerVariables or PlaceholderAPI if you want to use their integrations.
Code (Text):
/atrade reload
Do not use PlugMan or similar plugin managers to replace the plugin while the server is running.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❆ TRADE SAFELY. TRADE EVERYTHING. ❆
Items, money, experience and custom currencies combined into one secure trading system.
AsterionTrades | Advanced Trading System | Items, Money, XP & Multi-Economy is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1, 26.2. Downloaded 4 times (via Spigot). Download it and open it directly in the game.