Claims: Basics

Create, resize, subdivide and abandon claims. Plus tools, the border display, claim-block economy and automatic expiration.

Tools #

Create a claim (two-click flow) #

Mode BASIC (default for everyone):

1. First click with the shovel: the position is stored and a diamond-block marker appears (visible only to you).
2. Second click on a different X/Z position: the server forms the rectangle, validates it and saves on success. The border is visualised.

Sneak+right-click cancels an open first click. The marker disappears on the second click, on cancel, mode switch, putting the shovel away, teleport or logout.

Before creating, the server checks: world claimable (Claims.WorldModes not Disabled, not inside a global world claim), minimum size, overlap, claim limit and available claim blocks.

Geometry #

Claims:
  MinimumWidth: 5          # minimum side length of a top-level claim
  MinimumArea: 25          # minimum area (width × length)
  # Height: claims ALWAYS span the full world build height. The three keys
  # below are only honoured by the automatic chest claim (below); manually
  # created/resized claims ignore them.
  ExtendIntoGroundDistance: 5
  MaximumDepth: 0          # currently no effect (GP compatibility)
  MinimumY: -2147483648    # chest claim only; -2147483648 = no limit
  MinimumYOverrides: {}    # per world: worldName: minimumY

Invalid values are corrected on load (MinimumWidth < 1 → 5, MinimumArea at least MinimumWidth²). Subdivisions are exempt from the minimums and go down to 1×1.

Resize #

No separate command: click a visible claim corner with the shovel (mode BASIC, SUBDIVIDE or ADMIN) and it is treated as a resize (redstone-block marker). The second click drags the corner, the opposite one stays fixed. The new rectangle is fully validated; in BASIC also against available claim blocks.

Who may drag foreign corners: owner or MANAGE trust; SUBDIVIDE only subdivisions; admins with coreengineclaim.adminclaims anywhere.

Subdivisions #

Sub-areas inside a top-level claim with their own trust list (room, shop, team plot). Commands belong to coreengineclaim.claims (default true).

In SUBDIVIDE mode the same two-click flow; the first click picks the parent claim. The subdivision must lie fully inside the parent and must not overlap siblings. It inherits the owner, costs no claim blocks of its own and follows the parent on transfer and deletion.

/claim restrictsubclaim: off (default) = missing trust falls back to the parent; on = only its own trust list counts.

Claims:
  MaximumSubdivisionsPerClaim: 100   # 0 or negative = unlimited

Stick: inspect a claim #

A click on wilderness cancels a running display instantly. Cooldowns: Claims.StickCooldownMillis (500), Claims.SubdivisionVisualizationCooldownMillis (200).

The info actionbar shows more depending on permissions:

Border display #

Pure fake blocks, visible only to you, no client mod needed.

Claims:
  VisualizationDurationSeconds: 30       # then automatic revert
  VisualizationAntiCheatCompatMode: false

Ends instantly on logout, kick, world change or when a new display replaces it. Corners as L shapes, edges as dotted markers every 6 blocks.

Auto-claim for new players #

When a player places their first chest, a claim forms around it automatically.

Claims:
  AutomaticNewPlayerClaimsRadius: 4   # negative = disabled

Happens exactly once per account (never reset), only in Survival/SurvivalRequiringClaims worlds and only if the spot is free. The square forms exactly around the placed block. If claim blocks are short, the difference is credited to the bonus pool, so the auto-claim practically never fails.

Claim-block economy #

Every claim permanently costs its area. Two pools per player: accrued (earned, capped) and bonus (bought/admin, uncapped).

Claims:
  InitialBlocks: 400
  BlocksAccruedPerHour: 100
  MaxAccruedBlocks: 80000
  AccrualIntervalMinutes: 5
  AbandonReturnRatio: 1.0          # < 1.0 subtracts the difference as a penalty
  InitialBlocksByGroup: {}         # e.g. vip: 800
  AccrualPerHourByGroup: {}        # e.g. vip: 150
Economy:
  ClaimBlocksPurchaseCost: 0.0     # <= 0 disables buying
  ClaimBlocksSellValue: 0.0        # <= 0 disables selling

Accrual is recomputed every AccrualIntervalMinutes and on each login from lifetime playtime and never decreases.

Rank bonuses (highest wins):

Buy/sell (children of coreengineclaim.buysellclaimblocks, default true):

Flow: charge money first, then adjust blocks; if step two fails, the money is refunded. Selling cannot push the total below the player's effective starting value.

Admin (children of coreengineclaim.adjustclaimblocks):

Manage & abandon #

/claim abandon asks you to type abandon; in a subdivision it only affects that one. /claim abandonall then requires your exact own name. With AbandonReturnRatio < 1.0 the penalty is subtracted from the accrued pool per claim.

/claim trapped: only inside a foreign claim without ACCESS trust and without combat tag. After 60 s (cancels on movement) it teleports to the nearest free spot, then a 300 s cooldown.

Claims can also be viewed and abandoned in the web interface (/cweb, "Claims" category).

Expiration #

Claims:
  ChestClaimDays: 7      # Tier 1: auto-claims only, WITH refund
  AllClaimDays: 0        # Tier 2: all top-level claims, NO refund; 0 = off
Advanced:
  ClaimExpirationCheckRate: 60   # minutes; <= 0 = task off

For inactive players: Tier 1 refunds the area to the accrued pool, Tier 2 does not. If Tier 1 hits, Tier 2 is skipped that run. Admin claims and subdivisions are never checked directly (subdivisions go with the parent). In Creative worlds deletion also triggers Restore Nature.

Full example config #

Claims:
  InvestigationTool: STICK
  ModificationTool: GOLDEN_SHOVEL
  SubdivisionVisualizationTool: BONE
  StickCooldownMillis: 500
  NearbyClaimRadius: 30
  SubdivisionVisualizationCooldownMillis: 200
  SubdivisionNearbyRadius: 200
  MinimumWidth: 5
  MinimumArea: 25
  MinimumYOverrides:
    world_nether: 127
  AutomaticNewPlayerClaimsRadius: 4
  InitialBlocks: 400
  BlocksAccruedPerHour: 100
  MaxAccruedBlocks: 80000
  AbandonReturnRatio: 1.0
  InitialBlocksByGroup:
    vip: 800
    premium: 1200
  AccrualPerHourByGroup:
    vip: 150
    premium: 200
  ChestClaimDays: 7
  AllClaimDays: 0
  MaximumNumberOfClaimsPerPlayer: 0
  MaximumSubdivisionsPerClaim: 100
  VisualizationDurationSeconds: 30
Economy:
  ClaimBlocksPurchaseCost: 0.0
  ClaimBlocksSellValue: 0.0
Advanced:
  ClaimExpirationCheckRate: 60