Blocks

Blocks

The Blocks module tracks how many blocks every player has mined over their lifetime on the server. It feeds into leaderboards, milestone rewards, lucky-block triggers, and PlaceholderAPI placeholders.

---

Overview

Feature	Details
Storage	Database
Leaderboard	Top 10 players by blocks mined
Milestones	Configurable reward thresholds
Lucky blocks	Reward commands fired when a specific block type is mined

---

Features

Milestones

Define block-count thresholds in block-rewards.yml. When a player crosses a threshold a list of commands is executed (e.g. give tokens, broadcast, etc.).

Lucky Blocks

Mark specific block types as "lucky" in the lucky-blocks section of blocks.yml. Whenever a player mines a block of that type, the listed console commands run, with %player% replaced by their name. Make a block feel "lucky" by including it only rarely in your mine's block composition.

lucky-blocks:
  SPONGE:
    - tokens give %player% 1000
  DIAMOND_BLOCK:
    - tokens give %player% 5000
    - broadcast %player% hit a diamond lucky block!

• Use the Bukkit material name (e.g. DIAMOND_BLOCK, not DIAMONDBLOCK). An invalid or unsupported name is skipped with a clear console warning and does not stop your other lucky blocks from working.
• You can safely add or edit lucky blocks while the server is running — your changes are kept across restarts. Run /xprison reload blocks or restart the server to apply them.

Top Blocks

Players can view the global top-10 mining leaderboard. The list resets on a weekly schedule if weekly-reset is enabled.

---

Commands

/blocks [player]          View blocks mined (own or another player)
/blockstop                View top-10 blocks leaderboard

---

Permissions

Permission	Description
xprison.blocks.admin	Admin block management commands
xprison.blocks.other	View another player's block count

---

PlaceholderAPI

Placeholder	Returns
%xprison_blocks%	Total blocks mined, formatted (e.g. 1.2M)
%xprison_blocks_2%	Total blocks mined, raw number
%xprison_blocks_3%	Total blocks mined, short format

---

Related Pages

• block-rewards.yml — Default Config
• blocks.yml — Default Config
• Commands & Permissions
• Placeholders