CraftHub
EconomyCraft

EconomyCraft

Fully customizable economy mod for Fabric and NeoForge servers.

32 298 downloads
77 followers

EconomyCraft

A server-side economy for Fabric and NeoForge. Requires Architectury API.

Add-On: EconomyCraft Bounties

The /eco menu

Buttom Description
Shop Buy and sell at fixed prices with unlimited stock. Left click buys, right click sells, shift-click uses the bulk amount.
Auction House Buy items other players have listed, or list your own.
Sell Items Drop items in, check the total, confirm. Unpriced items can not be sold.
Orders Request an item, amount and price. Other players fill it and get paid.
Daily Reward Claims the daily payout, once per day.
Pay a Player Send money to another player.
Leaderboards Top Balances, Earners, Spenders, Sellers, Buyers and Traders.
Item Value The buy and sell price of any item.
Deliveries Items or payouts that couldn't be delivered directly (full inventory/completed while offline).
Transactions Your recent balance history.

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

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.
  • Delete: removes the entry.

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_price_min_multiplier and dynamic_price_max_multiplier, and recalculated at most 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.

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

Tool Does
Reset All Balances Sets every player's balance back to startingBalance.
Reset Daily Reward Data Everyone can claim their daily reward again immediately.
Reset Daily Sell Limits Everyone's daily sell limit resets to full immediately.
Clear Auctions Cancels every active listing. Items are returned to sellers' deliveries.
Clear Orders Cancels every open order. Escrowed money is refunded to requesters.
Reset Entire Economy All of the above, plus wipes the Leaderboards stats and deletes the entire transaction log.

None of these touch shop prices/categories or 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

Node Grants
economycraft.admin Everything below
economycraft.admin.players /eco addmoney, /eco setmoney, /eco removemoney, /eco removeplayer, the Players screen
economycraft.admin.settings The Settings screen
economycraft.admin.shop The Shop editor (from the Admin menu or the in-shop edit button)
economycraft.admin.reload The "Reload from disk" button
economycraft.admin.reset The Reset Tools screen

Command nodes

Node Grants
economycraft.command.menu /eco, /eco menu
economycraft.command.balance /bal
economycraft.command.pay /pay
economycraft.command.shop /shop
economycraft.command.auction /ah, /auction
economycraft.command.sell /sell
economycraft.command.orders /orders
economycraft.command.deliveries /deliveries
economycraft.command.daily /daily
economycraft.command.transactions /transactions
economycraft.command.worth /worth

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

Key Default Description
startingBalance 1000 Money new players start with.
dailyAmount 100 Money given by the daily reward.
dailySellLimit 10000 Most a player can earn per day from selling. 0 disables the limit.
taxRate 0.1 Tax on trades and orders, as a decimal (0.1 = 10%).
standalone_commands true Allow /pay, /daily etc. without the /eco prefix.
standalone_admin_commands false Allow /addmoney, /setmoney etc. without the /eco prefix.
scoreboard_enabled true Show the balance sidebar.
shop_enabled true Enable the fixed-price shop.
auction_enabled true Enable the auction house.
orders_enabled true Enable the orders board. Deliveries still work either way.
sell_enabled true Enable selling.
worth_enabled true Enable item value lookups (/worth).
balance_separator "." Thousands separator, e.g. "," gives $1,000.
transaction_log_enabled true Record every balance change to a daily log file.
transaction_log_retention_days 7 How many days of transaction logs to keep.
order_expiration_hours 168 Hours before an unfulfilled order expires and its escrow is refunded. 0 disables expiration.
auction_expiration_hours 168 Hours before an unsold auction expires and its item goes to deliveries. 0 disables expiration.
max_active_orders_per_player 0 Most open orders a player can have at once. 0 = unlimited. Overridable per player.
max_active_auctions_per_player 0 Most active auctions a player can have at once. 0 = unlimited. Overridable per player.
dynamic_prices_enabled false Scale shop buy prices with the active-player median balance. See Dynamic shop pricing.
dynamic_price_min_multiplier 0.5 Lowest allowed price scale.
dynamic_price_max_multiplier 5.0 Highest allowed price scale.
dynamic_price_min_active_days 30 Players must have logged in within this many days to count as active. 0 includes everyone.

webhook.json

Key Default Description
webhook_enabled false Post transactions to webhook_url.
webhook_url "" Discord-compatible incoming webhook URL.
webhook_min_amount 0 Skip webhook posts for transactions smaller than this.

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: marks a deleted default so it isn't restored on the next start. Delete the entry to restore it.
  • "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.

Placeholder Description
%economycraft:balance% Raw balance, e.g. 1000.
%economycraft:balance_formatted% Formatted balance, e.g. $1.000.
%economycraft:balance_short% Abbreviated balance, e.g. $1.2k.
%economycraft:daily_sell_remaining% How much the player can still earn from selling today. ∞ if unlimited.
%economycraft:top_name <rank>% Name of the player at that rank (1 = richest).
%economycraft:top_balance <rank>% Raw balance at that rank.
%economycraft:top_balance_formatted <rank>% Formatted balance at that rank.
%economycraft:top_balance_short <rank>% Abbreviated balance at that rank.

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.