EconomyCraft

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

Setup

1. Put the jar in your server's mods folder and start the server.
2. Type /eco in game to open the menu.
3. Operators get an Admin button in that menu, or can run /eco admin.

Default configuration works without manual changes.

The /eco menu

Each screen also has a command: /bal, /bal top, /pay, /daily, /shop, /servershop, /sell, /worth, /orders, /orders claim.

The Admin menu

Server Shop editor

Browse categories and click an item to change it.

• Category editor — right-click a category to change its displayed name, color, icon, or visibility. Deleting a category moves all of its items to misc and sets their buy prices to 0.
• Add item — select any item in the game or one from the inventory. Custom names, enchantments and container contents are stored with the entry.
• Buy Price / Sell Price — the price of one item. 0 disables that direction.
• Bulk Amount — how many a shift-click buys or sells.
• Category — which page of the shop the item appears on. blocks.wood creates a sub-page.
• Delete — removes the entry.

Settings

Covers every option in config.json: starting balance, daily reward, daily sell limit, tax rate, PvP money loss, thousands separator, and switches for the server shop, player shop, orders, selling, the balance sidebar and the short command aliases.

Players

Select any player, online or not, to give, take or set their balance, or remove them from the economy.

Admin commands

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

Config files

On a server, config and player data are stored in config/economycraft/: config.json and prices.json at the top, balances, shops, orders and deliveries under data/.

In singleplayer each world gets that same folder inside its own save, at saves/<world>/economycraft/.

config.json

prices.json

One entry per server 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. unit_buy and unit_sell are the price of one item, and 0 disables that direction.

Two further keys are written by the editor:

• components holds NBT for custom items such as a name, enchantments or shulker contents. JSON keys must be unique, so a second variant of the same item takes a #label suffix, e.g.: minecraft:shulker_box#loot_rare. The suffix is stripped on load and is not shown to players.
• "removed": true marks a bundled default that was deleted, so it is not restored on the next start. Delete the entry to restore it.

Placeholders

EconomyCraft can expose economy data to other mods through Text Placeholder API on Fabric, or the unofficial Placeholder API NeoForge port on NeoForge.

Both are optional and not bundled. The mod works without them, but the matching jar for your version and loader must be in the server's mods folder for these placeholders to resolve.

The top_* placeholders take the rank as an argument, e.g. %economycraft:top_name 3% for third place. Ranks beyond the number of players resolve as invalid.