OrjusBlockStats

OrjusBlockStats ⛏️

true effort is a powerful and lightweight flexible block tracking plugin designed for survival and competitive Minecraft servers. Unlike simple stat trackers, true effort 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

* PlaceholderAPI Support: * PlaceholderAPI Support: Blocks placed by players are recorded in the database and PlaceholderAPI Support towards mining statistics when broken. * PlaceholderAPI Support: Blocks formed by Cobblestone, Stone, or Obsidian generators are treated as "placed" and also ignored, preventing AFK farming abuse. * PlaceholderAPI Support: * PlaceholderAPI Support: If a player-placed block is pushed by a piston, the plugin tracks its new location. * PlaceholderAPI Support: If a tracked block is blown up, it is automatically removed from the database to keep it clean. * PlaceholderAPI Support: * PlaceholderAPI Support: Zero-configuration, high-performance local file database. * PlaceholderAPI Support: Fully supported for larger servers or networks. * PlaceholderAPI Support: * 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. * PlaceholderAPI Support: * 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: * Messages: H2, MySQL, or PostgreSQL. * Messages: Fine-tune HikariCP settings for performance. * Messages: 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.*