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

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.