# OrjusBlockStats \u26cf\ufe0f<\/p>\n
**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.<\/p>\n
## Features<\/p>\n
* **Anti-Exploit System**:
\n * **Placed Block Tracking**: Blocks placed by players are recorded in the database and **do not count** towards mining statistics when broken.
\n * **Generator Support**: Blocks formed by Cobblestone, Stone, or Obsidian generators are treated as “placed” and also ignored, preventing AFK farming abuse.
\n * **Smart Mechanics**:
\n * **Pistons**: If a player-placed block is pushed by a piston, the plugin tracks its new location.
\n * **Explosions**: If a tracked block is blown up, it is automatically removed from the database to keep it clean.
\n* **Database Support**:
\n * **H2 (Default)**: Zero-configuration, high-performance local file database.
\n * **MySQL \/ PostgreSQL**: Fully supported for larger servers or networks.
\n* **Multi-Server Sync**:
\n * Running a BungeeCord network? Connect multiple servers to the same MySQL database!
\n * The `server-name` setting allows servers to share player stats (total blocks broken) while keeping “placed block” data separate for each world.
\n* **Leaderboards**:
\n * Built-in `\/blockstats top` command to display the top miners.
\n * Fully customizable messages and formats.
\n* **PlaceholderAPI Support**:
\n * Use `%orjusblockstats_total%` to display a player’s raw broken block count in scoreboards, tab lists, or chat.<\/p>\n
## Installation<\/p>\n
1. Download the plugin `.jar` and place it in your server’s `plugins` folder.
\n2. Start the server.
\n3. (Optional) Configuration:
\n * Open `plugins\/OrjusBlockStats\/config.yml`.
\n * If using MySQL\/PostgreSQL, enter your credentials.
\n * Customize messages and colors to match your server’s theme.
\n4. Run `\/blockstats reload` or restart the server.<\/p>\n
## Commands<\/p>\n
| Command | Description | Permission |
\n| :— | :— | :— |
\n| `\/blockstats top` | Displays the top miners leaderboard. | None (Default) |
\n| `\/blockstats reload` | Reloads the configuration file. | `orjusblockstats.admin` |<\/p>\n
## Configuration<\/p>\n
The configuration file is fully customizable. You can change:
\n* **Database Type**: H2, MySQL, or PostgreSQL.
\n* **Connection Pool**: Fine-tune HikariCP settings for performance.
\n* **Top List**: Change the number of players shown.
\n* **Messages**: Translate\/Edit the header, format, and error messages using standard `&` color codes.<\/p>\n
“`yaml
\n# Example settings
\ntop-limit: 10
\nmessages:
\n top-header: “&6— Top &c%limit% &6Miners —”
\n top-format: “&e%rank%. &f%player%: &a%value%”
\n“`<\/p>\n
## Placeholders<\/p>\n
Requires **PlaceholderAPI**.<\/p>\n
* `%orjusblockstats_total%` \u2014 Returns the total number of blocks broken by the player (excluding player-placed ones).<\/p>\n
—
\n*Built for reliability and performance.*<\/p>\n","protected":false},"excerpt":{"rendered":"
OrjusBlockStats is a powerful and lightweight flexible block tracking plugin designed for survival and competitive Minecraft servers.<\/p>\n","protected":false},"featured_media":118015,"template":"","meta":{"_minecraft_slug":"orjusblockstats","_minecraft_project_id":"8GY3fZQv","_minecraft_author":"xxxvs15xxx","_minecraft_license":"MIT","_minecraft_downloads":16,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"orjusblockstats.zip","_minecraft_size_bytes":7994431,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:47:34.951635Z","_minecraft_date_created":"2026-02-09T23:47:26.906527Z","_minecraft_date_modified":"2026-02-07T10:37:41.254693Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/orjusblockstats","_minecraft_icon_attachment_id":118015,"_minecraft_imported_at":"2026-06-06T22:35:43+00:00","_minecraft_import_hash":"494cac86ac6fe6423cb0e406d942318e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,125,89,127,128,123],"mod_loader":[131,132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-118014","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-technology","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","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