Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
ChunkClaimPlugin (CCP)
ChunkClaimPlugin is a lightweight, high-performance land protection plugin for modern Spigot and Paper servers (1.19.4 through 26.x). It provides grid-aligned chunk claiming with named territories, granular protection flags, an optional progressive economy engine, and per-player localization.
Designed from the ground up for survival servers, CCP replaces complex wand selection and arbitrary polygon math with native Minecraft chunk boundaries (16 × 16 × world height), guaranteeing zero tick overhead on block interactions.
Command Reference
Player Commands
| Command | Permission | Description |
|---|---|---|
/claimchunk [name] |
ccp.claim |
Claims the chunk you are standing in under an optional group name |
/chunkexpand <name> |
ccp.expand |
Adds the current chunk to an existing named claim group |
/unclaimchunk [name] |
ccp.unclaim |
Unclaims a specified claim group, or the chunk you are standing in |
/checkchunk |
ccp.check |
Checks ownership and claim status of the current chunk |
/infochunk [page] |
ccp.info |
Lists your claim groups with page-based navigation |
/visualizechunk [name] |
ccp.visualize |
Displays temporary per-player particle borders around exact claim perimeters |
/chunktp <name> |
ccp.teleport |
Safely teleports you to one of your claimed groups |
/chunksettings [subcommand] |
ccp.settings |
Opens the interactive settings GUI or runs CLI subcommands |
/chunklang [locale] |
ccp.lang |
Sets your personal display language |
Marketplace Commands
| Command | Permission | Description |
|---|---|---|
/claimtrade sell <claim> <price> |
ccp.trade |
Lists an owned claim group for sale on the server market |
/claimtrade cancel <claim> |
ccp.trade |
Removes your claim group from the market |
/claimtrade buy [<seller> <claim>|<seller>:<claim>|<claim>] |
ccp.trade |
Purchases a claim (standing inside it or by seller/claim name) |
/claimtrade list |
ccp.trade |
Displays all claims currently listed for sale across the server |
/claimtrade claim |
ccp.trade |
Collects pending economy payouts once inventory space is available |
Administrator Commands
| Command | Permission | Description |
|---|---|---|
/chunkadmin |
chunkclaim.admin |
Opens administrator management dashboard |
/chunkadmin reload |
chunkclaim.admin |
Reloads config.yml, locale files, cached settings, and economy engine |
/chunkadmin unclaim |
chunkclaim.admin |
Forcefully unclaims the chunk you are standing in |
/chunkadmin unclaimplayer <player> [name|--all] |
chunkclaim.admin |
Forcefully unclaims specific or all claims of a player |
/chunkadmin setlimit <player> <amount> |
chunkclaim.admin |
Sets a custom claim limit override for a player (0 = unlimited) |
/chunkadmin removelimit <player> |
chunkclaim.admin |
Restores a player's claim limit back to server default |
/chunkadmin resetflag <flag> [action] |
chunkclaim.admin |
Purges or overrides a claim flag across all server claims |
Key Features
Named Territory Groups
Players can organize their land into distinct named claim groups rather than isolated chunks (e.g., /claimchunk Base, /chunkexpand Base). Protection flags, trusted player permissions, and trading statuses apply to the entire group seamlessly.
Progressive Economy & Dynamic Price Drops
Completely optional (enabled: false by default). Works with Vault virtual balances, Gringotts physical gold banks, or built-in item currency (GOLD_INGOT, DIAMOND) with zero external dependencies.
- Escalating Price Curve: Set free starter chunks, a base chunk cost, and progressive price increments per chunk owned to prevent map hoarding.
- Dynamic Price Drop on Unclaim: Cost formulas calculate strictly from a player's current active chunk count. When players unclaim land, their next claim's cost immediately decreases to match their new lower tier, while issuing a configurable refund.
- P2P Marketplace (
/claimtrade): Players can buy and sell established bases directly. Offline sellers automatically receive their earnings upon login.
Granular Protection Flags
Flags can be toggled per claim group in /chunksettings or via CLI commands:
| Flag | Description | Default |
|---|---|---|
mob-griefing |
Prevents Creeper explosions and Endermen block pickup | Enabled |
mob-spawning |
Disables natural hostile mob spawning within the claim | Disabled |
mob-entry |
Pushes hostile mobs away at the border (invisible barrier) | Disabled |
mob-protection |
Protects friendly farm animals from outside visitors | Enabled |
explosions |
Blocks TNT, minecart TNT, and Wither explosion damage | Enabled |
pvp |
Blocks player-vs-player combat (and Crystal/Anchor PvP) within the claim (block-pvp in config.yml) |
Enabled |
fire-spread |
Blocks fire from igniting, burning, or spreading | Enabled |
interact-chest |
Restricts chests, barrels, and shulker boxes to trusted members | Enabled |
interact-furnace |
Restricts furnaces, blast furnaces, and smokers | Enabled |
interact-stonecutter |
Restricts crafting tables, stonecutters, and workbenches | Enabled |
interact-door |
Restricts doors, trapdoors, and fence gates | Enabled |
interact-redstone |
Restricts levers, buttons, repeaters, and comparators | Enabled |
interact-villagers |
Restricts trading with villagers and wandering traders to prevent trade lockout | Enabled |
Custom Menu Ready (DeluxeMenus / ChestCommands)
Every setting in /chunksettings features dedicated CLI subcommands (flag, trust, untrust, particle, rename, transfer, unclaim) with full tab-completion. Server owners can bind buttons in DeluxeMenus or custom GUI plugins directly to CCP subcommands.
Non-Intrusive Territory Alerts
Territory entrance and wilderness notices are delivered directly above the hotbar in the Action Bar by default, keeping the center of the screen clear during building and combat. Title, subtitle, and chat modes are also supported.
Native Per-Player Localization
Players can independently configure their display language using /chunklang set <locale>. Includes complete parity across:
- English (
en_US), Spanish (es_ES), French (fr_FR), German (de_DE), Portuguese (pt_BR), Russian (ru_RU), and Chinese (zh_CN).
Technical Specifications & Architecture
- Spatial Lookup Complexity: O(1) concurrent memory lookup (
ConcurrentHashMap) via chunk coordinate keys (world:x:z), async-safe for PlaceholderAPI expansions and backed by atomic async disk persistence. - Server Compatibility: Paper, Purpur, and Spigot (Minecraft 1.19.4, 1.20.x, 1.21.x, and 26.x).
- Java Runtime: Java 17 or higher (Java 21 fully supported).
- World Controls & WorldGuard: Native
disabled-worldsblacklist plus WorldGuard region overlap protection (Flags.BUILD&__global__-safe). - PlaceholderAPI: Full expansion for player claim statistics, limits, group names, and marketplace pricing (
%ccp_claimed_chunks%,%ccp_max_chunks%,%ccp_claim_name%,%ccp_is_for_sale%,%ccp_claim_price%). - Developer API: Programmatic singleton
ChunkClaimAPIwith cancellable Bukkit events (ChunkClaimEvent,ChunkUnclaimEvent,ChunkRenameEvent,ChunkTransferEvent).
Documentation & Support
- Server Owner Wiki & Setup Guide
- Developer API Reference
- Discord Community Support
- Support on Ko-fi
- GitHub Repository & Issue Tracker
Version History
v0.8.5 (Major Security, Performance & Stability Release)
- Full Grief & Exploit Audit (50 Fixes):
- Blocked bucket placement/pickup, fluid & dragon-egg cross-border inflow, piston extend/retract across claim borders, direct Flint & Steel / Fireball ignition, End Crystal & Respawn Anchor explosions, lingering potion clouds, Chorus Fruit & Ender Pearl vault infiltration, Frost Walker ice griefing, 1.20+ sign text editing, fishing-rod entity pulling, leash/unleash theft, Bad Omen raids, boat/minecart placement & entity mounting, entity crop/turtle egg trampling, cross-border tree growth, and Nether portal overwriting.
- Protected dyed shulker boxes, pressure plates, tripwire, anchors, cauldrons, composters, cakes, bells, lecterns, chiseled bookshelves, and decorated pots; decoupled
ArmorStandbreak protection frommob-protection.
- Performance & Thread Safety:
- Replaced global world entity scans in
mob-entrywith loaded-chunk-only checks and protected pets (Tameable), custom-named mobs, villagers, and iron golems from removal. - Added async atomic saving (
chunkclaims.yml.tmp), converted allChunkManagercollections toConcurrentHashMap, removed async.getChunk()calls in PlaceholderAPI, added bitshift pre-checks inPlayerMoveListener, cached hot-path config settings in memory, and eliminated blocking Mojang API lookups in/chunkadmin.
- Replaced global world entity scans in
- Economy & Marketplace Hardening:
- Tracked historical purchase prices per chunk and zeroed traded claim refunds to eliminate infinite money arbitrage; added
/claimtrade buy <seller> <claim>disambiguation,/claimtrade claimoverflow recovery, RPG/custom-meta item protection,Material.AIRcrash prevention, andsingular-name/plural-namecurrency labels.
- Tracked historical purchase prices per chunk and zeroed traded claim refunds to eliminate infinite money arbitrage; added
- Navigation, Worlds & Admin Config:
- Added safe vertical Nether/underground scanning in
/chunktp, accurate per-chunk outer perimeter particle borders (per-player packets, configurable height & spacing,REDSTONE/DUSTaliasing), WorldGuard__global__bypass fix,disabled-worldsblacklist,/infochunk [page]pagination,/chunkadmin reload, comment-preserving YAML writes, andblock-pvp: trueconfig semantics.
- Added safe vertical Nether/underground scanning in
v0.8.0
- Admin Land Management: CLI and GUI tools to inspect and forcefully unclaim player land (
/chunkadmin unclaim,/chunkadmin unclaimplayer). - Villager Trade Protection & Combat Upgrades: Added
interact-villagersclaim flag to prevent strangers from exhausting villager trades or to permit public trading malls. Unblocked right-click interactions on hostile monsters for custom sword combat and allowed defending against angry bees and neutral mobs. - Multi-Economy Support: Flexible economy integration supporting Vault, Gringotts/gold banks, and native physical item currency (
GOLD_INGOT,DIAMOND) with offline payment queues. - Dynamic Price Scaling & Drops: Progressive claiming costs that dynamically drop back down when players unclaim land.
- Player Claim Trading: Unified marketplace under
/claimtrade(buy,sell,cancel,list). - CLI Subcommands for Custom GUIs: Full CLI subcommands in
/chunksettingsfor flags, trust, particles, renames, and transfers to integrate with DeluxeMenus. - Action Bar Greetings: Customizable territory entry and wilderness notifications delivered via the action bar.
- Localization Completion: 100% complete string parity across all 7 supported languages.
- Developer API Expansion: New administrative and marketplace query methods in
ChunkClaimAPI. - PlaceholderAPI Additions:
%ccp_is_for_sale%and%ccp_claim_price%.
v0.7.0
- Developer API & Events: Public
ChunkClaimAPIsingleton and cancellable Bukkit events (ChunkClaimEvent,ChunkUnclaimEvent,ChunkRenameEvent,ChunkTransferEvent). - PlaceholderAPI Integration: Expansion providing claim counts, limits, ownership, and group details.
- Fire Spread Protection: Added
fire-spreadflag to protect claims against burning and ignite events. - Permission-Based Flags: Granular
ccp.flag.*permission nodes for GUI flag toggles. - Per-Player Limits: Administrator command
/chunkadmin setlimitfor individual player overrides. - Event Command Triggers: Console command execution hooks upon chunk claim and unclaim events.
v0.6.0
- Command Alias: Added
/ccpshortcut alias. - Item-Based Claiming: Right-click claiming using a configurable tool (default: Wooden Shovel).
- Chunk Entry Greetings: Configurable welcome titles and subtitles upon entering claimed land.
- Granular Interaction Settings: Protection flags for chests, furnaces, utility blocks, doors, and redstone.
- Passive Mob Protection: Flag to prevent visitors from harming animals within claims.
- Claim Renaming & Transfer: Seamless claim renaming and ownership transfer directly from the GUI.
- Claim Teleportation: Teleport to claims by name with
/chunktp. - New Languages: Added German (
de_DE), Portuguese (pt_BR), and Russian (ru_RU).
v0.5.0 – v0.5.2
- Admin Dashboard: Initial
/chunkadminmanagement GUI. - Named Claim Groups: Replaced coordinate-only tracking with named claim groups (
/claimchunk <name>,/chunkexpand <name>). - Trust System: Per-claim trusted player management via GUI player heads.
- Particle Selection: Per-player customizable boundary visualizers in
/chunksettings. - Chinese Language: Added Simplified Chinese (
zh_CN) localization. - Platform Support: Minecraft 1.21.11 and 26.1 API compatibility.
v0.2 – v0.4
- Core Rewrite & Modernization: Overhauled engine for modern Spigot/Paper architecture.
- Interactive GUI: Introduced player settings menu (
/chunksettings) for claims, deletion, and languages. - Boundary Visualizer: Particle-based chunk border rendering.
- WorldGuard Integration: Full-chunk region overlap validation.
- Initial Localization: English (
en_US), Spanish (es_ES), and French (fr_FR).
License
ChunkClaimPlugin is open source software distributed under the terms of the MIT License.


