Ledger and rollback

With the ledger on — the default — every movement of a stored currency writes a line to exylia_ledger: what moved, what the balance read afterwards, the reason, who caused it, which server applied it and when. That includes changes that arrived from another server and changes made by other plugins.

Item, experience and display-only currencies keep no ledger.

What is written

Consecutive movements of one balance with the same reason, caused by the same player, are one line: an autosell flush is one sale, not a hundred. A movement of zero is not written.

Other Exylia plugins write their own reasons — shop:buy, market:sale, auctions:bid. What a player reads for each reason is the reasons section of messages.yml: the exact reason first, then the part before the colon, then the reason itself with its first letter raised.

Retention

Lines older than the retention set in Economy settings are deleted every hour: 30, 90, 180 or 365 days, or forever. A fresh server keeps 90 days.

Turning the ledger off stops writing new lines. The history screen, /economyadmin log, export and rollback then have nothing new to work with.

Reading it

Somebody else's history needs exyliaeconomy.others. /eadmin log Steve 2 is page 2 of the default currency, not a currency called 2.

Exporting

/economyadmin export <currency|all> [days]

Writes plugins/ExyliaEconomy/exports/ledger-<scope>-<yyyyMMdd-HHmmss>.csv, off the game thread. days keeps only the lines written in the last that many days; 0 or nothing is everything. all includes every currency and every server's per-server lines.

id,time,player,currency,delta,balance_after,reason,initiator,server
1042,2026-10-04T18:22:05+02:00,8667ba71-…,dollars,-105.00,895.00,pay,8667ba71-…,survival-1

Times are ISO dates in the server's zone. A cell starting with =, +, -, @ or a tab is prefixed with ', so a spreadsheet opening the file runs nothing.

Rollback

/economyadmin rollback <player> <window|#id> [currency] [confirm]

Reverts a player's movements in one currency: every line in a window back from now (30m, 1h, 2d), or one line by its id (#42). It always asks first, showing how many movements, the net change and how many transfers were left out; [✔ CONFIRM] runs the same command with confirm within 30 seconds, and reverts exactly the lines that were shown.

Each line is reverted by the opposite movement through the currency, as an admin change with reason rollback:

• a deposit is withdrawn, a withdrawal deposited back;
• each line is claimed first in exylia_economy_claims, kept forever, so no line is ever reverted twice, whoever asks and on whichever server: "Already done: 3";
• a reversal the currency refuses — a withdrawal from somebody who no longer has it — is left as it was and counted as refused, and its claim is given back for a later try;
• on a player who is not on this server, a reversal is queued like any admin change, and a withdrawal floors at zero when it lands.

A window looks at the player's newest 500 lines in that currency. Because consecutive movements with one reason are one line, a line is reverted whole.