TopLuck

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