🍀 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