OrjusBlockStats

# OrjusBlockStats ⛏️ **OrjusBlockStats** is a powerful and lightweight flexible block tracking plugin designed for survival and competitive Minecraft servers. Unlike simple stat trackers, **OrjusBlockStats** intelligently distinguishes between naturally generated blocks and player-placed blocks, ensuring that your server's mining statistics represent **true effort**, not just placing and breaking the same block repeatedly. ## Features * **Anti-Exploit System**: * **Placed Block Tracking**: Blocks placed by players are recorded in the database and **do not count** towards mining statistics when broken. * **Generator Support**: Blocks formed by Cobblestone, Stone, or Obsidian generators are treated as "placed" and also ignored, preventing AFK farming abuse. * **Smart Mechanics**: * **Pistons**: If a player-placed block is pushed by a piston, the plugin tracks its new location. * **Explosions**: If a tracked block is blown up, it is automatically removed from the database to keep it clean. * **Database Support**: * **H2 (Default)**: Zero-configuration, high-performance local file database. * **MySQL / PostgreSQL**: Fully supported for larger servers or networks. * **Multi-Server Sync**: * Running a BungeeCord network? Connect multiple servers to the same MySQL database! * The `server-name` setting allows servers to share player stats (total blocks broken) while keeping "placed block" data separate for each world. * **Leaderboards**: * Built-in `/blockstats top` command to display the top miners. * Fully customizable messages and formats. * **PlaceholderAPI Support**: * Use `%orjusblockstats_total%` to display a player's raw broken block count in scoreboards, tab lists, or chat. ## Installation 1. Download the plugin `.jar` and place it in your server's `plugins` folder. 2. Start the server. 3. (Optional) Configuration: * Open `plugins/OrjusBlockStats/config.yml`. * If using MySQL/PostgreSQL, enter your credentials. * Customize messages and colors to match your server's theme. 4. Run `/blockstats reload` or restart the server. ## Commands | Command | Description | Permission | | :--- | :--- | :--- | | `/blockstats top` | Displays the top miners leaderboard. | None (Default) | | `/blockstats reload` | Reloads the configuration file. | `orjusblockstats.admin` | ## Configuration The configuration file is fully customizable. You can change: * **Database Type**: H2, MySQL, or PostgreSQL. * **Connection Pool**: Fine-tune HikariCP settings for performance. * **Top List**: Change the number of players shown. * **Messages**: Translate/Edit the header, format, and error messages using standard `&` color codes. ```yaml # Example settings top-limit: 10 messages: top-header: "&6--- Top &c%limit% &6Miners ---" top-format: "&e%rank%. &f%player%: &a%value%" ``` ## Placeholders Requires **PlaceholderAPI**. * `%orjusblockstats_total%` — Returns the total number of blocks broken by the player (excluding player-placed ones). --- *Built for reliability and performance.*