For the complete documentation index, see llms.txt. This page is also available as Markdown.

🖱️Command & Permissions

Commands

Command
Parameters
Permission
Capabilities

/balance

[player] [currency]

networkeconomy.balance

Show your own balance, or another player's. Aliases: /bal, /money

/pay

<player> <amount> [currency]

networkeconomy.pay

Atomically send money to another player, on any server

/baltop

[page] [currency]

networkeconomy.baltop

Richest accounts across the whole network. Aliases: /balancetop, /topbalance

/eco

<give|take|set|reset> <player> [amount] [currency]

networkeconomy.admin

Administrative balance management. Aliases: /economy, /neco

/transactions

[player]

networkeconomy.history

Open the transaction history GUI. Aliases: /history, /thistory

Permissions

Permission
Default
Capabilities

networkeconomy.balance

true

View your own balance

networkeconomy.balance.others

op

View other players' balances with /balance <player>

networkeconomy.pay

true

Send money with /pay

networkeconomy.baltop

true

View the network balance top

networkeconomy.history

true

Open your own transaction history

networkeconomy.admin

op

/eco, and viewing another player's history with /transactions <player>

Amount formats

Wherever an amount is accepted, these forms all work:

Input
Value

250

250

19.99

19.99

1,500

1500 — commas are ignored

1.5k

1,500

10m

10,000,000

2b

2,000,000,000

Only strictly positive amounts are accepted; 0, negatives and unparseable input are rejected with the invalid-amount message. The parsed value is then rounded half-up to the currency's decimals.

/balance

The first argument is treated as a currency if it matches a currency id and it is the only argument; otherwise it is treated as a player name. Offline players are resolved from the accounts table, so you can look up anyone who has ever joined the network — not just players on your server.

/balance <player> requires networkeconomy.balance.others.

/pay

The transfer runs as one database transaction: either both sides apply or neither does. It works regardless of which server the recipient is on, or whether they are online at all. If the recipient happens to be online on your server they receive the pay-received message immediately.

Behaviour is shaped by the commands.pay config section:

  • minimum-amount — amounts below this are rejected.

  • deny-self — paying yourself is blocked.

  • tax-percent — a percentage is taken off the amount the receiver gets.

A currency with payable: false cannot be sent, and is not offered in tab completion.

With a tax configured, the sender is debited the full amount and the receiver credited the net; the difference is removed from circulation. This split is what makes a taxed /pay two operations rather than one atomic transfer.

/baltop

The ranking is computed from the shared database, so it covers the entire network. Pages are cached for commands.baltop.cache-seconds (default 60) to keep repeated use from hammering the database, which means a very recent transaction may take up to that long to move someone in the list.

Players with no known name are shown by the first 8 characters of their UUID.

/eco

Action
Effect

give

Atomically adds the amount

take

Atomically removes the amount, failing if the funds are not there

set

Overwrites the balance to an absolute value

reset

Restores the currency's starting-balance. Takes no amount argument

All four work on offline players and log the acting staff member in the transaction's reason (admin:<name>), so admin adjustments are permanently attributable in the audit log. take reports insufficient funds rather than pushing a balance negative.

Note the argument positions: reset has no amount, so its optional currency is the third argument (/eco reset Notch gems) while the others take it fourth (/eco give Notch 10 gems).

/transactions

Opens a paginated GUI of the audit log, newest first. Each item is coloured by type:

Type
Item
Meaning

DEPOSIT / TRANSFER_IN

Emerald

Money came in

WITHDRAW / TRANSFER_OUT

Redstone

Money went out

SET

Paper

Balance overwritten by an admin

RESET

Barrier

Balance reset to the starting amount

Every entry shows the type, the resulting balance, the counterparty (for transfers), the reason, which server the change happened on, and the timestamp. Arrows in the bottom row page back and forward; the book in the middle shows the current page.

/transactions <player> requires networkeconomy.admin and works for offline players.

Last updated