GPClaimBlocks | GriefPrevention Addon

GPClaimBlocks
Automatic rank-based Claim Blocks for GriefPrevention

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.

• Automatic bonus claim blocks per rank
• Instant syncing when ranks change
• Optional accumulation mode (stack multiple rank bonuses)
• PlaceholderAPI support

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 – Updates player GP data the moment a group is added or removed.
• Accumulation Mode – Optionally stacks bonuses from all ranks a player has.
• PlaceholderAPI Integration – Display bonus, total, or remaining claim blocks anywhere.
• Lightweight & Zero-Impact – No database, minimal footprint, optimized for performance.
• Tested on 1.20.x – Fully compatible with modern Spigot/Paper builds.

❓ 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 the configuration
• /gpclaimblocks info <player> — Show player's claim block details
• /gpclaimblocks list — Show all configured rank bonuses
• /gpclaimblocks update <player> — Force-update claim blocks (manual-sync)

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 GPClaimBlocks is designed to be fully automated and maintenance-free. Once configured, it silently manages all claim block adjustments in the background, ensuring accurate and seamless synchronization between LuckPerms and GriefPrevention.