FAQ and Troubleshooting

FAQ & Troubleshooting

What it is

Does EconGuard prevent RMT / cheating? No — it detects and surfaces it. The in-game half of a real-money trade looks identical to a legitimate gift, so nothing on your server can block it with certainty. EconGuard flags suspicious patterns for a human to review and gives you an audit trail for enforcement. To actually cap the damage, add a currency maximum and friction (limits/cooldowns/tax) on transfers in your economy plugin.

Do I need it to run RoyalBank / RoyalAuctions / RoyalBazaar? No. All three run fully without it. EconGuard only adds cross-plugin auditing and correlation. When it is installed, they report to it automatically with zero config.

Does it move or hold money? Never. It only records what other plugins report and analyses it. Your balances live in your economy plugin (and RoyalBank), untouched.

Nothing is being recorded

/eg stats shows an empty ledger. EconGuard only records what other plugins report. On its own it has nothing to log. Confirm a reporting plugin (a Royal* plugin or your own — see Developer API) is installed, then move some money and re-check /eg stats.

I have RoyalBank installed but no bank events appear. Make sure both plugins are current and enabled without errors, then restart once so RoyalBank resolves EconGuard's service. Trigger a deposit and re-run /eg stats. If still nothing, check the console for errors from either plugin on startup.

Flags

Too many flags / false positives. The default thresholds are high but still generic. Calibrate them to your economy — see tuning. A noisy detector gets ignored; fewer, higher-confidence flags are the goal. Clear false positives with /eg flags clear <player>.

No flags ever, even for obvious abuse. Your thresholds are probably higher than your economy's real numbers, so nothing reaches them. Lower large-transaction, young-incoming-transfer, and the velocity/counterparty thresholds to match what a genuinely unusual amount looks like on your server.

A legitimate veteran got flagged. Two of the four signals only fire on young accounts, so a veteran shouldn't hit those. If they tripped counterparty correlation (which ignores age), check both parties' histories with /eg history — a one-off legitimate trade clears easily; a repeated pair through multiple channels is the real signal. Clear the flag if it's clean.

Developers

How do I report events from my own plugin? One statement — see Developer API. EconGuard.get().ifPresent(api -> api.record(...)). It's a no-op if EconGuard isn't installed, so you don't need a hard dependency.

My events show the wrong direction in /eg history. incoming is from the reporting player's perspective: false when money leaves them (a deposit), true when it arrives (a sale). See the two things to get right.

Counterparty correlation never fires for my plugin's transfers. You're probably not setting .counterparty(uuid, name). Correlation needs both sides recorded — a null counterparty makes that signal blind. Note the method takes two arguments (UUID and name).

Data

Where is the data and how big does it get? plugins/EconGuard/econguard.db, bounded by database.max-rows-per-player (default 500, pruned on startup). See Storage.

How do I wipe it? Stop the server and delete econguard.db (and its -wal/-shm files). To clear only flags, use /eg flags clear.

Still stuck?

Open an issue on the GitHub repository with your server version, EconGuard version, the reporting plugin(s) in use, the relevant config section, and any console errors.