# Claims: Overview

The claim module is Mira's built-in land protection for Paper and Folia servers. It is intended as a drop-in replacement for GriefPrevention 16.18.x: the same basic concepts (golden shovel, trust levels, subdivisions, claim blocks, admin claims, wilderness rules), largely the same config keys, but built right into Mira instead of being a standalone island.

There is nothing extra to install: the claim module ships inside the Mira JAR and is on by default (`enabled: true` in `plugins/Mira/modules/claim.yml`). It uses Mira's economy, GUI, team and messaging systems directly. This means a server that already uses Mira for economy, teams or the web interface gets a claim system that fits in seamlessly, including team claims, team plots and (with CoreProtect installed) block history in the investigation tool.

> **Tip:** Anyone already running Mira with LuckPerms, Vault/Economy or teams does not need to configure anything additional for the claim module, the connection happens automatically on server start. If you do not want claims, set `enabled: false` in `modules/claim.yml`, the change takes effect after a restart.

## What Does the Claim Module Do?

- **Claiming** - protect land with the golden shovel via a two-click flow; new players automatically get a starter claim when placing their first chest.
- **Protecting** - blocks, containers, redstone, doors, animals, crops, fire, explosions, pistons and mob grief are filtered claim-aware.
- **Sharing** - five trust levels (`Public`/`Access`/`Container`/`Build`/`Permission`, implicit `Manage` for the owner) plus subdivisions with their own trust list.
- **Growing** - claim blocks accrue over playtime, can be bought/sold and limit a player's total area.
- **Managing** - admin claims, world claims, restore nature, claim transfer, block management, claim expiration for inactive players.
- **Teams** - subdivisions can be assigned to a [team](teams.md), teams buy plots in admin land, team ranks control build and management rights.

## Most Important Permissions at a Glance

All commands are individually permissioned, but are already sensibly preconfigured for the usual roles via a few collective permissions:

| Permission | Default | Scope |
|---|---|---|
| `mira.claim.claims` | true | All normal `/claim ...` player commands (creating claims, trust, subdivisions, buying/selling blocks, trapped, book, ...). |
| `mira.claim.teamclaims` | op | All `/claim team ...` commands, including `mira.claim.teamplots.buy`. |
| `mira.claim.admin` | op | All `/claim admin ...` commands plus the complete player and team permission sets. |

Every visible individual action additionally has its own node (e.g. `mira.claim.claim.list`, `mira.claim.claim.trust`, `mira.claim.claim.admin.world`), so individual functions can be specifically granted or revoked via LuckPerms without granting the entire collective permission at once.

## Basic Concepts in Brief

- **Claim** - a rectangular, world-bound area with a unique internal identifier. A claim is either a player claim (with an owner), an admin claim (no owner) or a subdivision (sub-area within another claim). Subdivisions can additionally be assigned to a team.
- **Trust** - a list of rights maintained per claim (`NONE` to `MANAGE`), resolved via explicit player entries, LuckPerms groups, `public` trust and inheritance from the parent subdivision. Details: the "Trust & Protection" page.
- **Claim Blocks** - each claim "costs" its area (width x length) in claim blocks; players accumulate blocks over playtime and can buy additional blocks. Details: the "Claims Basics" page.
- **Golden Shovel Modes** - the golden shovel has several modes (Basic, Subdivide, Admin, Restore Nature variants), switchable via `/claim basic`, `/claim subdivide`, `/claim admin mode` etc.
- **Wilderness** - land outside any claim follows global rules (`Claims.WorldModes`, fire, explosions, sky tree protection), not claim-specific trust resolution.
- **Web Interface** - via Mira's web interface (`/cweb`), players see their claims in the browser (category "Claims"): area, coordinates, trust list, claim block balance, and can also abandon claims there. Team claims appear under "Teams → Claims".
- **Storage Format** - claim data is stored server-side. Administrators can switch the storage format if needed with the admin command `/claim admin migrate`.

## Further Topics

| Topic | Page |
|---|---|
| Claim creation, tools, claim blocks, subdivisions, expiration | Claims: Basics |
| Trust levels, protection rules, wilderness rules | Trust & Protection |