# Command-Referenz (Claim)

Alle Commands des Claim-Moduls von Mira. Spieler-Commands laufen über `/claim ...`, Team-Commands über `/claim team ...`, Admin-Commands über `/claim admin ...`. Top-Level-Commands laufen direkt auf Wurzelebene.

In der Spalte **Default** steht der tatsächliche Wert, den ein Spieler ohne besondere Rechtevergabe hat: `true` = jeder Spieler kann es nutzen, `op` = Server-Operatoren bekommen das Recht automatisch, ohne dass ein Rechte-Plugin nötig wäre, `false` = das Recht muss erst vergeben werden.

## Spieler-Commands

Sammel-Permission: `mira.claim.claims` (Default: **true** für alle Spieler).

| Command | Syntax | Permission | Default | Beschreibung |
|---------|--------|-----------|---------|-------------|
| GUI öffnen | `/claim` oder `/claim gui` | `mira.claim.claim.gui` | true | Öffnet die Claim-Verwaltungs-GUI. |
| Claim aufgeben | `/claim abandon` | `mira.claim.claim.abandon` | true | Gibt den aktuellen Claim auf und erstattet Blöcke. |
| Alle Claims aufgeben | `/claim abandonall` | `mira.claim.claim.abandonall` | true | Gibt alle eigenen Claims auf (erfordert Bestätigung). |
| Claims auflisten | `/claim list` | `mira.claim.claim.list` | true | Zeigt alle eigenen Claims in einer paginierten GUI. |
| Build-Trust vergeben | `/claim trust <player>` | `mira.claim.claim.trust` | true | Erteilt einem Spieler Bau-Zugriff auf den Claim. |
| Trust entziehen | `/claim untrust <player\|all>` | `mira.claim.claim.untrust` | true | Entzieht einem Spieler oder allen Vertrauten den Zugriff. |
| Access-Trust vergeben | `/claim accesstrust <player>` | `mira.claim.claim.accesstrust` | true | Erteilt Zugriff auf Türen und Knöpfe. |
| Container-Trust vergeben | `/claim containertrust <player>` | `mira.claim.claim.containertrust` | true | Erteilt Zugriff auf Kisten und Öfen. |
| Permission-Trust vergeben | `/claim permissiontrust <player>` | `mira.claim.claim.permissiontrust` | true | Erteilt volle Verwaltungsrechte im Claim. |
| Trust-Liste anzeigen | `/claim trustlist` | `mira.claim.claim.trustlist` | true | Zeigt alle vertrauten Spieler im aktuellen Claim. |
| Subdivision einschränken | `/claim restrictsubclaim` | `mira.claim.claim.restrictsubclaim` | true | Subdivision erbt keine Rechte mehr vom Hauptclaim. |
| Modus: Basic | `/claim basic` | `mira.claim.claim.basic` | true | Wechselt die goldene Schaufel in den normalen Claim-Modus. |
| Modus: Subdivide | `/claim subdivide` | `mira.claim.claim.subdivide` | true | Wechselt die goldene Schaufel in den Subdivision-Modus. |
| Aus Claim befreien | `/claim trapped` | `mira.claim.claim.trapped` | true | Teleportiert dich aus einem fremden Claim heraus. |
| Drops freigeben | `/claim unlockdrops` | `mira.claim.claim.unlockdrops` | true | Erlaubt anderen, deine Death-Drops aufzuheben. |
| Belagerung starten | `/claim siege <player>` | `mira.claim.claim.siege` | true | Startet eine Belagerung gegen einen Spieler (falls aktiviert). |
| Claim-Handbuch | `/claim book` | `mira.claim.claim.book` | true | Erhält ein Handbuch zur Claim-Verwaltung. |
| Claims anzeigen (dauerhaft) | `/claim alwaysshowclaims` | `mira.claim.claim.alwaysshowclaims` | false | Togglet die permanente Anzeige von Claim-Grenzen. |
| Subdivisions anzeigen (dauerhaft) | `/claim alwaysshowsubdivides` | `mira.claim.claim.alwaysshowsubdivides` | false | Togglet die permanente Anzeige von Subdivision-Grenzen. |
| Blocks kaufen | `/claim blocks buy <anzahl>` | `mira.claim.claim.blocks.buy` | true | Kauft Bonus-Claim-Blöcke (Preis über Economy-Konfiguration). |
| Blocks verkaufen | `/claim blocks sell <anzahl>` | `mira.claim.claim.blocks.sell` | true | Verkauft Bonus-Claim-Blöcke. |
| Claim zu Team konvertieren | `/claim convert` | `mira.claim.claim.convert` | true | Konvertiert einen eigenen Claim zum Team. Braucht das Team-Rang-Recht „Convert claims" und genug freie Team-Claim-Blöcke. |

> **Hinweis:** `alwaysshowclaims` und `alwaysshowsubdivides` hängen, anders als alle übrigen Spieler-Commands, **nicht** an der Sammel-Permission `mira.claim.claims` und stehen daher standardmäßig auf `false`. Ein Server, der die dauerhafte Grenzen-Anzeige für alle Spieler freigeben will, muss diese beiden Rechte separat vergeben.

---

## Team-Commands

Sammel-Permission: `mira.claim.teamclaims` (Default: **op**, Operatoren haben sie automatisch). Die Commands `buy`, `blocks`, `info` und `convert` sind davon unabhängig zusätzlich für alle Spieler freigeschaltet.

| Command | Syntax | Permission | Default | Beschreibung |
|---------|--------|-----------|---------|-------------|
| Team-Plot kaufen/mieten | `/claim team buy` | `mira.claim.teamplots.buy` | true | Kauft eine unzugewiesene Subdivision für das Team des Spielers; bei Miet-Plots startet die Miete. Preis: individuelle Überschreibung oder `Economy.TeamPlotPurchaseCost`. |
| Team-Blöcke anzeigen/kaufen | `/claim team blocks [buy <anzahl>]` | `mira.claim.teamclaims.blocks` | true | Zeigt den Team-Block-Pool oder kauft Blöcke aus der Team-Kasse. Der Pool finanziert konvertierte Team-Claims. |
| Plot-Info anzeigen | `/claim team info` | `mira.claim.teamclaims.info` | true | Zeigt Team-Zuordnung, effektiven Preis und Kauf-/Miet-Modus einer Subdivision. |
| Claim zu Spieler zurückgeben | `/claim team convert <player> [force]` | `mira.claim.teamclaims.convert` | true | Team-Owner: gibt einen Team-Claim an ein Mitglied zurück. Erfordert Annahme durch den Spieler. |
| Zuordnung akzeptieren | `/claim team accept` | - | true | Akzeptiert die Rückgabe eines Claim vom Team. |
| Zuordnung ablehnen | `/claim team deny` | - | true | Lehnt die Rückgabe eines Claim vom Team ab. |
| Plot Team zuweisen | `/claim team assign <team>` | `mira.claim.teamclaims.assign` | op | Admin: Weist die aktuelle Subdivision einem Team zu. Team-Kisten und Team-Shops eines bisherigen Teams im Plot werden entfernt. |
| Zuordnung setzen (Alias) | `/claim team set <team>` | `mira.claim.teamclaims.set` | op | Alias für `/claim team assign`. |
| Zuordnung entfernen | `/claim team clear` | `mira.claim.teamclaims.clear` | op | Admin: Entfernt die Team-Zuordnung einer Subdivision; eine laufende Miete endet, Team-Kisten und Team-Shops des Teams im Plot werden entfernt. |
| Zuordnung entfernen (Alias) | `/claim team remove` / `/claim team abandon` | `mira.claim.teamclaims.remove` bzw. `.clear` | op | Aliasse für `/claim team clear`. |
| Preis anzeigen/setzen | `/claim team price [<betrag>\|default] [buy\|rent]` | `mira.claim.teamclaims.price` | op | Admin: Setzt Preis und Modus (Kauf oder Miete) für diese Subdivision oder löscht beides. |
| Preis setzen (Alias) | `/claim team setprice <betrag\|default> [buy\|rent]` | `mira.claim.teamclaims.setprice` | op | Alias für `/claim team price`. |

---

## Admin-Commands

Sammel-Permission: `mira.claim.admin` (Default: **op**, Operatoren haben sie automatisch). Enthält alle Spieler- und Team-Commands sowie folgende Admin-spezifische Commands.

| Command | Syntax | Permission | Default | Beschreibung |
|---------|--------|-----------|---------|-------------|
| Admin-GUI öffnen | `/claim admin` oder `/claim admin gui` | `mira.claim.claim.admin.gui` | op | Öffnet die Admin-Verwaltungs-GUI. |
| Migration durchführen | `/claim admin migrate` | `mira.claim.claim.admin.migrate` | op | Migriert Flatfile-Daten zu SQLite. Auch von der Konsole aufrufbar. |
| Welt verwalten | `/claim admin world <add\|remove\|list> [welt]` | `mira.claim.claim.admin.world` | op | Fügt Welten zu GlobalWorldClaims hinzu, entfernt sie oder listet sie auf. Beim Entfernen bleibt der Welt-Claim aktiv, solange noch Team-Plots in der Welt liegen. |
| Modus: Admin | `/claim admin mode` | `mira.claim.claim.admin.mode` | op | Wechselt die goldene Schaufel in den Admin-Claim-Modus. |
| Restore Nature | `/claim admin restore` | `mira.claim.claim.admin.restore` | op | Aktiviert den Restore-Nature-Modus (bringt Gelände in den natürlichen Zustand zurück). |
| Restore Nature (aggressiv) | `/claim admin restoreaggressive` | `mira.claim.claim.admin.restoreaggressive` | op | Aggressiver Restore-Nature-Modus mit erweiterten Optionen; wird einmal im Bestätigungs-GUI bestätigt und läuft dann sofort. |
| Restore Nature (Füllen) | `/claim admin restorefill` | `mira.claim.claim.admin.restorefill` | op | Füllt Löcher mit Restore-Nature-Logik auf. |
| Claim löschen | `/claim admin delete` | `mira.claim.claim.admin.delete` | op | Löscht den Claim, in dem der Admin steht. |
| Alle Claims eines Spielers löschen | `/claim admin deleteall <player>` | `mira.claim.claim.admin.deleteall` | op | Löscht alle Claims eines bestimmten Spielers. |
| Alle Admin-Claims löschen | `/claim admin deleteadmin` | `mira.claim.claim.admin.deleteadmin` | op | Löscht alle Admin-Claims. |
| Alle Claims einer Welt löschen | `/claim admin deleteworld <welt>` | `mira.claim.claim.admin.deleteworld` | op | Löscht alle Claims einer Welt. **Nur Konsole.** |
| Alle Spieler-Claims einer Welt löschen | `/claim admin deleteuserworld <welt>` | `mira.claim.claim.admin.deleteuserworld` | op | Löscht alle Spieler-Claims (keine Admin-Claims) einer Welt. **Nur Konsole.** |
| Claims auflisten | `/claim admin list [page]` | `mira.claim.claim.admin.list` | op | Listet alle Admin-Claims in paginierten GUIs auf. |
| Claim-Bypass togglen | `/claim admin ignore` | `mira.claim.claim.admin.ignore` | false | Togglet für den Admin persönlich den Claim-Schutz-Bypass. |
| Claim übertragen | `/claim admin transfer [player]` | `mira.claim.claim.admin.transfer` | op | Überträgt den aktuellen Claim auf einen Spieler oder konvertiert ihn zum Admin-Claim. Claim-Blöcke folgen dem Besitz. Subdivisions wechseln mit, eine Team-Zuordnung wird aufgehoben; Subdivisions lassen sich nicht einzeln übertragen. |
| Config neuladen | `/claim admin reload` | `mira.claim.claim.admin.reload` | op | Lädt `config.yml` und `messages.yml` neu (ohne Neustart). |
| Handbuch geben | `/claim admin book <player>` | `mira.claim.claim.admin.book` | op | Konvertiert das gehaltene Buch eines Spielers in ein Claim-Handbuch. |
| Fremde Drops freigeben | `/claim admin unlockdrops <player>` | `mira.claim.claim.admin.unlockdrops` | op | Gibt die Death-Drops eines Spielers frei. |
| Blocks anpassen | `/claim admin blocks adjust <player> <delta>` | `mira.claim.claim.admin.blocks.adjust` | op | Passt die Bonus-Claim-Blöcke eines Spielers an (z. B. `+100` oder `-50`). |
| Alle Online-Spieler Blocks anpassen | `/claim admin blocks adjustall <delta>` | `mira.claim.claim.admin.blocks.adjustall` | op | Passt die Bonus-Blöcke aller gerade online spielenden Spieler an. |
| Erspielte Blocks setzen | `/claim admin blocks setaccrued <player> <anzahl>` | `mira.claim.claim.admin.blocks.setaccrued` | op | Setzt die erspielten Claim-Blöcke eines Spielers auf eine genaue Zahl. |

---

## Top-Level-Commands

Diese Commands laufen nicht unter `/claim`, sondern auf Wurzelebene.

| Command | Syntax | Permission | Default | Beschreibung |
|---------|--------|-----------|---------|-------------|
| Haustier verschenken | `/givepet <player>` | - (gesteuert über `Pets.EnableGivePetCommand`) | true | Gibt ein Haustier an einen anderen Spieler. |
| Spieler ignorieren | `/ignoreplayer` (Alias: `/ignore`) | - | true | Ignoriert den Chat eines Spielers. |
| Ignorieren aufheben | `/unignoreplayer` (Alias: `/unignore`) | - | true | Beendet das Ignorieren eines Spielers. |
| Ignorier-Liste anzeigen | `/ignoredplayerlist` (Alias: `/ignorelist`) | - | true | Zeigt alle ignorierten Spieler. |
| Soft-Mute | `/softmute <player>` | `mira.claim.softmute` oder `mira.claim.admin` | op | Soft-mutet einen Spieler (reduziert Chat-Spam für andere). |
| Zwei Spieler trennen | `/separate <player1> <player2>` | `mira.claim.admin` | op | Zwingt zwei Spieler dauerhaft, sich gegenseitig zu ignorieren. |

---

## Wichtige Basis-Permissions (funktional, nicht command-spezifisch)

| Permission | Default | Beschreibung |
|-----------|---------|-------------|
| `mira.claim.createclaims` | true | Erlaubt, Claims zu erstellen. |
| `mira.claim.subdivideclaims` | true | Erlaubt, Subdivisions zu erstellen. |
| `mira.claim.buysellclaimblocks` | true | Erlaubt, Claim-Blöcke zu kaufen/verkaufen. |
| `mira.claim.visualizenearbyclaims` | true | Erlaubt Sneak+Stick zur Anzeige aller nahegelegenen Claims. |
| `mira.claim.visualizenearbysubdivisions` | true | Erlaubt Sneak+Bone zur Anzeige nahegelegener Subdivisions. |
| `mira.claim.nopvpimmunity` | op | Spieler bekommt keine Post-Spawn-Immunität (und verzichtet auf eigenen PvP-Claim-Schutz). |
| `mira.claim.siegeimmune` | op | Spieler kann nicht belagert werden. |
| `mira.claim.softmuted` | op | Interne Kennzeichnung für Soft-Mute. |
| `mira.claim.adminclaims` | op | Verwaltet Admin-Claims und zugehörige Funktionen. |
| `mira.claim.deleteclaims` | op | Löscht fremde Claims. |
| `mira.claim.ignoreclaims` | op | Umgeht alle Claim-Schutzmaßnahmen (`/claim admin ignore`). |
| `mira.claim.adjustclaimblocks` | op | Passt Claim-Blöcke von Spielern an. |
| `mira.claim.transferclaim` | op | Überträgt Claims zwischen Spielern. |
| `mira.claim.globalworldclaims` | op | Verwaltet GlobalWorldClaims (`/claim admin world`). |
| `mira.claim.overrideclaimcountlimit` | op | Umgeht das Claim-Limit pro Spieler. |
| `mira.claim.restorenature` | op | Nutzt Restore-Nature-Werkzeuge. |
| `mira.claim.restorenatureaggressive` | op | Nutzt den aggressiven Restore-Nature-Modus. |
| `mira.claim.unlockothersdrops` | op | Gibt fremde Death-Drops frei. |
| `mira.claim.eavesdrop` | op | Überwacht private Nachrichten mit. |
| `mira.claim.eavesdropsigns` | op | Überwacht Schild-Texte. |
| `mira.claim.seeclaimsize` | op | Zeigt exakte Claim-Maße im Stick-Text. |
| `mira.claim.seeinactivity` | op | Zeigt die Inaktivität des Besitzers im Stick-Text. |
| `mira.claim.seeblockhistory` | op | Zeigt CoreProtect-Blockhistorie (Untersuchungswerkzeug). |
| `mira.claim.notignorable` | op | Spieler können diesen Admin nicht ignorieren oder softmuten. |
| `mira.claim.bypass.*` | op | Sammel-Recht für erweiterte Bypässe. |
| `mira.claim.rank.<key>` | false | Weist einem Spieler eine benannte Stufe aus `InitialBlocksByGroup`/`AccrualPerHourByGroup` zu (z. B. `mira.claim.rank.vip` über LuckPerms). |
| `mira.claim.initialblocks.<Zahl>` | false | Setzt die Start-Claim-Blöcke direkt per Permission (höchste Zahl gewinnt, Vorrang vor den benannten Stufen). Beispiel: `mira.claim.initialblocks.800`. |
| `mira.claim.blocksperhour.<Zahl>` | false | Setzt den Claim-Block-Zuwachs pro Stunde direkt per Permission (höchste Zahl gewinnt, Vorrang vor den benannten Stufen). Beispiel: `mira.claim.blocksperhour.150`. |