LandClaim

Chunk-based land protection for Paper/Purpur 1.21.x (Java 21).

Version 1.0.0 · Minecraft 1.21 – 1.21.11 · Server-side

LandClaim lets players buy the chunk they stand in, protect it from griefing, and manage who is trusted to build there. It ships with a particle-driven multi-chunk selection flow, chunk reservations, adjacency/bulk discounts, and a dual economy backend (MultiBank with a Vault fallback).

Features

• Paid chunk claiming. Players claim the chunk they are standing in for a configurable price. Pricing can be flat or a per-claim multiplier, with a configurable per-player claim cap.
• Multi-chunk selection with live preview. /claim select, confirm and cancel let players pick several adjacent chunks at once, shown with colored border particles before purchase.
• Discounts. Adjacency discount (per chunk next to an existing claim) and bulk discount (whole selection over a threshold), combined and capped by a configurable maximum rate.
• Chunk reservations. Reserve a chunk for a small fee so nobody else can claim it, with an expiry window and optional credit toward the final purchase. Note: a reservation blocks others from claiming but does not protect the chunk.
• Trust management. Per-chunk trust plus trust-all, with /trust, /untrust, /trustall, /untrustall and /trustlist.
• Grief protection. Blocks unauthorized block break/place, bucket use, explosions, fire spread, piston grief (push and pull-out), enderman grief, farmland/turtle-egg trampling, container and interaction access, and entity theft (armor stands, item frames, paintings, minecarts, boats). PvP inside claims is an optional toggle.
• Free-mining zone (configurable). protection-min-y defines a Y level below which anyone may mine and build inside any claim. See the security note in Configuration before shipping the default.
• Border particles. Optional particle outline shown when a player enters someone else's claim.
• Dual economy. MultiBank primary with a Vault fallback, resolved asynchronously; mode and priority are configurable.
• Fast and safe storage. SQLite (claims.db) fully loaded into memory for O(1) lookups; all queries use prepared statements and run on a dedicated single-thread database executor.
• Developer API. LandClaimApi is registered in the Bukkit ServicesManager.

Commands

All commands are registered through the Paper Brigadier lifecycle.

Command	Description	Permission
/claim	Claim the chunk you are standing in (opens the selection flow).	none
/claim particles	Toggle claim border particles.	none
/claim select	Add the current chunk to the multi-chunk selection.	none
/claim confirm	Purchase the current selection.	none
/claim cancel	Cancel the current selection/preview.	none
/claim remove	Remove the current chunk from the selection.	none
/claim reserve	Reserve the current chunk.	none
/claim unreserve	Release a reservation on the current chunk.	none
/claim reservations	List your active reservations.	none
/unclaim	Unclaim the chunk you are standing in.	none
/claims	List your claims.	none
/claiminfo	Show information about the current chunk.	none
/trust <player>	Trust a player in the current claim.	none
/untrust <player>	Remove a player's trust in the current claim.	none
/trustall <player>	Trust a player across all your claims.	none
/untrustall <player>	Remove a player's trust across all your claims.	none
/trustlist	List trusted players for the current claim.	none
/claimadmin unclaim	Force-unclaim a chunk.	landclaim.admin
/claimadmin info	Admin claim info.	landclaim.admin
/claimadmin bypass	Toggle protection bypass.	landclaim.admin
/claimadmin reload	Reload the configuration.	landclaim.admin

Permissions

These nodes are checked at runtime (they are not pre-declared in the plugin descriptor, so unregistered nodes default to operators only). The admin node name is configurable via admin.permission.

Node	Description	Default
landclaim.admin	Access to /claimadmin and bypass of claim ownership checks.	op
landclaim.unlimited	Bypass the max-claims per-player limit.	op

Configuration

Key config.yml settings (see the file for the full list and inline comments):

economy:
  mode: AUTO            # AUTO (MultiBank then Vault), MULTIBANK, or VAULT
  priority: ["MULTIBANK", "VAULT"]

claims:
  price: 150000.0
  price-mode: FLAT      # FLAT or MULTIPLIER
  max-claims: 5         # 0 = unlimited
  max-selection: 9
  # Protection starts at this Y. Below it, ANYONE may build/break/open in any claim.
  # Default -64 protects the full vertical column.
  protection-min-y: -64
  reservation:
    enabled: true
    price: 5000.0
    expiry-days: 7
  discounts:
    adjacency-enabled: true
    bulk-enabled: true
    max-discount-rate: 0.25

protection:
  block-explosions: true
  block-fire-spread: true
  block-piston-grief: true
  block-enderman-grief: true
  block-pvp-in-claims: false

Security note on protection-min-y. The shipped default is -64, protecting the full vertical column. If you raise it (e.g. to 30 for a "free mining zone" below claims), be aware that everything below that Y inside any claim becomes unprotected — players can dig into a claim's basement and open chests or break blocks freely, so make sure your players know storage below the line is exposed.

Installation

1. Requires Paper or Purpur 1.21+ and Java 21.
2. Optional companions (see Dependencies): MultiBank, Vault, PlayerSettings.
3. Drop LandClaim-1.0.0.jar into plugins/ and start the server once to generate config.yml.
4. Adjust config.yml (especially claims.price, max-claims and protection-min-y) and run /claimadmin reload.

Dependencies

All integrations are optional (soft dependencies); LandClaim runs without them.

Plugin	Purpose
MultiBank	Primary economy backend (companion plugin).
Vault	Economy fallback when MultiBank is absent.
PlayerSettings	Per-player language resolution (companion plugin).

MultiBank and PlayerSettings are companion plugins by the same author and are not required for the core claim/protection features.

Support / Source

Source and issues: https://github.com/henriquescrrrr/carrageis-landclaim

License

Released under the GNU General Public License v3.0. See LICENSE.