Tutorial / Admin panels > Utilities
Money Log
Every wallet and bank change with where the money came from, a per-player day summary that makes dupes stand out, money alerts, and rollbacks that undo changes or put a player's money back to a time.
What it does
Money Log records every change of a player's wallet or bank: who, how much, wallet or bank, the balance after, and where the money came from. Pick a day, search, and see at a glance who gained the most and from what.
Use it to find a money dupe or exploit in a day instead of wiping the economy: the day summary puts the biggest gains first with their main source, and money alerts tell admins at once when someone gains a lot in a short time. v3.6.20: roll it back - undo the changes you pick, or put a player's wallet and bank back to what they were at one change - with a preview first and an undo after.
Where to find it
Q menu > KGX's Admin Toolbox > Utilities > Money Log.
Toolbox admins can use it. Players can get it through Settings > Player Access with the Money Log tick. Without access, the panel says "Only admins (or players given access) can see the Money Log." The settings at the bottom are superadmin only.
The panel
| Item | What it does |
|---|---|
| Day | The day to look at (today first). Days older than the kept days are deleted. |
| Player name, SteamID, source or detail... | Shows only changes whose player, SteamID, source or detail contain this text. Press Enter or Search. |
| Source | Only one source (Paycheck, Store, Cash pickup, Admin...). |
| Changes of at least | Hides smaller changes. |
| Changes list | Time, Player, Change (green in, red out), In (Wallet / Bank), After (the balance after), Source, Detail. Newest first, up to 500. |
| Day per player | In, Out, Net and Mostly from for every player that day, biggest gain first. A player who gained more than the alert amount is orange. |
| Money alerts | The day's alerts (red). |
Right-click a line in any list: Show only this player, Copy SteamID, Copy this line, Admin notes....
Under Search (v3.6.21.4.1): | Button | Who | What it does | |---|---|---| | Copy the shown changes to the clipboard | Everyone who can open the Money Log | Copies every change in the list (with the time, player, SteamID, change, wallet or bank, balance after, source, detail and who did it) and the day's alerts, to paste in a text editor or a report. | | Clear the whole Money Log... (superadmins) | Superadmins | Asks first, then deletes every day of the Money Log, what was not written yet, the alerts and every rollback. Balances do not change and new changes are logged again at once. The Action log keeps who cleared it. It cannot be undone. |
Rollbacks (v3.6.20)
Admins who have both the Money Log and the Economy panel get these on a change (right-click): | Option | What it does | |---|---| | Undo this change... / Undo the N selected changes... | Reverses the picked changes: a +5,000 takes 5,000 back, a -500 gives 500 back. Select several with Ctrl or Shift. Changes of several players at once are fine. | | Roll [name] back to right before this change... | That player's wallet and bank get the balance they had just before this change: each goes back to what it was before its first logged change from here on (this one included). | | Roll [name] back to right after this change... | The same, from the next change on (this one stays). |
Each one first opens a preview: every balance with Now, After and Change. Nothing changes until Apply. If a balance changed after the preview (the player earned or spent), Apply is refused: look at it again.
- Nothing ever takes more than a player has: a balance never goes below 0 (the note says "takes only what is there").
- A change that was rolled back cannot be undone a second time (until its rollback is undone). A Rollback line itself is undone in the Rollbacks list, not as a change.
- Picked changes that add up to nothing (+70 and -70) change nothing.
- The money moves show in the log as source Rollback (with the number and the admin) and never raise money alerts. The player sees "An admin corrected your money".
- Offline players: their bank and wallet are changed in the saved accounts; only superadmins may. With DarkRP money an offline player's wallet cannot be changed (the preview says so).
- Online players: the usual rank rule (you cannot change the money of someone above you).
- The treasury (v3.6.20, Settings > Taxes & Treasury) shows as the player Treasury and can be rolled back the same way.
Rollbacks (under the money alerts) lists the last 50 with who did it and what changed. Right-click one: Undo rollback #N changes every balance back (never below 0). Undo the newest first: a rollback cannot be undone while a later one of the same player is still active.
Where the money came from
- Paycheck, Bank interest, Bank deposit / withdraw / transfer (with the other player), Starting money.
- Admin: money given, taken or set by an admin (Economy, Player Manager, the Money tool); the detail names the admin.
- v3.6.20: Income tax, Sales tax, Transfer fee, Property tax (Settings > Taxes & Treasury), Treasury (paid out of the treasury, with the reason), Rollback.
- Dropped cash, Gave money / Given money (with the other player), Death drop.
- Cash pickup: the detail says where that cash came from, for example "money printer of Kris", "death drop of Sam", "dropped by Alex", "robbery by Max", a container or the Money tool.
- Otherwise the part of the toolbox that moved it: Store, Shipments / store boxes, Property, Money printers, Logic, Talking NPC, Vehicle pads, Police and crime, Robbery, Player Loadouts, Mail... with the file and line in the detail.
- Other: ...: another addon that used the toolbox's money functions (its file).
- DarkRP: with DarkRP money, DarkRP's own wallet changes.
How to use it
Find a dupe
- Open Utilities > Money Log and pick the day.
- Look at Day per player: the top lines gained the most. Orange lines passed the alert amount.
- Right-click a suspicious player and pick Show only. The changes list shows each change and its source.
- A lot of Cash pickup from the same origin, or the same store sale again and again in seconds, points at the exploit.
Undo a dupe
- Find the player and their duped changes (see above). Use Source and Changes of at least to list only those.
- Select the duped lines (Ctrl + click), right-click > Undo the N selected changes....
- Check the preview and press Apply. Rollbacks lists it; undo it there if it was wrong.
Or right-click the first bad change > Roll [name] back to right before this change... to put both their wallet and bank back to that moment.
Get alerts
- As a superadmin, set Alert: a player gaining at least (for example 50,000) and ... within minutes (for example 10), and click Apply the numbers above.
- When a player gains that much in that time, every admin with access gets "Money alert: ..." on screen, and the alert is kept in the log.
Settings and commands
| Setting or command | What it does | Default | Range |
|---|---|---|---|
kgxat_moneylog |
1 = every money change is logged. | 1 | 0-1 |
kgxat_moneylog_days |
Days kept (older days are deleted). | 14 | 1-90 |
kgxat_moneylog_alert |
A player gaining this much within the window alerts admins (0 = off). | 50000 | 0-100000000 |
kgxat_moneylog_alert_minutes |
The alert window (minutes). | 10 | 1-240 |
kgxat_moneylog <name / SteamID> [YYYY-MM-DD] |
Console: the last 60 changes of that player (or everyone) and the top gains of the day. |
Tips and limits
- Files: data/kgx_admin_toolbox/moneylog/<date>.txt, one line per change, written every 2 seconds.
- Admin gifts, rollbacks and the treasury never count toward alerts. An alert is shown once per player per window.
- Rollbacks are kept in data/kgx_admin_toolbox/moneylog/rollbacks.json (and undone.json).
- After Clear the whole Money Log, older changes can no longer be rolled back.
- Bots are not logged. Game Modes match money (buy rounds) is not the economy and is not logged.
- With DarkRP money, changes DarkRP makes itself show as DarkRP (without more detail).