GPClaimBlocks is a simple but polished addon for GriefPrevention that automatically adjusts a player’s claim blocks based on their LuckPerms rank.

When a player's rank changes, the plugin instantly updates their claim block total according to your configuration. Perfect for servers with VIP systems or tiered ranks.

• Give automatic bonus claim blocks per rank
• Sync claim blocks instantly when a rank changes
• Optional accumulation mode (combine bonuses from multiple ranks)
• Show claim info with PlaceholderAPI

Everything is fully configurable in config.yml.
No databases, no complexity — just a clean and lightweight utility.

✨ Features

• Rank-based Bonuses – Easily set different claim block amounts per rank (Default, VIP, MVP, etc.)
• Instant Sync – When a player's LuckPerms group changes, the plugin updates their GriefPrevention data immediately.
• Accumulation Mode – Combine bonuses from multiple ranks (optional).
• PlaceholderAPI Integration – Display bonus, total, or remaining claim blocks anywhere.
• Lightweight & No Database – Simple utility plugin with zero performance impact.
• Tested on 1.20.x – Fully compatible with modern Spigot/Paper servers.

❓ How it works

1. Server starts and GPClaimBlocks loads your rank configuration.
2. When a player joins or their rank changes, the plugin checks their permissions.
3. GPClaimBlocks calculates the correct claim block bonus using your rules:
   • Use the highest-rank bonus, OR
   • Combine bonuses from multiple ranks (if accumulation mode is enabled)
4. The plugin updates the player’s GriefPrevention claim blocks instantly.
5. Optional: Use PlaceholderAPI to show their bonus or total claim blocks.

Commands & Permissions

Commands:

• /gpclaimblocks reload — Reload configuration
• /gpclaimblocks info <player> — Show player's claim block details
• /gpclaimblocks list — Show all configured ranks
• /gpclaimblocks update <player> — Force-update claim blocks

Permission:

• gpclaimblocks.admin

PlaceholderAPI Format

Available placeholders:

• %gpclaimblocks_bonus% — Bonus claim blocks
• %gpclaimblocks_total% — Total claim blocks
• %gpclaimblocks_left% — Remaining claim blocks
• %gpclaimblocks_rank% — Rank used for calculation

Notes

GPClaimBlocks is designed to be clean, efficient, and fully automated.
Once configured, it will manage all claim block bonuses silently in the background without requiring any maintenance.