# Command Reference (Claim)

All commands of Mira's claim module. 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, `op` = server operators get the right automatically without needing a permissions plugin, `false` = the right must be granted first.

## Player Commands

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

| Command | Syntax | Permission | Default | Description |
|---------|--------|-----------|---------|-------------|
| Open GUI | `/claim` or `/claim gui` | `mira.claim.claim.gui` | true | Opens the claim management GUI. |
| Abandon claim | `/claim abandon` | `mira.claim.claim.abandon` | true | Abandons the current claim and refunds blocks. |
| Abandon all claims | `/claim abandonall` | `mira.claim.claim.abandonall` | true | Abandons all your own claims (requires confirmation). |
| List claims | `/claim list` | `mira.claim.claim.list` | true | Shows all your own claims in a paginated GUI. |
| Grant build trust | `/claim trust <player>` | `mira.claim.claim.trust` | true | Grants a player build access to the claim. |
| Revoke trust | `/claim untrust <player\|all>` | `mira.claim.claim.untrust` | true | Revokes access for a player or all trusted players. |
| Grant access trust | `/claim accesstrust <player>` | `mira.claim.claim.accesstrust` | true | Grants access to doors and buttons. |
| Grant container trust | `/claim containertrust <player>` | `mira.claim.claim.containertrust` | true | Grants access to chests and furnaces. |
| Grant permission trust | `/claim permissiontrust <player>` | `mira.claim.claim.permissiontrust` | true | Grants full management rights in the claim. |
| Show trust list | `/claim trustlist` | `mira.claim.claim.trustlist` | true | Shows all trusted players in the current claim. |
| Restrict subdivision | `/claim restrictsubclaim` | `mira.claim.claim.restrictsubclaim` | true | Subdivision no longer inherits rights from the main claim. |
| Mode: Basic | `/claim basic` | `mira.claim.claim.basic` | true | Switches the golden shovel into normal claim mode. |
| Mode: Subdivide | `/claim subdivide` | `mira.claim.claim.subdivide` | true | Switches the golden shovel into subdivision mode. |
| Escape claim | `/claim trapped` | `mira.claim.claim.trapped` | true | Teleports you out of a foreign claim. |
| Unlock drops | `/claim unlockdrops` | `mira.claim.claim.unlockdrops` | true | Allows others to pick up your death drops. |
| Start siege | `/claim siege <player>` | `mira.claim.claim.siege` | true | Starts a siege against a player (if enabled). |
| Claim manual | `/claim book` | `mira.claim.claim.book` | true | Receives a manual for claim management. |
| Show claims (persistent) | `/claim alwaysshowclaims` | `mira.claim.claim.alwaysshowclaims` | false | Toggles the permanent display of claim borders. |
| Show subdivisions (persistent) | `/claim alwaysshowsubdivides` | `mira.claim.claim.alwaysshowsubdivides` | false | Toggles the permanent display of subdivision borders. |
| Buy blocks | `/claim blocks buy <amount>` | `mira.claim.claim.blocks.buy` | true | Buys bonus claim blocks (price via economy configuration). |
| Sell blocks | `/claim blocks sell <amount>` | `mira.claim.claim.blocks.sell` | true | Sells bonus claim blocks. |
| Convert claim to team | `/claim convert` | `mira.claim.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 `mira.claim.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: `mira.claim.teamclaims` (default: **op**, 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` | `mira.claim.teamplots.buy` | true | Buys an unassigned subdivision for the player's team; on rental plots this starts the rent. Price: individual override or `Economy.TeamPlotPurchaseCost`. |
| Show/buy team blocks | `/claim team blocks [buy <amount>]` | `mira.claim.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` | `mira.claim.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]` | `mira.claim.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>` | `mira.claim.teamclaims.assign` | op | Admin: assigns the current subdivision to a team. Team chests and team shops of a previous team inside the plot are removed. |
| Set assignment (alias) | `/claim team set <team>` | `mira.claim.teamclaims.set` | op | Alias for `/claim team assign`. |
| Remove assignment | `/claim team clear` | `mira.claim.teamclaims.clear` | op | Admin: removes the team assignment of a subdivision; a running rent ends, the team's chest claims and team shops inside the plot are removed. |
| Remove assignment (alias) | `/claim team remove` / `/claim team abandon` | `mira.claim.teamclaims.remove` or `.clear` | op | Aliases for `/claim team clear`. |
| Show/set price | `/claim team price [<amount>\|default] [buy\|rent]` | `mira.claim.teamclaims.price` | op | 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]` | `mira.claim.teamclaims.setprice` | op | Alias for `/claim team price`. |

---

## Admin Commands

Collective permission: `mira.claim.admin` (default: **op**, 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` | `mira.claim.claim.admin.gui` | op | Opens the admin management GUI. |
| Perform migration | `/claim admin migrate` | `mira.claim.claim.admin.migrate` | op | Migrates flatfile data to SQLite. Can also be run from the console. |
| Manage world | `/claim admin world <add\|remove\|list> [world]` | `mira.claim.claim.admin.world` | op | Adds worlds to GlobalWorldClaims, removes them or lists them. On removal the whole-world claim stays active while team plots still lie in the world. |
| Mode: Admin | `/claim admin mode` | `mira.claim.claim.admin.mode` | op | Switches the golden shovel into admin claim mode. |
| Restore nature | `/claim admin restore` | `mira.claim.claim.admin.restore` | op | Activates restore nature mode (returns terrain to its natural state). |
| Restore nature (aggressive) | `/claim admin restoreaggressive` | `mira.claim.claim.admin.restoreaggressive` | op | Aggressive restore nature mode with extended options; confirmed once in the confirmation GUI, then runs immediately. |
| Restore nature (fill) | `/claim admin restorefill` | `mira.claim.claim.admin.restorefill` | op | Fills holes using restore nature logic. |
| Delete claim | `/claim admin delete` | `mira.claim.claim.admin.delete` | op | Deletes the claim the admin is standing in. |
| Delete all claims of a player | `/claim admin deleteall <player>` | `mira.claim.claim.admin.deleteall` | op | Deletes all claims of a specific player. |
| Delete all admin claims | `/claim admin deleteadmin` | `mira.claim.claim.admin.deleteadmin` | op | Deletes all admin claims. |
| Delete all claims in a world | `/claim admin deleteworld <world>` | `mira.claim.claim.admin.deleteworld` | op | Deletes all claims in a world. **Console only.** |
| Delete all player claims in a world | `/claim admin deleteuserworld <world>` | `mira.claim.claim.admin.deleteuserworld` | op | Deletes all player claims (not admin claims) in a world. **Console only.** |
| List claims | `/claim admin list [page]` | `mira.claim.claim.admin.list` | op | Lists all admin claims in paginated GUIs. |
| Toggle claim bypass | `/claim admin ignore` | `mira.claim.claim.admin.ignore` | false | Toggles the claim protection bypass for the admin personally. |
| Transfer claim | `/claim admin transfer [player]` | `mira.claim.claim.admin.transfer` | op | Transfers the current claim to a player or converts it to an admin claim. Claim blocks follow ownership. Subdivisions move along, a team binding is dropped; subdivisions cannot be transferred on their own. |
| Reload config | `/claim admin reload` | `mira.claim.claim.admin.reload` | op | Reloads `config.yml` and `messages.yml` (without a restart). |
| Give manual | `/claim admin book <player>` | `mira.claim.claim.admin.book` | op | Converts a player's held book into a claim manual. |
| Unlock foreign drops | `/claim admin unlockdrops <player>` | `mira.claim.claim.admin.unlockdrops` | op | Unlocks a player's death drops. |
| Adjust blocks | `/claim admin blocks adjust <player> <delta>` | `mira.claim.claim.admin.blocks.adjust` | op | Adjusts a player's bonus claim blocks (e.g. `+100` or `-50`). |
| Adjust blocks for all online players | `/claim admin blocks adjustall <delta>` | `mira.claim.claim.admin.blocks.adjustall` | op | Adjusts the bonus blocks of all currently online players. |
| Set accrued blocks | `/claim admin blocks setaccrued <player> <amount>` | `mira.claim.claim.admin.blocks.setaccrued` | op | 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>` | `mira.claim.softmute` or `mira.claim.admin` | op | Soft-mutes a player (reduces chat spam for others). |
| Separate two players | `/separate <player1> <player2>` | `mira.claim.admin` | op | Forces two players to permanently ignore each other. |

---

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

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