# Claims: Überblick

Das Claim-Modul ist der eingebaute Grundstücksschutz von Mira für Paper- und Folia-Server. Es ist als Drop-in-Ersatz für GriefPrevention 16.18.x gedacht: gleiche Grundkonzepte (goldene Schaufel, Trust-Stufen, Subdivisions, Claim-Blocks, Admin-Claims, Wildnis-Regeln), größtenteils dieselben Config-Keys, aber fest in Mira eingebaut statt eine eigenständige Insel zu sein.

Es muss nichts zusätzlich installiert werden: Das Claim-Modul steckt in der Mira-JAR und ist standardmäßig eingeschaltet (`enabled: true` in `plugins/Mira/modules/claim.yml`). Es nutzt das Wirtschafts-, GUI-, Team- und Nachrichten-System von Mira direkt mit. Das bedeutet: Ein Server, der Mira bereits für Wirtschaft, Teams oder das Web-Interface nutzt, bekommt ein Claim-System, das sich nahtlos einfügt, inklusive Team-Claims, Team-Plots und (bei installiertem CoreProtect) Blockhistorie im Untersuchungswerkzeug.

> **Tipp:** Wer Mira bereits mit LuckPerms, Vault/Economy oder Teams betreibt, muss für das Claim-Modul nichts zusätzlich konfigurieren, die Anbindung erfolgt automatisch beim Serverstart. Wer keine Claims möchte, setzt `enabled: false` in `modules/claim.yml`, die Änderung greift nach einem Neustart.

## Was macht das Claim-Modul?

- **Claimen** - Land mit der goldenen Schaufel per Zwei-Klick-Flow schützen; neue Spieler bekommen beim ersten Kistenplatzieren automatisch einen Startclaim.
- **Schützen** - Blöcke, Container, Redstone, Türen, Tiere, Ernten, Feuer, Explosionen, Kolben und Mob-Grief werden claim-bewusst gefiltert.
- **Teilen** - Fünf Trust-Stufen (`Public`/`Access`/`Container`/`Build`/`Permission`, implizit `Manage` für den Besitzer) plus Subdivisions mit eigener Trust-Liste.
- **Wachsen** - Claim-Blocks kommen über Spielzeit dazu, lassen sich kaufen/verkaufen und begrenzen die Gesamtfläche eines Spielers.
- **Verwalten** - Admin-Claims, Welt-Claims, Restore-Nature, Claim-Transfer, Block-Verwaltung, Claim-Ablauf für inaktive Spieler.
- **Teams** - Subdivisions können einem [Team](teams.md) zugeordnet werden, Teams kaufen Plots in Admin-Land, Team-Ränge steuern Bau- und Verwaltungsrechte.

## Wichtigste Berechtigungen im Überblick

Alle Commands sind einzeln berechtigt, aber über wenige Sammel-Permissions bereits sinnvoll für die üblichen Rollen vorkonfiguriert:

| Permission | Default | Umfang |
|---|---|---|
| `mira.claim.claims` | true | Alle normalen `/claim ...`-Spieler-Commands (Claims erstellen, Trust, Subdivisions, Blocks kaufen/verkaufen, Trapped, Book, …). |
| `mira.claim.teamclaims` | op | Alle `/claim team ...`-Commands, inklusive `mira.claim.teamplots.buy`. |
| `mira.claim.admin` | op | Alle `/claim admin ...`-Commands plus die kompletten Spieler- und Team-Permission-Sets. |

Jede sichtbare Einzelaktion hat zusätzlich einen eigenen Knoten (z. B. `mira.claim.claim.list`, `mira.claim.claim.trust`, `mira.claim.claim.admin.world`), sodass sich über LuckPerms gezielt einzelne Funktionen freigeben oder entziehen lassen, ohne gleich die komplette Sammel-Permission zu vergeben.

## Grundkonzepte in Kürze

- **Claim** - rechteckiger, weltgebundener Bereich mit eindeutiger interner Kennung. Ein Claim ist entweder ein Spieler-Claim (mit Besitzer), ein Admin-Claim (kein Besitzer) oder eine Subdivision (Unterbereich innerhalb eines anderen Claims). Subdivisions können zusätzlich einem Team zugeordnet sein.
- **Trust** - pro Claim gepflegte Liste von Rechten (`NONE` bis `MANAGE`), aufgelöst über explizite Spieler-Einträge, LuckPerms-Gruppen, `public`-Trust und Vererbung von der übergeordneten Subdivision. Details: Seite „Trust und Schutz".
- **Claim-Blocks** - jeder Claim „kostet" seine Fläche (Breite × Länge) in Claim-Blocks; Spieler sammeln Blocks über Spielzeit und können zusätzliche Blocks kaufen. Details: Seite „Claims Grundlagen".
- **Golden-Shovel-Modi** - die goldene Schaufel hat mehrere Modi (Basic, Subdivide, Admin, Restore-Nature-Varianten), umschaltbar über `/claim basic`, `/claim subdivide`, `/claim admin mode` etc.
- **Wildnis** - Land außerhalb jedes Claims folgt globalen Regeln (`Claims.WorldModes`, Feuer, Explosionen, Sky-Tree-Schutz), nicht der claim-spezifischen Trust-Auflösung.
- **Web-Interface** - über das Web-Interface von Mira (`/cweb`) sehen Spieler ihre Claims im Browser (Kategorie „Claims"): Fläche, Koordinaten, Trust-Liste, Claim-Block-Bilanz, und können Claims dort auch aufgeben. Team-Claims erscheinen unter „Teams → Claims".
- **Speicherformat** - Die Claim-Daten werden serverseitig gespeichert. Administratoren können das Speicherformat bei Bedarf mit dem Admin-Command `/claim admin migrate` wechseln.

## Weiterführende Themen

| Thema | Seite |
|---|---|
| Claim-Erstellung, Werkzeuge, Claim-Blocks, Subdivisions, Expiration | Claims: Grundlagen |
| Trust-Stufen, Schutzregeln, Wildnis-Regeln | Trust & Schutz |