# CoreEngineClaim: Overview

CoreEngineClaim is the land claim plugin of the CoreEngine family 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 tightly integrated into CoreEngine instead of being a standalone island.

CoreEngineClaim **requires CoreEngine** to function: it uses its economy, GUI, team and messaging systems directly instead of bringing its own systems. This means a server that already uses CoreEngine for economy, teams or the web interface gets a claim system with CoreEngineClaim that fits in seamlessly, including team claims, team plots and (with CoreProtect installed) block history in the investigation tool.

> **Tip:** Anyone already running CoreEngine with LuckPerms, Vault/Economy or teams does not need to configure anything additional for CoreEngineClaim, the connection happens automatically on server start.

## What Does CoreEngineClaim 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 CoreEngine team, 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 |
|---|---|---|
| `coreengineclaim.claims` | true | All normal `/claim ...` player commands (creating claims, trust, subdivisions, buying/selling blocks, trapped, book, ...). |
| `coreengineclaim.teamclaims` | false | All `/claim team ...` commands, including `coreengineclaim.teamplots.buy`. |
| `coreengineclaim.admin` | false | All `/claim admin ...` commands plus the complete player and team permission sets. |

Every visible individual action additionally has its own node (e.g. `coreengineclaim.claim.list`, `coreengineclaim.claim.trust`, `coreengineclaim.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 CoreEngine 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 CoreEngine'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 |