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.

# 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.