LandClaim

Minecraft 版本： 26.2

平台： paper purpur

标签： game-mechanics management

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.

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.

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.

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.