Skip to content
OrePlugins

ClaimGuard

Land claims your players can understand without reading a wiki.

Product pagev1.0.01.21 through 1.26 · Java 21+

Installation

  1. 1Download the jar from your account page.
  2. 2Drop it into plugins/ and restart. There are no dependencies and nothing to configure to get started.
  3. 3Confirm it started: the log ends with "ClaimGuard 1.0.0 ready (0 claim(s) loaded, 16 fuel type(s), growth mode FUEL)." Those counts are there to be checked against your files — a lower fuel count means a material name in growth.fuel did not match anything on your version, and the lines above say which.
  4. 4Optional: PlaceholderAPI for %claimguard_...% placeholders. Optional: Vault, if you run the claim-block economy.

What your players will do

Nothing needs announcing. Every new player is handed a Claim Hearth on their first join, with the instructions written on the item: place it, and the 17x17 around it is theirs.

They right-click the fire to open the claim — size, members, settings, and a button that draws the border. They feed it coal or logs to make it bigger.

If you would rather hand hearths out yourself, set hearth.give-on-first-join to false. /claim hearth still works, and the item is craftable unless you turn that off too.

How growing is priced

A square claim going from reach r to r + 1 adds exactly 8 x (r + 1) blocks, so a ring gets more expensive as the claim grows without anybody tuning a table: 72 embers to go from 17x17 to 19x19, 136 at 33x33, 264 at 65x65.

One ember buys one block of ground. Coal is worth 8, a coal block 80, a lava bucket 160 — all configurable, and /claimguide shows YOUR values rather than the defaults.

growth:
  mode: FUEL          # FUEL | BLOCKS | EITHER
  refund-percent: 100 # shrinking hands the fuel back
  fuel:
    COAL: 8
    COAL_BLOCK: 80
    LAVA_BUCKET: 160

/claim grow north 3 moves one border; /claim grow 5 moves all four.

How much land one player may hold

hearth:
  starting-reach: 8   # 17x17 to begin with
  max-reach: 48       # no claim reaches further than this (97x97)
  max-claims: 3       # hearths per player; 0 for no limit

Raise either for a rank with a permission — both take the highest node a player holds: claimguard.claims.10 for ten hearths, claimguard.claimblocks.50000 for a bigger quota when you run the claim-block economy.

Worlds

ignored-worlds:            # no claiming at all
  - world_nether
  - world_the_end
require-claims-worlds: []   # unclaimed land protected from everyone
public-unclaimed-worlds: [] # unclaimed land free-for-all

Locked containers

Write [lock] on the first line of a sign attached to a block and it becomes yours alone — trusted members and claim managers included. The owner is stored as a UUID inside the sign, so the visible text is decoration and renaming yourself changes nothing.

Locks work on any block rather than a hard-coded list, which matters for spawners and for whatever your other plugins add.

Placeholders

With PlaceholderAPI installed: %claimguard_claims%, %claimguard_claim_limit%, %claimguard_blocks_used%, %claimguard_blocks_allowance%, %claimguard_here_owner%, %claimguard_here_size%, %claimguard_here_embers%, %claimguard_here_is_mine%, %claimguard_here_claimed%.

Each returns a printable value rather than leaving raw %claimguard_...% text in a scoreboard.

Updating

New config keys are copied in from the jar on start, and the file is only rewritten when something was genuinely missing — your comments and formatting survive. The log names exactly what was added.

The one thing a merge cannot do is add an entry to a LIST you already have, such as the fuel table. Yours is present, so yours wins; new fuel types are called out in the release notes and the boot line tells you how many loaded.

Commands

ClaimGuard commands and permissions
CommandWhat it doesPermission
/claimOpen your hearth, or learn how to get oneclaimguard.claim
/claim hearthGet a Claim Hearth to placeclaimguard.claim
/claim grow (side) (n)Push the border out — all four sides, or oneclaimguard.claim
/claim shrink (side) (n)Pull it back in, refunding the fuelclaimguard.claim
/claim membersWho may build, open chests or open doorsclaimguard.trust
/claim settingsPublic access, mobs, PvP, keep-outclaimguard.flags
/claim borderDraw the edge in particlesclaimguard.visualize
/claim listEvery claim you own, with a teleportclaimguard.teleport
/claim restoreRebuild a hearth block that went missingclaimguard.claim
/claim releasePut the hearth out and free the landclaimguard.claim
/claimguideHow claiming works on YOUR server, generated liveclaimguard.claim
/trust (player) (level)access, container, build or manageclaimguard.trust
/untrust (player)Remove somebody from the claimclaimguard.trust
/claiminfoOwner, size, banked fuel, settingsclaimguard.info
/claimflag (setting) (on|off)Set one setting without the menuclaimguard.claim
/claimsof (player)Staff view of somebody's landclaimguard.admin
/claimtrust (player)Staff read and edit of a trust listclaimguard.admin
/claimpurgeSweep claims of long-inactive ownersclaimguard.admin

Still stuck?

Post in Discord with your server version and the relevant part of the log. That is almost always enough to get a straight answer the same day.

Get help