EconMC (Econ: Market and Commerce) is a secure, multiplayer-safe server economy and auction system designed specifically for servers and SMPs.

All transactions are server-authoritative, NBT-accurate, and built to prevent duplication exploits. Perfect for survival, RPG, factions, progression-based, and economy-based servers.

 

This mod requires Modular Toasts API to work!

Core Features

Multiplayer Auction House

Customizable Server Shop

Server-Side Saved Currency

Cross-Session Persistence

What is Econ: Market and Commerce?

EconMC is a powerful, server-authoritative economy and auction system designed to bring the kind of polished shops and player markets seen on popular vanilla servers into your own world or modpack. It recreates the familiar experience of server shops, player-run auctions, balance leaderboards, and redeemable currency, but with full NBT accuracy, multiplayer safety, and support for modded items.

Whether you're building a survival economy, an RPG progression world, or a competitive faction server, Econ makes it easy to customize pricing, stock limits, buy/sell rules, and rewards so the economy fits your server’s vision perfectly.

Auction House

Player-to-player trading with full security.

List items with custom prices

Exact NBT matching (enchants, custom names, modded data)

Expiration system

Mailbox overflow protection

Cancel your own listings

Admin force-cancel support

Fully multiplayer-safe

Pagination for large markets

Server Shop

Admin-controlled buy/sell economy.

Server buys & sells items from and to players

Configurable stock limits

Restock cooldown system

Optional inventory scan mode (bulk selling)

Separate Buy / Sell tabs

Page navigation

As of v1.0.6 this is what the GUI looks like

Added Bids and Orders tab, along with scaling down entries to view more at a time

As of v1.0.8 there's group balances! /bal group

Share balances with your group and Officers+ will be able to spend it in the /shop!

Mailbox System

If auctions expire, your inventory is full, or there's a connection error, the mailbox system comes into place, you can simply reclaim items in your mailbox whenever you want:

Never lose items or money.

Offline-safe delivery

Overflow protection

Claim system

Works across sessions

Voucher System

Physical currency items.

Admins can generate vouchers

Right-click to redeem

Fully server-authoritative validation

Safe amount caps

Perfect for:

Mob drops

Crates

Events

Rewards

Quest systems

Player Balance

Balance (the amount of money $ a player has) is automatically saved. You can use your balance in the auction or server shop, you can earn by selling or through vouchers, and you can check it with /bal (or /baltop for the top 10 leaderboard)

 

 

Commands

EconMC can be used almost entirely through the /shop GUI, but it also includes a full set of player and admin commands for economy management, auctions, market bids, orders, mail, and server shop setup.

Player Commands

Economy

/bal
View your current balance.

/bal group

Open the Group UI to make a group or join one

/baltop
View the top 10 richest players on the server.

/pay <player> <amount>
Send money to another player.

Example:
/pay Steve 500

Shop & Market

Open the Main Shop

/shop
Opens the full EconMC shop interface.

This includes:

• Auction House
• Server Shop
• Market Orders
• Market Bids
• Mailbox status
• Time format syncing for auction timers

Quick Sell to Server

/shop sell <qty>
Instantly sells the item in your main hand to the Server Shop, if that exact item is configured as buyable by the server.

Example:
/shop sell 32

Auction House Commands

Create an Auction Listing

/ah <qty> <price>
Lists the item in your main hand for 60 minutes by default.

/ah <qty> <price> <duration> <minutes|hours|days>
Lists the item in your main hand for a custom duration.

/ah <qty> <price> <duration> <minutes|hours|days> scan
Lists matching items from your inventory instead of only using the current main-hand stack.

Examples:
/ah 16 5000
/ah 16 5000 30 minutes
/ah 64 12000 12 hours
/ah 128 25000 7 days scan

Auction max duration: 90 days

View Active Auctions

/shop au_list
Shows current active Auction House listings.

Buy an Auction

/shop au_buy <id>
Purchases an auction listing by its ID.

Example:
/shop au_buy 42

Cancel Your Auction

/shop au_cancel <id>
Cancels your active listing and sends the item to your mailbox.

View Your Active Listings

/shop my_listings
Shows your currently active auction listings.

Auction Time Display Format

/shop format time short
/shop format time decimal
/shop format time long

Lets each player choose how auction time is displayed in the GUI.

Market Order Commands

Create a Buy Order

/order <item> <amount> <price>
Creates a market order for a specific item.

• item = item ID
• amount = quantity requested
• price = total price offered

Example:
/order minecraft:diamond 16 5000

This reserves the money immediately when the order is created.

Market Bid Commands

Create a Bid Listing

/bid <amount> <startingPrice>
Creates a bid listing using the item in your main hand with the default configured duration.

/bid <amount> <startingPrice> <duration> <minutes|hours|days>
Creates a bid listing with a custom duration.

Examples:
/bid 16 500
/bid 16 500 30 minutes
/bid 16 500 12 hours
/bid 16 500 7 days

• amount = quantity from your main hand
• startingPrice = opening bid price

Bid max duration: 7 days

Mailbox Commands

Claim Mail

/mail claim
Claims all items currently in your mailbox.

If your inventory is full, remaining items are dropped at your feet.

This is used for:

• Expired auction returns
• Cancelled listing returns
• Admin-cancelled auction returns
• Other undelivered item transfers

Admin Commands

All admin commands require permission level 2 (OP).

Economy Admin Commands

/eco set <player> <amount>
Set a player’s balance exactly.

Example:
/eco set Steve 10000

/eco give <player> <amount>
Adds money to a player’s balance.

Example:
/eco give Steve 2500

/eco take <player> <amount>
Removes money from a player’s balance. Balance cannot go below 0.

Example:
/eco take Steve 500

/eco reset <player>
Resets a player’s balance to 0.

Example:
/eco reset Steve

/eco voucher <amount>
Creates a redeemable money voucher item.

Example:
/eco voucher 10000

/payall <amount>
Pays all online players the specified amount.

Example:
/payall 1000

Admin Server Shop Commands

Make Server Buy an Item

/admin shop buy <price>
The server will buy the exact item in your main hand for the specified price.

Example:
/admin shop buy 250

Make Server Sell an Item

/admin shop sell <price> <stock> <cooldownMinutes>
The server will sell the exact item in your main hand with limited stock and automatic restocking.

• price = price per item
• stock = max server-wide stock
• cooldownMinutes = restock interval

Example:
/admin shop sell 500 100 30

This creates a dynamic stock-based shop entry.
Stock is server-wide, not per player.

Unlimited Stock Server Sell Entry

/admin shop sell <price> <stock> <cooldownMinutes> unlimited
Creates a sell entry with unlimited stock.

Example:
/admin shop sell 500 100 30 unlimited

Remove Server Buy Entry

/admin shop remove_buy
Stops the server from buying the item in your main hand.

Remove Server Sell Entry

/admin shop remove_sell
Removes the server sell entry for the item in your main hand.

Admin Auction Moderation

Force Cancel Any Auction

/admin auction cancel <id>
Cancels any active auction listing by ID and safely returns the item to the seller’s mailbox.

Example:
/admin auction cancel 42

Useful for:

• Removing illegal items
• Fixing broken or abusive listings
• Moderating pricing abuse
• Cleaning up unwanted listings

API Integration

EconMC API Integration (Forge 1.20.1)

EconMC exposes a simple server-side API so other mods can safely interact with player money and open EconMC menus directly. Everything is server-authoritative, persistent, and automatically syncs the client balance display when needed.

 

If you need it, get the dev version from github!

How to use

Add EconMC as a dependency in your dev environment, then call:

import com.fishguy129.econmc.api.EconMCApi;
import com.fishguy129.econmc.api.EconMCMenuApi;

// add money
EconMCApi.addBalance(player, 250);

// set money
EconMCApi.setBalance(player, 10000);

// charge money (returns false if insufficient)
boolean paid = EconMCApi.trySubtract(player, 500);

// open the main EconMC shop GUI directly
EconMCMenuApi.openShop(player);

// open the group control GUI directly
EconMCMenuApi.openGroupMenu(player);

There are also UUID and server overloads:

EconMCApi.addBalance(server, playerUuid, 250);
long bal = EconMCApi.getBalance(server, playerUuid);

Rules / Notes

Call from the server thread. Commands and most normal gameplay hooks already run there. If you are in async logic, wrap it like this:

server.execute(() -> EconMCApi.addBalance(server, uuid, amount));

Balances are stored in SavedData, so they persist across restarts.

Money API calls automatically sync the player’s client-side displayed balance if they are online.

Uses long currency values.

Direct menu opening is useful for custom NPCs, villagers, blocks, or other integrations, so you do not need to rely on player commands to access EconMC menus.

Command access can also be controlled through the config, allowing server owners to disable player command usage and route access entirely through custom interactions.

Custom Currency Support

EconMC now supports configurable currency branding through the common config file.

Server owners can define:
- currency display name
- currency symbol
- currency icon item shown in the GUI

Example config values:

[currency]
name = "fala"
symbol = "F"
iconItem = "minecraft:emerald"

This makes it easy to theme the economy around your server without editing code.

Optional dependency

If you want your mod to work without requiring EconMC to always be installed, you can reflection-call the API by class name:

com.fishguy129.econmc.api.EconMCApi
com.fishguy129.econmc.api.EconMCMenuApi

FAQ

Does EconMC work on multiplayer servers?

Yes. EconMC is fully server-authoritative and designed specifically for multiplayer environments. All balances, shop data, and auctions are stored server-side. It is worth mentioning it can also be used fully offline, for example, in a roleplaying let's-play world.

Is player money stored safely?

Yes. Player balances are saved using persistent world data and automatically load with your server world.

What happens if a player buys an item but their inventory is full?

The item is safely sent to their mailbox.
Nothing is ever lost.

What happens if the server crashes mid-transaction?

Transactions are handled server-side before confirmation. Items and balances are processed in a safe order to prevent loss or duplication.

Can players exploit vouchers?

Vouchers are server-generated and redeemed server-side. They can include additional security measures depending on how strict you want your economy to be.

Can monsters or other mods reward money?

Yes. You can:

Drop voucher items from mobs

Use /money give in command blocks

Integrate through server-side scripting or datapacks

Can I customize shop items easily?

Yes.
Server Shop items are defined directly using the item in your main hand, meaning:

Enchantments

NBT data

Custom names

Modded items

All are fully supported.

Does this replace Vault or other economy APIs?

EconMC is a standalone economy system. It does not require external plugins or APIs to function.

Does it work with modpacks?

Yes.
As long as the mod is installed on both client and server (if required), it works with modpacks and modded items.

Can admins moderate auctions?

Yes. Admins can force-cancel listings at any time and return items to sellers safely.

Is the GUI customizable?

The current GUI is clean and optimized for servers. Future updates may allow texture customization or theme packs.

What does "EconMC" mean?

EconMC stands for "Economy: Market and Commerce"

Check out my Patreon!

Even if you can't donate, simply subscribing to the free tier is tremendous support :)

Patreon