🍀 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
/topluckdisplays:- 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
