MINECRAFTBIBLE
Loading...
AltDetector is a powerful Paper plugin that silently identifies alternate accounts through a multi-layer engine combining IP matching, UUID/username history cross-referencing, and behavioral login pattern analysis. Staff are instantly alerted.
Intelligent Alternate Account Detection for Paper
Stop ban evasion in its tracks. AltDetector runs a silent, fully async multi-layer detection engine on every login — no lag, no false positives flooding chat, just precise alerts delivered straight to your staff.
Every login is analyzed through four independent detection layers, each producing a confidence score that is then weighted and combined into a final risk score (0.
0–1.0):
| Layer | Method | Weight |
|---|---|---|
| **IP Match** | Shared IP address history | 40% |
| **UUID / Username History** | Name-swap & cross-account username collisions | 25% |
| **Login Pattern Analysis** | Session shifts, never-concurrent play, rapid alternation | 25% |
| **Behavior Fingerprint** | Playtime ratios, peak-hour cosine similarity | 10% |
All detection runs **fully asynchronously** — the main thread is never blocked.
| Score | Level | Action |
|---|---|---|
| 0.50 – 0.69 | 🟡 LOW | Staff alert only |
| 0.70 – 0.84 | 🟠 MEDIUM | Staff alert + flag player record |
| 0.85 – 1.00 | 🔴 HIGH | Staff alert + flag + optional auto-ban |
All thresholds are fully configurable.
Alerts are silently sent only to players with altdetector.staff.alerts. Each alert includes clickable [Inspect] [Ban] [Dismiss] [Whitelist] buttons — no need to type a single command. Offline staff receive queued alerts the moment they log in.
When an alt of a banned player is detected above your configured threshold, AltDetector can automatically issue a ban with a customizable reason and appeal URL. Fires a cancellable AltBanEvent so other plugins can hook in.
All data is stored in a local SQLite database using WAL journal mode and prepared statements. Tracked data includes:
- IP address history (up to 20 per player, FIFO)
- Username history (up to 50, FIFO)
- Risk scores & flagged status
- Staff notes
- Full detection log with evidence tags
vpn_hint evidence tag with a small risk bumpaltdetector.bypass to trusted accounts| Command | Description |
|---|---|
| `/alt <player> [page]` | View all known alts of a player with risk scores |
| `/altadmin inspect <player>` | Full profile: IPs, logins, risk, links, evidence |
| `/altadmin history <player>` | Paginated login history with timestamps |
| `/altadmin link <p1> <p2>` | Manually link two accounts |
| `/altadmin unlink <p1> <p2>` | Remove a link |
| `/altadmin confirm <player>` | Confirm a detected alt link |
| `/altadmin whitelist <player>` | Whitelist from detection |
| `/altadmin ban <player>` | Ban player and all confirmed alts simultaneously |
| `/altadmin note <player> <text>` | Attach a staff note |
| `/altadmin purge <player>` | Full GDPR data wipe |
| `/altadmin export <player>` | Export full record as JSON |
| `/altadmin stats` | Detection statistics |
| `/altadmin reload` | Hot-reload config & messages |
All subcommands support **tab-completion**.
| Placeholder | Value |
|---|---|
| `%altdetector_risk_score%` | Player's current risk score |
| `%altdetector_alt_count%` | Number of known alt accounts |
| `%altdetector_flagged%` | `true` or `false` |
Other plugins can hook into AltDetector's pipeline:
AltDetectedEvent — fired on any detection above LOW thresholdAltBanEvent (cancellable) — fired before any auto-banAltLinkConfirmedEvent — fired when staff confirms a linkAltWhitelistEvent — fired on whitelist changesFully documented config.yml and MiniMessage-powered messages.yml with named placeholders. Reload at any time with /altadmin reload — no restart needed.
AltDetector is designed for survival, SMP, factions, and competitive servers where ban evasion is a serious problem. Zero dependencies beyond Paper itself.