# Command Reference (Claim)

All commands of CoreEngineClaim. Player commands run via `/claim ...`, team commands via `/claim team ...`, admin commands via `/claim admin ...`. Top-level commands run directly at the root level.

The **Default** column shows the actual value a player has without any special permission grant (`true` = every player can use it, `false` = the right must be granted first). Where "operators only" is noted, server operators get the right automatically without needing a permissions plugin.

## Player Commands

Collective permission: `coreengineclaim.claims` (default: **true** for all players).

| Command | Syntax | Permission | Default | Description |
|---------|--------|-----------|---------|-------------|
| Open GUI | `/claim` or `/claim gui` | `coreengineclaim.claim.gui` | true | Opens the claim management GUI. |
| Abandon claim | `/claim abandon` | `coreengineclaim.claim.abandon` | true | Abandons the current claim and refunds blocks. |
| Abandon all claims | `/claim abandonall` | `coreengineclaim.claim.abandonall` | true | Abandons all your own claims (requires confirmation). |
| List claims | `/claim list` | `coreengineclaim.claim.list` | true | Shows all your own claims in a paginated GUI. |
| Grant build trust | `/claim trust <player>` | `coreengineclaim.claim.trust` | true | Grants a player build access to the claim. |
| Revoke trust | `/claim untrust <player\|all>` | `coreengineclaim.claim.untrust` | true | Revokes access for a player or all trusted players. |
| Grant access trust | `/claim accesstrust <player>` | `coreengineclaim.claim.accesstrust` | true | Grants access to doors and buttons. |
| Grant container trust | `/claim containertrust <player>` | `coreengineclaim.claim.containertrust` | true | Grants access to chests and furnaces. |
| Grant permission trust | `/claim permissiontrust <player>` | `coreengineclaim.claim.permissiontrust` | true | Grants full management rights in the claim. |
| Show trust list | `/claim trustlist` | `coreengineclaim.claim.trustlist` | true | Shows all trusted players in the current claim. |
| Restrict subdivision | `/claim restrictsubclaim` | `coreengineclaim.claim.restrictsubclaim` | true | Subdivision no longer inherits rights from the main claim. |
| Mode: Basic | `/claim basic` | `coreengineclaim.claim.basic` | true | Switches the golden shovel into normal claim mode. |
| Mode: Subdivide | `/claim subdivide` | `coreengineclaim.claim.subdivide` | true | Switches the golden shovel into subdivision mode. |
| Escape claim | `/claim trapped` | `coreengineclaim.claim.trapped` | true | Teleports you out of a foreign claim. |
| Unlock drops | `/claim unlockdrops` | `coreengineclaim.claim.unlockdrops` | true | Allows others to pick up your death drops. |
| Start siege | `/claim siege <player>` | `coreengineclaim.claim.siege` | true | Starts a siege against a player (if enabled). |
| Claim manual | `/claim book` | `coreengineclaim.claim.book` | true | Receives a manual for claim management. |
| Show claims (persistent) | `/claim alwaysshowclaims` | `coreengineclaim.claim.alwaysshowclaims` | false | Toggles the permanent display of claim borders. |
| Show subdivisions (persistent) | `/claim alwaysshowsubdivides` | `coreengineclaim.claim.alwaysshowsubdivides` | false | Toggles the permanent display of subdivision borders. |
| Buy blocks | `/claim blocks buy <amount>` | `coreengineclaim.claim.blocks.buy` | true | Buys bonus claim blocks (price via economy configuration). |
| Sell blocks | `/claim blocks sell <amount>` | `coreengineclaim.claim.blocks.sell` | true | Sells bonus claim blocks. |
| Convert claim to team | `/claim convert` | `coreengineclaim.claim.convert` | true | Converts your own claim to the team. Needs the team rank right "Convert claims" and enough free team claim blocks. |

> **Note:** Unlike all other player commands, `alwaysshowclaims` and `alwaysshowsubdivides` do **not** hang off the collective permission `coreengineclaim.claims` and therefore default to `false`. A server that wants to enable the permanent border display for all players must grant these two rights separately.

---

## Team Commands

Collective permission: `coreengineclaim.teamclaims` (default: **false**, operators have it automatically). The commands `buy`, `blocks`, `info` and `convert` are additionally unlocked for all players independently of this.

| Command | Syntax | Permission | Default | Description |
|---------|--------|-----------|---------|-------------|
| Buy/rent team plot | `/claim team buy` | `coreengineclaim.teamplots.buy` | true | Buys an unassigned subdivision for the player's CoreEngine team; on rental plots this starts the rent. Price: individual override or `Economy.TeamPlotPurchaseCost`. |
| Show/buy team blocks | `/claim team blocks [buy <amount>]` | `coreengineclaim.teamclaims.blocks` | true | Shows the team block pool or buys blocks from the team treasury. The pool funds converted team claims. |
| Show plot info | `/claim team info` | `coreengineclaim.teamclaims.info` | true | Shows the team assignment, effective price and buy/rent mode of a subdivision. |
| Return claim to player | `/claim team convert <player> [force]` | `coreengineclaim.teamclaims.convert` | true | Team owner: returns a team claim to a member. Requires acceptance by the player. |
| Accept assignment | `/claim team accept` | - | true | Accepts the return of a claim from the team. |
| Deny assignment | `/claim team deny` | - | true | Denies the return of a claim from the team. |
| Assign plot to team | `/claim team assign <team>` | `coreengineclaim.teamclaims.assign` | false (operators only) | Admin: assigns the current subdivision to a CoreEngine team. |
| Set assignment (alias) | `/claim team set <team>` | `coreengineclaim.teamclaims.set` | false (operators only) | Alias for `/claim team assign`. |
| Remove assignment | `/claim team clear` | `coreengineclaim.teamclaims.clear` | false (operators only) | Admin: removes the team assignment of a subdivision; a running rent ends. |
| Remove assignment (alias) | `/claim team remove` / `/claim team abandon` | `coreengineclaim.teamclaims.remove` or `.clear` | false (operators only) | Aliases for `/claim team clear`. |
| Show/set price | `/claim team price [<amount>\|default] [buy\|rent]` | `coreengineclaim.teamclaims.price` | false (operators only) | Admin: sets the price and mode (buy or rent) for this subdivision or clears both. |
| Set price (alias) | `/claim team setprice <amount\|default> [buy\|rent]` | `coreengineclaim.teamclaims.setprice` | false (operators only) | Alias for `/claim team price`. |

---

## Admin Commands

Collective permission: `coreengineclaim.admin` (default: **false**, operators have it automatically). Contains all player and team commands plus the following admin-specific commands.

| Command | Syntax | Permission | Default | Description |
|---------|--------|-----------|---------|-------------|
| Open admin GUI | `/claim admin` or `/claim admin gui` | `coreengineclaim.claim.admin.gui` | false (operators only) | Opens the admin management GUI. |
| Perform migration | `/claim admin migrate` | `coreengineclaim.claim.admin.migrate` | false (operators only) | Migrates flatfile data to SQLite. Can also be run from the console. |
| Manage world | `/claim admin world <add\|remove\|list> [world]` | `coreengineclaim.claim.admin.world` | false (operators only) | Adds worlds to GlobalWorldClaims, removes them or lists them. |
| Mode: Admin | `/claim admin mode` | `coreengineclaim.claim.admin.mode` | false (operators only) | Switches the golden shovel into admin claim mode. |
| Restore nature | `/claim admin restore` | `coreengineclaim.claim.admin.restore` | false (operators only) | Activates restore nature mode (returns terrain to its natural state). |
| Restore nature (aggressive) | `/claim admin restoreaggressive` | `coreengineclaim.claim.admin.restoreaggressive` | false (operators only) | Aggressive restore nature mode with extended options. |
| Restore nature (fill) | `/claim admin restorefill` | `coreengineclaim.claim.admin.restorefill` | false (operators only) | Fills holes using restore nature logic. |
| Delete claim | `/claim admin delete` | `coreengineclaim.claim.admin.delete` | false (operators only) | Deletes the claim the admin is standing in. |
| Delete all claims of a player | `/claim admin deleteall <player>` | `coreengineclaim.claim.admin.deleteall` | false (operators only) | Deletes all claims of a specific player. |
| Delete all admin claims | `/claim admin deleteadmin` | `coreengineclaim.claim.admin.deleteadmin` | false (operators only) | Deletes all admin claims. |
| Delete all claims in a world | `/claim admin deleteworld <world>` | `coreengineclaim.claim.admin.deleteworld` | false (operators only) | Deletes all claims in a world. **Console only.** |
| Delete all player claims in a world | `/claim admin deleteuserworld <world>` | `coreengineclaim.claim.admin.deleteuserworld` | false (operators only) | Deletes all player claims (not admin claims) in a world. **Console only.** |
| List claims | `/claim admin list [page]` | `coreengineclaim.claim.admin.list` | false (operators only) | Lists all admin claims in paginated GUIs. |
| Toggle claim bypass | `/claim admin ignore` | `coreengineclaim.claim.admin.ignore` | false (operators only) | Toggles the claim protection bypass for the admin personally. |
| Transfer claim | `/claim admin transfer [player]` | `coreengineclaim.claim.admin.transfer` | false (operators only) | Transfers the current claim to a player or converts it to an admin claim. Claim blocks follow ownership. |
| Reload config | `/claim admin reload` | `coreengineclaim.claim.admin.reload` | false (operators only) | Reloads `config.yml` and `messages.yml` (without a restart). |
| Give manual | `/claim admin book <player>` | `coreengineclaim.claim.admin.book` | false (operators only) | Converts a player's held book into a claim manual. |
| Unlock foreign drops | `/claim admin unlockdrops <player>` | `coreengineclaim.claim.admin.unlockdrops` | false (operators only) | Unlocks a player's death drops. |
| Adjust blocks | `/claim admin blocks adjust <player> <delta>` | `coreengineclaim.claim.admin.blocks.adjust` | false (operators only) | Adjusts a player's bonus claim blocks (e.g. `+100` or `-50`). |
| Adjust blocks for all online players | `/claim admin blocks adjustall <delta>` | `coreengineclaim.claim.admin.blocks.adjustall` | false (operators only) | Adjusts the bonus blocks of all currently online players. |
| Set accrued blocks | `/claim admin blocks setaccrued <player> <amount>` | `coreengineclaim.claim.admin.blocks.setaccrued` | false (operators only) | Sets a player's accrued claim blocks to an exact number. |

---

## Top-Level Commands

These commands do not run under `/claim`, but at the root level.

| Command | Syntax | Permission | Default | Description |
|---------|--------|-----------|---------|-------------|
| Give pet | `/givepet <player>` | - (controlled via `Pets.EnableGivePetCommand`) | true | Gives a pet to another player. |
| Ignore player | `/ignoreplayer` (alias: `/ignore`) | - | true | Ignores a player's chat. |
| Unignore player | `/unignoreplayer` (alias: `/unignore`) | - | true | Stops ignoring a player. |
| Show ignore list | `/ignoredplayerlist` (alias: `/ignorelist`) | - | true | Shows all ignored players. |
| Soft mute | `/softmute <player>` | `coreengineclaim.softmute` or `coreengineclaim.admin` | false (operators only) | Soft-mutes a player (reduces chat spam for others). |
| Separate two players | `/separate <player1> <player2>` | `coreengineclaim.admin` | false (operators only) | Forces two players to permanently ignore each other. |

---

## Important Base Permissions (Functional, Not Command-Specific)

| Permission | Default | Description |
|-----------|---------|-------------|
| `coreengineclaim.createclaims` | true | Allows creating claims. |
| `coreengineclaim.subdivideclaims` | true | Allows creating subdivisions. |
| `coreengineclaim.buysellclaimblocks` | true | Allows buying/selling claim blocks. |
| `coreengineclaim.visualizenearbyclaims` | true | Allows sneak+stick to display all nearby claims. |
| `coreengineclaim.visualizenearbysubdivisions` | true | Allows sneak+bone to display nearby subdivisions. |
| `coreengineclaim.nopvpimmunity` | false | Player gets no post-spawn immunity (and forgoes their own PvP claim protection). |
| `coreengineclaim.siegeimmune` | false | Player cannot be sieged. |
| `coreengineclaim.softmuted` | false | Internal marker for soft mute. |
| `coreengineclaim.adminclaims` | false (operators only) | Manages admin claims and related functions. |
| `coreengineclaim.deleteclaims` | false (operators only) | Deletes foreign claims. |
| `coreengineclaim.ignoreclaims` | false (operators only) | Bypasses all claim protections (`/claim admin ignore`). |
| `coreengineclaim.adjustclaimblocks` | false (operators only) | Adjusts players' claim blocks. |
| `coreengineclaim.transferclaim` | false (operators only) | Transfers claims between players. |
| `coreengineclaim.globalworldclaims` | false (operators only) | Manages GlobalWorldClaims (`/claim admin world`). |
| `coreengineclaim.overrideclaimcountlimit` | false (operators only) | Bypasses the claim limit per player. |
| `coreengineclaim.restorenature` | false (operators only) | Uses restore nature tools. |
| `coreengineclaim.restorenatureaggressive` | false (operators only) | Uses the aggressive restore nature mode. |
| `coreengineclaim.unlockothersdrops` | false (operators only) | Unlocks foreign death drops. |
| `coreengineclaim.eavesdrop` | false (operators only) | Monitors private messages. |
| `coreengineclaim.eavesdropsigns` | false (operators only) | Monitors sign text. |
| `coreengineclaim.seeclaimsize` | false (operators only) | Shows exact claim dimensions in the stick text. |
| `coreengineclaim.seeinactivity` | false (operators only) | Shows the owner's inactivity in the stick text. |
| `coreengineclaim.seeblockhistory` | false (operators only) | Shows CoreProtect block history (investigation tool). |
| `coreengineclaim.notignorable` | false (operators only) | Players cannot ignore or soft-mute this admin. |
| `coreengineclaim.bypass.*` | false (operators only) | Collective right for extended bypasses. |
| `coreengineclaim.rank.<key>` | false | Assigns a player a named tier from `InitialBlocksByGroup`/`AccrualPerHourByGroup` (e.g. `coreengineclaim.rank.vip` via LuckPerms). |
| `coreengineclaim.initialblocks.<number>` | false | Sets the starting claim blocks directly via permission (highest number wins, takes precedence over the named tiers). Example: `coreengineclaim.initialblocks.800`. |
| `coreengineclaim.blocksperhour.<number>` | false | Sets the claim block accrual per hour directly via permission (highest number wins, takes precedence over the named tiers). Example: `coreengineclaim.blocksperhour.150`. |