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

Marketplace Commands

Administrator Commands

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:

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) memory lookup via chunk coordinate keys (world:x:z). No bounding-box geometric intersections or polygon parsing on block interact events.
• 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).
• WorldGuard Compatible: Automatically queries WorldGuard regions to prevent claiming over protected administrative territories.
• 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 ChunkClaimAPI with 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.0

• Admin Land Management: CLI and GUI tools to inspect and forcefully unclaim player land (/chunkadmin unclaim, /chunkadmin unclaimplayer).
• 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 /chunksettings for 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 ChunkClaimAPI singleton and cancellable Bukkit events (ChunkClaimEvent, ChunkUnclaimEvent, ChunkRenameEvent, ChunkTransferEvent).
• PlaceholderAPI Integration: Expansion providing claim counts, limits, ownership, and group details.
• Fire Spread Protection: Added fire-spread flag 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 setlimit for individual player overrides.
• Event Command Triggers: Console command execution hooks upon chunk claim and unclaim events.

v0.6.0

• Command Alias: Added /ccp shortcut 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 /chunkadmin management 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.