Treasury#

Treasury is the server's money system — the official record of every balance and every transaction. When you pay someone, earn a salary, sell at a shop, or owe a fine, Treasury is what moves the money and writes it down. It's the foundation the rest of the economy is built on, and it's the data this Explorer reads.

Made by Paradaux, built in-house for the Minecraft Cities Network (DemocracyCraft & StateCraft) as the single, trustworthy ledger for the whole economy.

The commands below cover checking balances, paying people, reviewing your history, and — if you're in government — managing department accounts and fines.

Everyday commands#

Everyone can use these.

/pay <player> <amount>#

Send money to another player.

/pay Steve 250

Argument	Required	What it is
player	yes	Who you're paying
amount	yes	How much (more than 0)

You can also pay a government account by its name instead of a player.

/pay-account <type> <name|id> <amount> [memo]#

Pay an explicitly-typed account. Where /pay guesses (and resolves a government account ahead of a same-named player), /pay-account lets you say exactly which kind of account you mean — handy for paying a business, or an account by its numeric ID. Also answers to /paya.

/pay-account business Acme 500 invoice
/pay-account account 42 100

Argument	Required	What it is
type	yes	player, business, government, or account (by ID)
name|id	yes	The account's name, or its numeric ID for account
amount	yes	How much (more than 0)
memo	no	A note recorded on the transaction

/bal [player]#

Check a balance. With no name, it shows yours. Also answers to /balance and /money.

/bal
/bal Steve

Argument	Required	What it is
player	no	Whose balance to check (defaults to you)

/baltop [page]#

See the richest players on the server, ten per page.

/baltop
/baltop 2

Argument	Required	What it is
page	no	Which page to view (defaults to 1)

/economy#

Show server-wide money statistics — the total money supply and related totals across the economy. Read-only; it just reports the numbers, it doesn't move any money.

/economy

/transactions [page]#

Your money history — what came in, what went out, and why. Also answers to /txns.

/transactions
/transactions 3

Argument	Required	What it is
page	no	Which page to view (defaults to 1)

Need it as a file? Export a copy:

/transactions export

Staff: auditing other people's history#

Staff can look up anyone's transaction history, by player or by account ID.

/transactions audit Steve
/transactions audit Steve 2
/transactions auditaccount 42
/transactions auditaccount 42 3

Command	What it does
/transactions audit <player> [page]	View any player's history
/transactions auditaccount <accountId> [page]	View any account's history by its numeric ID

/sales [page|summary [days]]#

Your own ChestShop sales — what sold (or what you bought) through shops you own, drawn from Treasury's sale tracker. You only ever see your own sales.

/sales
/sales 2
/sales summary
/sales summary 7

Argument	Required	What it is
page	no	Which page of your recent sales to view (defaults to 1)
summary [days]	no	An aggregated report (totals, sold vs. bought, top items) over the last days (defaults to 30)

Each line shows the time, whether you Sold or Bought, the quantity and item, the customer, and the total and tax. The summary rolls those up into sale counts, units, volume, and your top items for the window.

Government accounts#

Government departments share accounts that several people can use. You can only see and use an account if you've been added to it. Three levels of access:

• Viewers can view the account — its balance and transaction history — but cannot spend or manage access.
• Members can view the account and its history and spend from it (pay/payout).
• Authorizers can spend and, with treasury.gov.account.manage, manage viewers/members. Adding/removing authorizers requires treasury.gov.admin.

All of these live under /government (also /gov).

/government account list#

List the government accounts you can see, with balances.

/government account list

/government account balance <name>#

Show one account's balance.

/government account balance Treasury

Argument	Required	What it is
name	yes	The account's name

/government account history <name> [page]#

Review an account's transaction history.

/government account history Treasury
/government account history Treasury 2

Argument	Required	What it is
name	yes	The account's name
page	no	Which page to view (defaults to 1)

/government account transfer <from> <to> <amount> [reason]#

Move money between two government accounts. /government pay … is an alias for the same command.

/government account transfer Treasury Roads 10000 Q3 budget
/government pay Treasury Roads 10000 Q3 budget

Argument	Required	What it is
from	yes	Account to take money from
to	yes	Account to send money to
amount	yes	How much (more than 0)
reason	no	A note saved with the transfer

/government payout <from> <to> <amount> [reason]#

Pay a player or a business out of a government account — grants, contracts, salaries.

/government payout Roads Steve 1500 paving contract

Argument	Required	What it is
from	yes	Government account to pay from
to	yes	A player name or a business account
amount	yes	How much (more than 0)
reason	no	A note saved with the payment

/government payout-account <from> <id> <amount> [reason]#

Pay an account by its numeric Treasury account ID. The recipient can be PERSONAL, BUSINESS, GOVERNMENT or SYSTEM. The source is a government account name, with the same spending permissions as /government payout. Missing, archived and same-source targets are rejected. Personal account owners receive the usual payout notification when online.

/government payout-account Police 123 250 approved reimbursement

Managing who has access#

Add or remove the people who can use an account. Viewers can only look; members can view and spend; authorizers need additional command permissions to manage access. (An authorizer must be a member first.)

/government account viewer add Treasury Steve
/government account viewer list Treasury
/government account member add Treasury Steve
/government account member list Treasury
/government account auth add Treasury Steve
/government account auth list Treasury

Use remove in place of add to revoke access. Managing viewers and members needs account management rights (treasury.gov.account.manage); managing authorizers is operator-level (treasury.gov.admin).

You can also grant access to a whole LuckPerms group at once, rather than naming players one by one:

/government account viewer addgroup Treasury treasury-observers
/government account viewer removegroup Treasury treasury-observers
/government account member addgroup Treasury treasury-staff
/government account member removegroup Treasury treasury-staff
/government account auth addgroup Treasury treasury-admins
/government account auth removegroup Treasury treasury-admins

Creating and retiring accounts#

/government account create Parks
/government account archive Parks

Creating an account may be limited to certain roles, and archiving is admin-only.

Fines#

Government fines are issued and managed with /fine.

/fine issue <account> <player> <amount> <reason>#

Fine a player into a government account. The amount is taken from the player's balance and paid into the named account.

/fine issue Police Steve 500 griefing spawn

Argument	Required	What it is
account	yes	The government account the fine is paid into
player	yes	Who is being fined
amount	yes	How much (more than 0)
reason	yes	Why the fine was issued

You must have access to that account to fine into it — a member or authorizer of it, or an admin. (Same access model as /government pay.)

/fine firm <account> <firm> <amount> <reason>#

The same as /fine issue, but fines a business account instead of a player. The amount is taken from the firm and paid into the named government account.

/fine firm Police Acme 500 illegal dumping

Argument	Required	What it is
account	yes	The government account the fine is paid into
firm	yes	The business being fined
amount	yes	How much (more than 0)
reason	yes	Why the fine was issued

/fine account <account> <id> <amount> <reason>#

Fine a debtor identified by its numeric Treasury account ID, paying into the named government account. Supports PERSONAL, BUSINESS, GOVERNMENT and SYSTEM accounts. Requires treasury.gov.fine plus membership/authorizer access to the receiving government account, or treasury.gov.admin. Fining a SYSTEM account additionally requires treasury.gov.admin, because SYSTEM sources have unlimited funds.

Missing or archived debtors and fines into the debtor's own account are rejected. Personal account fines retain player history and online notifications. /fine revoke <id> refunds the original debtor account.

/fine account Police 123 50 zoning breach

/fine revoke <id> · /fine info <id> · /fine list [player]#

Look up, list, and reverse fines by their ID. Revoking refunds the fine out of the account it was paid into, so you must have access to that account to revoke it.

/fine list
/fine list Steve
/fine info 42
/fine revoke 42

Admin commands#

These are for server operators.

/eco <give|take|set|reset> <target> [amount]#

Adjust a balance directly.

/eco give Steve 1000
/eco take Steve 250
/eco set Steve 0
/eco reset Steve
/eco give DCGovernment 100000

Argument	Required	What it is
action	yes	give, take, set, or reset
target	yes	A player, or a government account name (give/take/set only)
amount	for give/take/set	How much (reset takes none)

/tax <status|trigger> [cycle]#

Inspect and test the automatic tax cycles.

/tax status
/tax trigger weekly

Argument	Required	What it is
action	yes	status, or trigger
cycle	for trigger	daily, weekly, or monthly

/treasury (alias /tr)#

The operator console for the plugin itself — reloading config and low-level account admin.

/treasury reload
/treasury admin ingest <source>
/treasury admin transfer <fromType> <from> <toType> <to> <amount> [reason]
/treasury admin balance <type> <id>
/treasury admin info <type> <id>

Command	What it does
/treasury reload	Reload the config and messages
/treasury admin ingest <source>	Run an ingest from the given source
/treasury admin transfer <fromType> <from> <toType> <to> <amount> [reason]	Move money between any two accounts by type + id/name
/treasury admin balance <type> <id>	Show an account's balance by type + id
/treasury admin info <type> <id>	Show an account's details by type + id

Permission nodes#

The LuckPerms nodes that gate each command, with their plugin.yml defaults (true = everyone, op = operators only, false = nobody until granted). On the government accounts, the viewer/member/authorizer checks apply in addition to these — see Government accounts.

Everyday#

Command	Node	Default
/pay	treasury.pay	true
/bal (your own)	treasury.balance	true
/bal <player> (someone else)	treasury.balance.others	op
/baltop	treasury.baltop	true
/economy	treasury.economy	true
/sales	treasury.sales	true
/transactions	treasury.transactions	true
/transactions export	treasury.transactions.export	true
/transactions audit · auditaccount	treasury.transactions.audit	op

Government accounts & fines#

Command	Node	Default
/government … (base command)	treasury.gov	op
/government account list	treasury.gov.account.list	false
/government account balance · history · member list · auth list	treasury.gov.account.view	false
/government pay · payout	treasury.gov.account.transfer (or be a member/authorizer of the account)	false
/government account member add · remove · addgroup · removegroup	treasury.gov.account.manage (and authorizer access)	false
/government account auth add · remove · addgroup · removegroup	treasury.gov.admin	op
/government account create	treasury.gov.account.create	false
/government account archive	treasury.gov.admin	op
/fine … (base command)	treasury.gov.fine	op
/fine issue · revoke	treasury.gov.fine (plus member/authorizer access to the account, or treasury.gov.admin)	op
/fine list · info	treasury.gov.fine.view (plus treasury.gov.fine to reach the command)	false

Admin#

Command	Node	Default
/eco give · take · set · reset	treasury.eco.give / .take / .set / .reset (base treasury.eco)	op
/tax status · trigger	treasury.admin.tax	op
/treasury … (base command)	treasury.command	true
/treasury reload	treasury.admin.reload	op
/treasury admin transfer	treasury.admin.transfer	op
/treasury admin balance · info	treasury.admin.inspect	op
/treasury admin ingest	treasury.admin.ingest	op