Claiming
Chunk Claiming Basics
SimpleClaimSystem uses a chunk-based claiming system. Each Minecraft chunk (16x16 blocks, full height) is the smallest unit of protection. When you claim a chunk, all blocks within it are protected according to your claim's permissions and flags.
A claim is a collection of one or more chunks owned by a player. Each claim has its own name, description, spawn point, permissions, flags, member list, and settings.
Basic claiming
/claimClaims the chunk you are standing in. If the chunk is already claimed by someone else, you cannot claim it. If economy is enabled, the chunk cost is deducted from your balance.
Standing in your own claim? /claim opens that claim's management menu (same as /claim menu). A convenient shortcut — you don't have to remember the menu command.
Claiming with a custom name
/claim create <name>Creates a claim at your current location with a custom name, skipping the default claim-%n template. The name is validated with the exact same rules as /claim setname: it must match claims.allowed-regex-name, respect claims.max-length-name, not collide with the template string, not contain any entry from claims.blocked-words, and not duplicate one of your existing claim names.
Radius claiming
/claim radius <radius>Claims a square area of chunks centered on your current chunk. A radius of 1 claims a 3x3 area (9 chunks), radius 2 claims 5x5 (25 chunks), and so on. The maximum radius is controlled by the scs.limit.radius.<amount> permission or the admin-set limit.
Default radius per player
The default-claim-radius player setting (see Default Player Settings) controls what /claim does with no radius argument. 0 = claim a single chunk. 1+ = claim that radius by default, as if the player had typed /claim radius N. The value is capped server-side at the player's max-radius so a misconfiguration can never bypass the limit.
Unclaiming
/unclaimOpens a GUI to select which claim to delete. When a claim is unclaimed, all protections are removed and the chunks become free. If the claim was purchased, there is no automatic refund.
Multi-Chunk Claims
Claims can consist of multiple chunks. You can expand a claim by adding chunks, or reduce it by removing them.
Adding chunks
/claim addchunk <claim>Adds the chunk you are standing in to the specified claim. The chunk must be unclaimed and (if only-adjacent-chunks is enabled) adjacent to an existing chunk in that claim.
Removing chunks
/claim delchunk <claim>Removes the chunk you are standing in from the specified claim. The chunk becomes unclaimed and unprotected.
Merging claims
/claim merge <claim1> <claim2>Merges two claims into one. All chunks from claim2 are transferred to claim1, and claim2 is deleted. Members, permissions, and flags from claim1 are kept. Both claims must belong to you.
The only-adjacent-chunks setting in config.yml controls whether added chunks must be adjacent to existing claim chunks. When disabled, players can add any unclaimed chunk to any of their claims regardless of distance.
Previewing a Claim
Before spending money or filling a limit, you can preview what /claim would actually take:
/claim preview [radius]- No argument — previews the single chunk you're standing in (or your
default-claim-radiusif set). - With a radius — previews a (2·radius+1)² area centered on you, same as
/claim radius.
Particles are drawn at the edges of each chunk in the area:
- Yellow — free, would be claimed
- Red — already claimed (by you or someone else) and would be skipped
A chat summary shows how many chunks are free vs. taken and the total cost you'd pay. The preview lasts a few seconds and uses packetevents, so other players don't see the particles.
Auto Modes
Auto modes let you perform claiming actions automatically as you walk between chunks, making it efficient to claim large areas.
| Command | Description |
|---|---|
/claim auto-claim [seconds] | Automatically claims each unclaimed chunk you walk into (creates new claims) |
/claim auto-unclaim [seconds] | Automatically unclaims each of your claimed chunks as you walk through them |
/claim auto-addchunk [claim|seconds] | Automatically adds each unclaimed chunk you walk into to the specified claim (or the one at your location if you pass seconds) |
/claim auto-delchunk [claim|seconds] | Automatically removes chunks from the specified claim (or location) as you walk through them |
/claim auto-merge [claim|seconds] | Automatically merges nearby claims as you walk through them |
/claim auto-fly [seconds] | Automatically toggles flight when entering/leaving your claims |
/claim auto-map [seconds] | Automatically displays the claims map when moving between chunks |
Each auto mode is a toggle: run the command once to enable, run it again to disable. Only one auto mode can be active at a time (except auto-fly and auto-map, which can run alongside other modes).
Anti-abuse timer (optional)
Every auto-X command accepts an optional [seconds] argument. When set, the mode automatically turns off after the specified duration, and the player sees a small countdown in the action bar.
/claim auto-claim 60 # auto-claim for 60 seconds
/claim auto-merge mybase 30 # auto-merge into mybase for 30 secondsServer admins can constrain timer values through two per-player settings:
players.default.auto-default-timerinconfig.yml(and the matching permissionscs.limit.auto-default-timer.<n>) sets the default timer applied when the player omits[seconds].0= no timer (legacy behaviour).players.default.auto-max-timer(andscs.limit.auto-max-timer.<n>) sets the maximum duration a player can request.0= no cap.
If a player passes a value above the cap they get an error message and the mode stays off — useful for preventing players from leaving auto-claim running indefinitely.
Auto modes are particularly useful for server administrators or players with large territories. Combined with /claim radius, you can claim vast areas quickly.
Map & Visualization
Two on-demand ways to see claim layouts in-game. The live auto-map sidebar and enter-borders are configured in Configuration.
Claims map — /claim map
Prints a text grid of the nearby chunks in chat, centred on you and colour-coded: your claims, other players' claims, for-sale claims and free chunks each get a distinct colour.
Boundary particles — /claim see
Toggles a particle outline around the claims near you, sent only to you via packetevents — other players see nothing. Use /claim seenear [radius] to outline every claim within a radius at once.