Installation
- 1Download the jar from your account page.
- 2Drop it into plugins/ and restart. There are no dependencies and nothing to configure to get started.
- 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.
- 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 limitRaise 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-allLocked 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
| Command | What it does | Permission |
|---|---|---|
/claim | Open your hearth, or learn how to get one | claimguard.claim |
/claim hearth | Get a Claim Hearth to place | claimguard.claim |
/claim grow (side) (n) | Push the border out — all four sides, or one | claimguard.claim |
/claim shrink (side) (n) | Pull it back in, refunding the fuel | claimguard.claim |
/claim members | Who may build, open chests or open doors | claimguard.trust |
/claim settings | Public access, mobs, PvP, keep-out | claimguard.flags |
/claim border | Draw the edge in particles | claimguard.visualize |
/claim list | Every claim you own, with a teleport | claimguard.teleport |
/claim restore | Rebuild a hearth block that went missing | claimguard.claim |
/claim release | Put the hearth out and free the land | claimguard.claim |
/claimguide | How claiming works on YOUR server, generated live | claimguard.claim |
/trust (player) (level) | access, container, build or manage | claimguard.trust |
/untrust (player) | Remove somebody from the claim | claimguard.trust |
/claiminfo | Owner, size, banked fuel, settings | claimguard.info |
/claimflag (setting) (on|off) | Set one setting without the menu | claimguard.claim |
/claimsof (player) | Staff view of somebody's land | claimguard.admin |
/claimtrust (player) | Staff read and edit of a trust list | claimguard.admin |
/claimpurge | Sweep claims of long-inactive owners | claimguard.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