LandClaim

Chunk-based land protection for Paper/Purpur 26.3 (Java 25).

Version 2.1.0 · Minecraft 26.3 · 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, entity theft (armor stands, item frames, paintings, minecarts, boats), and cushions: outsiders cannot place, break or sit on them. Placing any entity from an item counts as building, so armor stands, boats and end crystals cannot be set down in someone else's claim. 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 26.3 and Java 25 (2.0.0 runs on 26.2, 1.x on 1.21.x).
2. Optional companions (see Dependencies): MultiBank, Vault, PlayerSettings.
3. Drop LandClaim-2.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.