# FAQ

**Version:** 2.0.0 (not released yet)

## For players

### How do I claim land?

Type `/ksclaim`, keep the map on **Claim**, click free chunks and click **Claim**. Or stand on free land and type `/ksclaim claim`. See [Getting Started](./getting-started#4-your-first-claim).

### How big is a chunk, and how high does the protection go?

A chunk is 32 × 32 blocks. A claimed chunk is protected from the bottom of the world to the top.

### Why does my selection make a new claim instead of growing my old one?

A claim only grows with chunks that touch it at an edge, in the same world. Chunks that touch none of your claims start a new claim, as long as you have a claim slot left. With all slots used, the chunks must touch one of your claims.

### Can I merge two of my claims?

No. When chunks touch two of your claims, you choose which one grows. The other one stays a claim of its own, even when they touch afterwards.

### How do I get rid of my last chunk?

Dissolve the claim: **Dissolve** on the **Claims** tab, **Dissolve claim** on the **Settings** tab, or `/ksclaim delete`. Choosing every chunk of a claim in the map mode **Release** asks the same question. Built blocks stay.

### Why can I not release this chunk?

Releasing it would split the claim into two pieces. Release the chunks from the outside in, or dissolve the claim and claim the parts again.

### Where exactly does my claim end?

Click **Show border** or type `/ksclaim border` while you stand in the claim. Golden light pillars glow along the edge for 10 seconds. Only you see them.

### Some chunks on the map have no terrain. Why?

The map takes its colours from the world map images the server already has, and never loads a chunk just for the map. Chunks far away or not explored yet stay dark until their colours are known; they fill in while the window is open. Instance worlds and worlds without a world map always show the flat map, and so does every world when the admin set `display.mapTerrain` to `false`.

### Visitors cannot talk to an NPC that stands in my claim. Why?

Talking to a creature, feeding it and riding it is the right **Feed and ride animals**, and visitors do not have it by default. Tick it for visitors, or make a zone around the NPC where visitors have it.

### How do I let visitors use the door of my shop, but nothing else?

Make a zone of the shop chunks and set **Visitors** · **Doors and gates** to **allowed** there. See [Zones](./rights-and-roles#zones). If visitors may open every door in the claim, tick **Doors and gates** for visitors in the rights table instead.

### Is my claim protected while I am offline?

Yes. The protection does not depend on who is online.

### A trusted player cannot travel to my home.

They need the right **Use the home** (trusted players have it by default) and the claim needs a home. Banned players never get there. If a zone changes **Use the home** at the home's chunk, that rule counts.

### Why is "Flying for trusted people" grey?

The server has not allowed flying in claims. The same goes for **Keep inventory on death**. Ask an admin; both are switches on the **Rules and protection** page of the admin window.

### Can I hand my claim to a friend who is offline?

No. They must be online to get the offer, and they accept with `/ksclaim accept` within 5 minutes. They need enough free quota for all chunks and a free claim slot.

### How do I get more land?

- Ask an admin for bonus chunks or a permission tier.
- With growth switched on, the quota grows with active play time. The **Your quota** box shows when the next chunks come.
- With the economy switched on, buy chunks with `/ksclaim buychunks <amount>`.

### Why can I not hurt a player standing just outside my claim?

Fights between players are checked on both sides. If they are off where you stand or where the other player stands, nobody gets hurt.

### Fire burned my wooden house, and water flowed into my claim. How?

Fire that spreads by itself and flowing water or lava cannot be stopped yet; the game has no hook for them. Lighting a fire and placing water or lava are protected.

### Can I stop monsters from appearing in my claim?

No. The game cannot stop spawns per chunk, so there is no switch for it. Creatures can never break or use blocks in a claim while the admin switch **Creatures break nothing** is on.

### A combat pet hurt someone in my claim.

This is a known gap. It follows once the pet mod hands its hits over to the pet's owner.

### Do members of my guild need a role in my claim?

Not if the claim is guild land. With KyuubiSoft Guilds, `/ksguild land add` in your claim lets guild members use or build there by guild rank, at most what **Trusted** may do. See [Guild land](./rights-and-roles#guild-land).

### Can I open a player shop in someone else's claim?

With Player Shops' option `playerShops.requireClaim` on, only the owner, trusted players, co-owners and guild members who may build there can open a shop in a claim. In a server zone only when the zone allows building.

---

## For admins

### How do I ignore the protection?

`/ksclaimadmin bypass` switches it on until you log out. A note next to the compass reminds you. For a permanent bypass grant `ks.claims.admin.bypass`. Neither bypass changes the rules for fights between players.

### How do I protect the spawn?

Make a server zone: stand in the middle and type `/ksclaimadmin zone create Spawn 3`, or use **New zone from a map selection** on the **Server zones** page. Nobody can claim there, and its rules apply to everyone. See [Server zones](./rights-and-roles#server-zones).

### Can I turn an existing claim into a server zone?

Yes: **Make server zone** on the **Claims** page of the admin window. The claim is dissolved and its chunks become a server zone with the name you give.

### How do I stop claiming in one world?

On the **Rules and protection** page click the world under **Worlds**, or add its name with **Lock world**. In the file it is `general.blockedWorlds`. Land that is claimed there already stays. Instance worlds are always locked.

### I changed config.json and nothing happened.

Run `/ksclaimadmin reload`, or the reload button of the Claims tile in the `/ksadmin` hub. Changes in the admin window apply at once and need no reload.

### How do I switch off the terrain on the claims map?

Set `display.mapTerrain` to `false` in `config.json` and run `/ksclaimadmin reload`. The map in the claims window is then flat, every chunk in its legend colour. The colours of claims on the world map stay.

### Are abandoned claims removed?

Not by default (`decay.days` is `0`). When you set a number of days, claims whose owner and co-owners have not logged in for that long are dissolved once an hour. The countdown starts when you switch it on. The filter **Abandoned** in the admin window lists quiet claims either way.

### A player's quota looks wrong.

Run `/ksclaimadmin quota <player>`. It shows the parts: base, growth, bought, bonus and the maximum. Permission tiers only count while the player is online, and only the values listed in `quota.chunkTiers` and `quota.claimTiers` are tested.

### The economy does not work.

Check the start log: `economy on` needs `economy.enabled: true` in `config.json` and KyuubiSoft Core with a currency its economy bridge can use. Without it, claiming is free and `/ksclaim buychunks` answers `Buying chunks is off on this server.`

### `/ksc` and `/ksca` do not work any more.

They were removed in 2.0.0 because they clashed with chat commands. Use `/ksclaim` (or `/claim`, `/claims`) and `/ksclaimadmin` (or `/claimadmin`).

### Where do I see what was converted from an older Claims version?

In `mods/kyuubisoft_claims/migration-report.txt`, and once on the overview of the admin window. See [Getting Started](./getting-started#3-coming-from-an-older-claims-version).

---

## Error messages

| Message | Why, and what to do |
|---------|---------------------|
| `This chunk already belongs to “...” (...).` | The chunk belongs to someone else |
| `This chunk is already part of your claim “...”.` | You own it already |
| `This is the server zone “...”; nobody can claim here.` | Server zones cannot be claimed |
| `Nobody can claim land in this world.` | The admin locked the world |
| `Nobody can claim land in instance worlds.` | Instance worlds are always locked |
| `Too close to foreign land: keep 2 chunks away.` | The admin set a distance to foreign claims (`quota.bufferChunks`) |
| `The chosen chunks must be connected.` | Pick chunks that touch each other |
| `At most 64 chunks at once.` | Claim in several steps |
| `Not enough quota: 3 free, 9 needed.` | Pick fewer chunks or get more quota |
| `You already have 5 claims, that is the limit.` | Pick chunks that touch one of your claims, or dissolve one |
| `The chunks touch several of your claims (...). Pick one.` | Name the claim that should grow: `/ksclaim claim <name>` |
| `This is the last chunk: dissolve the claim instead.` | Use `/ksclaim delete` |
| `The claim would fall apart into two pieces.` | Release other chunks first |
| `Stand inside a claim for this.` | The command acts on the claim you stand in |
| `Only the claim's owner may do this.` | Releasing, dissolving and handing over are for the owner |
| `Only the owner may do this.` | Co-owners are given, taken and banned by the owner only |
| `You lack the right “Manage people and settings”.` | You may not manage this claim |
| `Nobody called “...” is known.` | The player has never been on the server since Claims runs, or the name is wrong |
| `... must be online to accept.` | Hand over when the player is online |
| `No claim was offered to you (or the offer ran out).` | Offers last 5 minutes |
| `Nothing to confirm – start again.` | The code of `delete` ran out after 60 seconds, or was wrong |
| `The name needs 3 to 24 characters.` | Names of claims, zones and server zones |
| `Names may only use letters, digits, spaces and - ' . , ! ? & ( ) # + :` | Remove other characters |
| `That name is taken.` | You already have a claim (or the claim a zone) with that name |
| `This claim has no home.` | Set one with **Set home here** or `/ksclaim sethome` |
| `The home must lie inside the claim.` | Stand in the claim to set its home |
| `Wait 8 s before travelling again.` | The home cooldown runs |
| `The server has not allowed “...”.` | Flying or keeping the inventory is not allowed by the admin |
| `Buying chunks is off on this server.` | The economy is off |
| `No more: 15 chunks left up to the limit.` | You can only buy up to your maximum |
| `You cannot afford this (...).` | Not enough money for the price |
| `You do not have permission for this.` | A `ks.claims.user.<action>` node is set to `false` for you |