EconomyCraft

A server-side economy for Fabric and NeoForge.

Add-On: EconomyCraft Bounties

The /eco menu

Each screen also has a command: /bal, /pay, /daily, /shop, /ah, /auction, /sell, /worth, /orders, /deliveries, /transactions.

Money amounts accept shorthand in commands and menus: 500, 1.5k, 20M, 3B, 2T, 2.5Qa, 1Qi.

The Admin (/eco admin) menu

Shop editor

Browse categories and click an item to edit it.

• Category editor: right-click a category to rename it, change its color, icon or visibility, or exclude it from dynamic pricing. Deleting a category moves its items to misc and zeroes their buy prices.
• Add item: pick any item in the game, or one from your inventory. Custom names, enchantments and container contents are kept.
• Buy Price / Sell Price: the price of one item; 0 disables that direction. If dynamic pricing applies, this also shows the current price and multiplier.
• Dynamic Pricing: opt this item out of dynamic pricing even while it's enabled server-wide.
• Bulk Amount: how many a shift-click buys or sells.
• Category: which shop page the item appears on. blocks.wood creates a sub-page.
• Remove: takes the item out of the shop. Its price is kept.
• Removed items: every removed item. Click one to put it back with its old price. Adding a removed item through Add item does the same.

Dynamic shop pricing

Optional, off by default (dynamic_prices.enabled). Scales every buy price by:

current price = base price × active-player median balance / starting balance

The scale is clamped between dynamic_prices.min_multiplier and dynamic_prices.max_multiplier, and recalculated every dynamic_prices.update_minutes (default once an hour). Sell prices are never affected. Opt out per category or item from the Shop editor above.

Settings

Every option in config.json, editable in-game and grouped into the same categories as the file.

Players

Select any player, online or not, to give, take or set their balance, remove them from the economy, or override their max active orders/auctions.

Reset Tools

Only the two shop tools touch shop prices/categories. None of them touch permission settings.

Admin commands

/eco addmoney, /eco setmoney, /eco removemoney, /eco removeplayer.

Permissions

Admin and command access is gated by permission nodes. Any admin node not set by a permission plugin falls back to OP; any command node not set falls back to allowed for everyone.

Admin nodes

Command nodes

Config files

Stored in config/economycraft/ on a server (or saves/<world>/economycraft/ per-world in singleplayer): config.json, webhook.json and prices.json at the top, player data under data/.

config.json

webhook.json

prices.json

One entry per shop item, keyed by item id:

{
  "minecraft:diamond": {
    "category": "ores",
    "stack": 64,
    "unit_buy": 800,
    "unit_sell": 200
  }
}

category accepts top.sub for a sub-page, stack is the shift-click bulk amount, and unit_buy/unit_sell are the price of one item (0 disables that direction). Items from installed mods are added automatically, using their mod ID as category and 0 for both prices.

The editor also writes a few extra keys:

• components: NBT for custom items (name, enchantments, container contents). A #label suffix distinguishes duplicates of the same item, e.g. minecraft:shulker_box#loot_rare.
• "removed": true: takes the item out of the shop but keeps its other keys, so it can be put back from Removed items. Delete the removed key to put it back.
• "dynamic_price_enabled": false: opts an item, or a category under _categories, out of dynamic pricing.

Placeholders

Exposes economy data to other mods via Text Placeholder API (Fabric) or Placeholder API NeoForge (NeoForge). Both are optional, the mod works without them, but the matching jar must be in mods/ for placeholders to resolve.

Ranks beyond the number of players resolve as invalid.

Transaction logs and webhook

Every balance change is logged to logs/transactions-YYYY-MM-DD.log inside the config folder, and kept for transaction_log.retention_days days (default 7). Setting it above 90 logs a console warning on start.

Enable webhook_enabled in webhook.json to also POST each transaction to a Discord-compatible webhook; use webhook_min_amount to only notify on larger transactions.

Developer API

The normal EconomyCraft jar includes API v1 for other server-side mods, no separate runtime API mod to install. Covers balances and payments, money formatting, read-only item prices, leaderboard data and balance-change events. Public classes are under com.reazip.economycraft.api.v1.

See the Developer API wiki for setup, examples and the complete reference.