# \ud83c\udf40 TopLuck<\/p>\n
**TopLuck** is a sophisticated plugin for monitoring anti-cheat measures on Minecraft servers. \ud83e\udde0
\nIt tracks the “luck” \ud83c\udf40 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**. \ud83d\udee1\ufe0f<\/p>\n
This plugin offers **extensive statistical analysis** \ud83d\udcca of loot behavior and highlights **anomalies** that deviate from standard drop rates.
\nWhether you’re running a **competitive survival server** \u2694\ufe0f or a **semi-vanilla SMP** \ud83c\udfde\ufe0f, TopLuck provides an **effective**, **invisible**, and **behavior-based** method of cheat detection \u2014 going beyond hitbox and movement triggers. \ud83d\udc40<\/p>\n
—<\/p>\n
## \ud83d\udd0d Main Highlights<\/p>\n
### \u26cf\ufe0f Real-Time Loot Tracking<\/p>\n
* Monitors:<\/p>\n
* Rare block mining (e.g. diamond, netherite)
\n * Mob drops (e.g. skulls, blaze rods)
\n * Structure loot (e.g. chests in temples, bastions)
\n * Fishing rewards \ud83c\udfa3
\n* Calculates a **”luck score”** for each player based on frequency and probability.<\/p>\n
—<\/p>\n
### \ud83c\udfc6 Player Ranking<\/p>\n
* Command `\/topluck` displays:<\/p>\n
* The **luckiest players** currently online
\n * Detailed **statistics**, **loot counts**, and **anomaly percentages** \ud83d\udcc8<\/p>\n
—<\/p>\n
### \ud83d\udea8 Suspicious Behavior Detection<\/p>\n
* Automatically alerts moderators when:<\/p>\n
* A player’s loot rate exceeds a configurable threshold (e.g. 300% above average)
\n* Alert methods:<\/p>\n
* Chat messages \ud83d\udcac
\n * BossBar \ud83e\ude84
\n * ActionBar \ud83d\udce2
\n * Discord webhook \ud83d\udd17<\/p>\n
—<\/p>\n
### \ud83d\udcda Loot History & Logs<\/p>\n
* Stores full loot logs in **SQLite** or **MySQL** \ud83d\uddc3\ufe0f
\n* Commands available for searching and browsing player history
\n* Export formats: **CSV** \ud83d\udcc4 and **JSON** \ud83e\uddfe for advanced analysis<\/p>\n
—<\/p>\n
### \ud83d\uddbc\ufe0f Modern Interface Options<\/p>\n
* Optional visual displays:<\/p>\n
* Scoreboard \ud83d\udccb
\n * Tab list prefixes \ud83c\udff7\ufe0f
\n * Temporary BossBars for live alerts
\n * Web live dashboard<\/p>\n
—<\/p>\n
### \ud83d\udd27 Fully Configurable<\/p>\n
* YAML-based configuration \ud83d\udcc2:<\/p>\n
* Enable\/disable specific loot categories
\n * Set tracking windows and thresholds
\n * Customize alert channels and storage duration<\/p>\n
—<\/p>\n
### \ud83d\udd0c Plugin Integration<\/p>\n
* **Public API** for external access \ud83c\udf10
\n* **PlaceholderAPI support** for use in GUIs, signs, or chat formats<\/p>\n
—<\/p>\n
## \u2705 Use Cases<\/p>\n
* \ud83d\udd0e Detecting players mining **too many diamonds** \ud83d\udc8e too quickly
\n* \ud83e\udddf Identifying **abnormally frequent rare drops** (e.g. skulls, books)
\n* \ud83d\udd75\ufe0f Passive, **non-invasive anti-cheat** detection
\n* \ud83c\udfd7\ufe0f Monitoring suspicious activity in **competitive or semi-vanilla environments**<\/p>\n","protected":false},"excerpt":{"rendered":"
This plugin allows you to see if your players have luck… or are cheaters<\/p>\n","protected":false},"featured_media":157891,"template":"","meta":{"_minecraft_slug":"topluck","_minecraft_project_id":"PkYog9LG","_minecraft_author":"Matisse","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":277,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"topluck.zip","_minecraft_size_bytes":38115,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T11:59:35.661669Z","_minecraft_date_created":"2025-07-04T03:39:36.919230Z","_minecraft_date_modified":"2025-10-22T08:54:14.959054Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/topluck","_minecraft_icon_attachment_id":157891,"_minecraft_imported_at":"2026-06-09T13:21:44+00:00","_minecraft_import_hash":"8bb8d0eb4e9d1d6afd5de41520905f63","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,127,128,867,129,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-157890","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n