Skip to content

Let's Get Started!

sstepan9 edited this page Apr 9, 2026 · 5 revisions

Easy Trading Wiki

Before using the mod, make sure you have turned off Menu Blur in the game settings! (NeoForge and Fabric only)

Easy Trading is a lightweight economy mod/plugin for your server. It adds a virtual currency, a player-to-player marketplace, a server-side bank, and money transfers between players.


Key Features

  • Balance — every player has a personal account stored on the server, persistent between sessions.
  • Market — a trading board where players list items for sale and buy from each other.
  • Bank — a server-side shop with fixed prices for selected resources and daily limits.
  • Transfers — send money directly to another player.
  • Balance HUD — a yellow BossBar at the top of the screen, which can be hidden or shown.

Getting Started

When you first join the server, your balance is 0.

How to earn your first money:

  1. Gather resources (coal, iron, diamonds, etc.)
  2. Sell them to the bank using /market sellto <amount>
  3. Or list items on the market using /market sell <price>

How to check your balance:

  • Look at the yellow BossBar at the top of the screen (Balance: ...)
  • Or type /market balance

Market (Player-to-Player Trading)

The market is a shared trading platform. Any player can list an item for sale, and any other player can buy it.

Open the Market

/market A chest-style GUI opens with all listed items. Each item's tooltip shows the price, average price per unit, and the seller's name.

Market navigation:

  • Left arrow (slot 1 of the bottom row) — previous page
  • Right arrow (slot 9 of the bottom row) — next page
  • Paper in the middle — current page and total listings count
  • Gold ingot — bank exchange rates

To buy an item — simply click on it. If you have enough balance, the item will be added to your inventory.

List an Item for Sale

/market sell <price>

  1. Hold the item in your main hand
  2. Enter the command, for example: /market sell 100
  3. A confirmation screen opens — click the green block (confirm) or red block (cancel)
  4. After confirming, the item is removed from your hand and listed on the market

Market restrictions:

  • Price must be within the server-configured min/max range
  • There is a cap on the number of active listings per player
  • A listing fee may apply
  • Resources traded through the bank cannot be listed on the market

When someone buys your item, the money is automatically credited to your balance (minus any applicable fee).


Bank (Server-Side Trading)

The bank is a built-in server shop that buys and sells specific resources at fixed prices. Each player has daily limits on transactions.

Supported resources (default): coal, redstone, lapis, copper, iron, gold, diamond, emerald, netherite

Bank tax: 12% by default (configurable by admins).

Sell a Resource to the Bank

/market sellto <amount>

  1. Hold the resource in your main hand (e.g. 64 diamonds)
  2. Enter the command: /market sellto 64
  3. A confirmation screen opens showing the price
  4. Confirm — the resources are taken and money is credited

If you request more than you hold or more than your daily limit allows, the system automatically reduces the amount to the maximum allowed.

Buy a Resource from the Bank

/market buyfrom <resource> <amount>

Examples: /market buyfrom diamond 10 /market buyfrom iron_ingot 32 /market buyfrom gold_ingot 16

  1. Enter the command with the resource name and amount
  2. A confirmation screen opens showing the total cost
  3. Confirm — money is deducted and resources appear in your inventory

Bank restrictions:

  • Each resource has a daily sell and buy limit
  • Limits reset automatically every day
  • Prices may vary depending on the bank's stock
  • A tax is applied to purchases (configurable)

View Bank Exchange Rates

Open the market (/market) and click the gold ingot in the bottom row. It shows the current tax rate and buy/sell prices for each resource.

View Remaining Daily Limits

/market limits Shows how many units of each resource you have already sold/bought today and how much remains before the daily cap.


Money Transfers

You can send money directly to another player: /market send <player> <amount> Example: /market send Steve 500 — send 500 coins to Steve

Transfer rules:

  • The recipient must be online
  • You cannot send money to yourself
  • You must have sufficient balance
  • Both players receive a notification
  • The transfer is recorded in the transaction history

Transaction History

/market history Shows the last 10 transactions. The following are recorded:

  • Market purchases and sales
  • Bank transactions
  • Money transfers to other players

Each entry contains the operation type, item, amount, and counterparty.


Notifications

When joining the server, you may receive a notification:

"New items appeared on the market."

This means someone listed new items while you were offline. Open /market and see what's new!


Commands

Player Commands

Command Description
/market Open the market (GUI)
/market help Show help (also opens in-game help UI)
/market sell <price> List the item in your hand on the market
/market sellto <amount> Sell the resource in your hand to the bank
/market buyfrom <resource> <amount> Buy a resource from the bank
/market send <player> <amount> Send money to a player
/market balance Show your balance
/market team Show your team's balance
/market history Transaction history (last 10)
/market limits Today's remaining bank limits
/market hide Hide the balance BossBar
/market show Show the balance BossBar

Admin / OP Commands

Command Description
/market bankreload Reload bank rates/config
/market clearlimits Reset all players' daily limits
/market change <percent> Set bank tax percent (0–100%)
/market add <player> <amount> Add money to a player
/market take <player> <amount> Take money from a player
/market team <team name> Show the balance of any team
/checkbalance <player> Check another player's balance

Configuration

The mod is fully configurable to suit your server's economy:

  • config/easytrading-market.json — market settings: listing fees, listing caps, min/max price.
  • config/easytrading-bank.json — bank settings: elasticity, stock recovery, daily limits, trade rules and rates.

Safety & Quality of Life

  • Confirmations for all risky actions (listing items, bank transactions)
  • Inventory space checks on purchases — items are never lost to a full inventory
  • Automatic timeout for pending confirmations — prevents stuck dialogs and spam
  • Transfer logging to a server log file for moderation and auditing
  • Transaction history so players can track their own activity

FAQ

Q: Why can't I sell diamonds using /market sell? A: Resources available at the bank can only be sold via /market sellto. This is intentional to maintain economy balance.

Q: Why does it say "Daily sell limit reached"? A: Every day there is a cap on how many resources you can buy/sell at the bank. Wait until the next day or use the market to trade with other players.

Q: How do I find out which resources the bank accepts? A: Open the market (/market) → click the gold ingot → view the resource list with prices. Or type /market limits.

Q: Where is my money stored? A: Your balance is stored on the server. It is tied to your account and persists between sessions.

Q: I accidentally listed an item for sale. How do I remove it? A: Contact a server administrator.

Q: How do I hide the yellow bar at the top? A: Type /market hide. To bring it back: /market show.

Q: What is the "fee" when selling? A: The server sets a tax percentage on bank transactions. The current rate is shown in the bank rates menu (gold ingot in the market).

Clone this wiki locally