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**