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.

✨ Key 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 & Permissions

Command	Description	Permission
/blockstats top	Displays the top miners leaderboard.	None (Default)
/blockstats reload	Reloads the configuration file.	orjusblockstats.admin

⚙️ Configuration (config.yml)

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.