Easy Trading

⚠️ The Fabric and NeoForge mod is discontinued as of version 0.9.
Please use Easy Trading Plugin for Paper, Bukkit, Spigot, Purpur, and Folia.

---

Easy Trading

Easy Trading is a lightweight economy plugin for multiplayer Minecraft servers. It is designed to provide a reliable, secure, and server-friendly trading system with a strong focus on usability, administrative control, and abuse prevention.

The plugin includes a complete in-game economy ecosystem consisting of:

• Personal player balances
• A player-driven marketplace
• A server-controlled bank
• A secure player-to-player trading system

Detailed setup and usage instructions are available in the Easy Trading Wiki.

Core Features

• Server-stored personal balances for all players
• Multiple trading methods:
  • Player marketplace
  • Server bank
  • Direct player-to-player trading
• Built-in taxes, limits, and confirmation steps
• Optional balance HUD displayed via BossBar
• Designed for clarity, stability, and anti-abuse protection

Direct Player Trading

Easy Trading includes a secure real-time trading system that allows players to exchange items and currency safely without dropping items on the ground.

How It Works

To initiate a trade:

/market trade <player>

The target player receives interactive Accept and Decline options.
Once accepted, a shared trade interface is opened.

Trade System

• 16 trade slots per player
• Real-time item synchronization
• Money can be added or removed using interface buttons
• Both players must confirm the trade
• A 3-second countdown is started before execution

Safety Mechanisms

Any modification to the trade automatically resets both confirmations.

A trade is cancelled automatically if a player:

• Disconnects
• Dies
• Teleports
• Closes the trade interface

Additional protections include:

• Balance verification at execution time
• No item loss; items are safely dropped if inventory space is insufficient
• Anti-duplication protection through session locking
• Trade requests expire after 60 seconds

Player Marketplace

The marketplace allows players to list and purchase items through a simple GUI-based system.

Commands

Command	Description
/market	Open the marketplace
/market sell <price>	List the item in hand for sale

Features

• Confirmation before listing an item
• Configurable minimum and maximum prices
• Soft and hard listing limits
• Listing fees with base and progressive cost options
• Market updates shown to players after rejoining

Bank (Server Shop)

The bank provides a server-controlled trading system for buying and selling predefined resources.

Commands

Command	Description
/market sellto <amount>	Sell items to the bank
/market buyfrom <resource> <amount>	Buy items from the bank
/market limits	View daily limits

Features

• Daily buy and sell limits per resource
• Configurable tax rate (default: 12%)
• Transactions require sufficient balance and available inventory space

Default Resources

• Coal
• Redstone
• Lapis
• Copper
• Iron
• Gold
• Diamond
• Emerald
• Netherite

Commands

Player Commands

Command	Description
/market	Open the market
/market help	Show help
/market sell <price>	List an item for sale
/market sellto <amount>	Sell to the bank
/market buyfrom <resource> <amount>	Buy from the bank
/market trade <player>	Start a direct trade
/market trade accept	Accept a trade request
/market trade decline	Decline a trade request
/market balance	Show current balance
/market send <player> <amount>	Transfer money to another player
/market team [name]	View team balance
/market history	Show the last 10 transactions
/market limits	View daily limits
/market hide	Hide the HUD
/market show	Show the HUD
/market pur	Create purchasing order
/market purchase	Create purchasing order

Admin Commands

Command	Description
/market bankreload	Reload bank configuration
/market clearlimits	Reset daily limits
/market change <percent>	Set the tax rate
/market add <player> <amount>	Add money to a player
/market take <player> <amount>	Remove money from a player
/checkbalance <player>	Check a player’s balance
/market ads <amount>	Change the amount of promoted lots per player

Configuration

File	Description
easytrading-market.json	Marketplace prices, fees, and limits
easytrading-bank.json	Bank rates, limits, and elasticity settings

Safety and Reliability

Easy Trading is built with stability and protection in mind.

• Confirmation steps for risky actions
• Inventory validation and safe item handling
• Anti-duplication protection
• Timeout handling for pending actions
• Full transaction logging
• Individual player transaction history

Compatibility

• Works without Vault as a soft dependency
• Designed for performance and stability
• Suitable for survival, economy, and political servers

Summary

Easy Trading is a complete economy solution for multiplayer servers. It combines:

• A player marketplace
• A server-controlled bank
• Secure real-time player trading

All features are provided in a single lightweight and practical plugin.

License

This project is licensed under the MIT License.
You may use, modify, and distribute the code in accordance with the terms of that license.