TopLuck
TopLuck is a sophisticated plugin for monitoring anti-cheat measures on Minecraft servers. It tracks the "luck" or rarity of loot acquired by players in real time, assisting administrators in identifying unusual activities like x-ray usage, auto-mining bots, or exploit misuses. ️
This plugin offers extensive statistical analysis of loot behavior and highlights anomalies that deviate from standard drop rates. Whether you're running a competitive survival server ⚔️ or a semi-vanilla SMP ️, TopLuck provides an effective, invisible, and behavior-based method of cheat detection — going beyond hitbox and movement triggers.
Main Highlights
⛏️ Real-Time Loot Tracking
- Monitors:
- Rare block mining (e.g. diamond, netherite)
- Mob drops (e.g. skulls, blaze rods)
- Structure loot (e.g. chests in temples, bastions)
- Fishing rewards
- Calculates a "luck score" for each player based on frequency and probability.
Player Ranking
- Command /topluck displays:
- The luckiest players currently online
- Detailed statistics, loot counts, and anomaly percentages
Suspicious Behavior Detection
- Automatically alerts moderators when:
- A player's loot rate exceeds a configurable threshold (e.g. 300% above average)
- Alert methods:
- Chat messages
- BossBar
- ActionBar
- Discord webhook
Loot History & Logs
- Stores full loot logs in SQLite or MySQL ️
- Commands available for searching and browsing player history
- Export formats: CSV and JSON for advanced analysis
️ Modern Interface Options
- Optional visual displays:
- Scoreboard
- Tab list prefixes ️
- Temporary BossBars for live alerts
- Web live dashboard
Fully Configurable
- YAML-based configuration :
- Enable/disable specific loot categories
- Set tracking windows and thresholds
- Customize alert channels and storage duration
Plugin Integration
- Public API for external access
- PlaceholderAPI support for use in GUIs, signs, or chat formats
✅ Use Cases
- Detecting players mining too many diamonds too quickly
- Identifying abnormally frequent rare drops (e.g. skulls, books)
- ️ Passive, non-invasive anti-cheat detection
- ️ Monitoring suspicious activity in competitive or semi-vanilla environments