# 🏡 RX_Plots – Spielerdokumentation

> **Stand:** aktueller RX_Plots-Quellstand v0.3.4  
> Diese Anleitung richtet sich ausschließlich an normale Spieler des Minecraft-Netzwerks **Returox**. Admin-, Debug- und Entwicklerfunktionen sind bewusst nicht enthalten.

## 📖 Plugin-Übersicht

**RX_Plots** ist das Grundstücks- und Bauschutzsystem der Returox-Plotwelt. Du kannst dir eigene Plots sichern, andere Spieler hinzufügen, mehrere Plots miteinander verbinden, deinen Plot-Rand gestalten, einen eigenen Spawnpunkt setzen und viele Regeln deines Grundstücks über Menüs einstellen.

Die wichtigsten Befehle sind **`/p`**, **`/plot`** und **`/plots`**. Alle drei öffnen dieselbe Plot-Verwaltung und unterstützen dieselben Unterbefehle.

### So startest du

1. Nutze **`/p`**, um die Plot-Verwaltung zu öffnen.
2. Klicke auf **„Freies Plot finden“** oder stelle dich auf ein freies Plot und nutze **`/p claim`**.
3. Öffne danach **„Meine Plots“**, um zu deinem Grundstück zu teleportieren oder es zu verwalten.
4. Über **„Spieler verwalten“** kannst du Freunde als Mitglied, Vertrauten oder Mitbesitzer hinzufügen.
5. Über **„Einstellungen“** legst du fest, was Besucher auf deinem Plot dürfen.

### Wichtige Grundlagen

- Die aktuelle Standardkonfiguration verwendet **64 × 64 Blöcke pro Plotfläche inklusive Rand**. Die Größe kann serverseitig geändert werden.
- Zwischen den Plots liegen eigene Straßen. Straßen, Kreuzungen, freie Plots und äußere Plot-Ränder sind für normale Spieler geschützt.
- Das Standard-Plotlimit liegt bei **4 physischen Plotflächen**. Dieser Wert kann vom Server angepasst werden.
- Die automatische Suche prüft in der Standardkonfiguration bis zu **2500 Plot-Zellen Radius**; auch dieser Wert ist serverseitig anpassbar.
- Auch Plots, auf denen du **Mitbesitzer** bist, zählen als von dir besessene Plotflächen.
- Ein Merge macht aus mehreren Flächen ein gemeinsames logisches Plot, **verringert aber nicht die Anzahl der beanspruchten physischen Plotflächen**.
- Es gibt **keine Plot-Kaufpreise, kein eigenes Geldsystem, keine Plot-Level und keine Plot-Erfahrungspunkte**.
- Welche Plot-Einstellungen du verändern darfst, hängt von deinem Rang bzw. deinen freigeschalteten Rechten ab. Einstellungen ohne Berechtigung werden im Menü komplett ausgeblendet.

---

## 🛡️ Plot-Rollen und Rechte

Ein Plot kann mehrere Besitzer und verschiedene Spielerrollen haben.

| Rolle | Bauen | Plot verwalten | Besonderheit |
|---|---:|---:|---|
| **Hauptbesitzer** | ✅ | ✅ | Kann das gesamte Plot endgültig löschen und kann nicht entfernt werden. |
| **Mitbesitzer** | ✅ | ✅ | Darf Einstellungen, Spieler, Merge, Rand und Spawnpunkt verwalten. |
| **Vertraut** | ✅ | ❌ | Hat Baurecht, bleibt aber eine eigene Rolle für Besucher- und Teleportregeln. |
| **Mitglied** | ✅ | ❌ | Hat im aktuellen Stand ebenfalls normales Baurecht. |
| **Kein Zugriff** | ❌ | ❌ | Gilt als normaler Besucher und unterliegt den Besucher-Flags. |
| **Gesperrt** | ❌ | ❌ | Darf das Plot nicht betreten. |

> **Mitglied und Vertraut:** Beide Rollen dürfen im aktuellen Stand bauen. Sie bleiben trotzdem getrennte Rollen, weil einige Regeln gezielt zwischen Mitgliedern, Vertrauten und anderen Besuchern unterscheiden können.

### Harter Grundstücksschutz

RX_Plots schützt nicht nur normales Abbauen und Platzieren. Außerhalb einer tatsächlich bebaubaren Plotfläche werden unter anderem auch Straßen, Kreuzungen, freie Plots und Plot-Ränder geschützt. Kolben dürfen keine Flying-Machines über eine Plotgrenze schieben, Flüssigkeiten dürfen nicht in ein anderes Plot laufen und Explosionen dürfen keine Straßen oder fremden Plotblöcke zerstören.

**Aktueller Hinweis:** Der aktuelle Teststand enthält Schutzlogik für indirekten Entity-Schaden durch Explosionen und Feuer. Bei Tieren und Rüstungsständern wurde im laufenden Test jedoch noch nicht in jedem Fall ein zuverlässiger Schutz gegen TNT/Feuer bestätigt. Verlasse dich bei wertvollen Tieren oder Rüstungsständern deshalb momentan nicht ausschließlich auf diesen indirekten Schutz.

---

# 🎮 Alle Spielerfunktionen erklärt

## 🏠 Ein Plot beanspruchen

### Automatisch ein freies Plot finden

Mit **`/p auto`** oder dem Button **„Freies Plot finden“** sucht RX_Plots ein freies Grundstück, beansprucht es und teleportiert dich dorthin.

**Voraussetzungen:**

- Du darfst dein Plotlimit noch nicht erreicht haben.
- Es muss eine Plotwelt verfügbar sein.
- Es muss innerhalb des Suchbereichs ein freies Plot vorhanden sein.

**Beispiel:**

```text
/p auto
```

### Das Plot unter dir beanspruchen

Wenn du bereits auf einem freien Plot stehst, kannst du es mit **`/p claim`** übernehmen.

```text
/p claim
```

Auf Straßen oder Kreuzungen funktioniert der Befehl nicht.

---

## 🧭 Eigene Plots finden und teleportieren

### Meine Plots

Mit **`/p list`** oder über **„Meine Plots“** siehst du deine logischen Plots in deiner persönlichen Reihenfolge. Ein großer Merge-Verbund erscheint dabei nur einmal.

### Zum Plot teleportieren

```text
/p home
```

teleportiert dich zu deinem Plot auf Position **#1**.

Du kannst auch ein anderes Plot auswählen:

```text
/p home 2
/p home Lager
/p home 3,-2
```

Als Auswahl funktionieren:

- eine Nummer aus deiner persönlichen Reihenfolge, z. B. `2`
- dein persönlicher Plotname
- eine Plot-ID im Format `x,z`, `x;z` oder `x:z`

Ist auf dem Plot ein eigener Spawnpunkt gespeichert, wird dieser verwendet. Sonst landest du in der normalen Plotmitte.

> **Hinweis zu mehrteiligen Namen:** Beim eigenen `/p home <Name>` wird im aktuellen Stand nur ein Befehlsargument als Name ausgewertet. Für Namen mit Leerzeichen solltest du deshalb das Menü oder die Plotnummer verwenden.

---

## 🎯 In die tatsächliche Plotmitte teleportieren

Mit **`/p middle`** teleportierst du dich in die geometrische Mitte des gesamten Plot-Verbunds, auf dem du gerade stehst.

```text
/p middle
```

Das ist besonders praktisch bei gemergten Plots. Der mit `/p sethome` gespeicherte Spawnpunkt wird dabei absichtlich ignoriert.

Bei unregelmäßigen Merge-Formen sucht RX_Plots einen gültigen Punkt innerhalb der verbundenen Fläche, falls die rechnerische Mitte in einer Lücke liegen würde.

---

## 👋 Andere Spieler besuchen

Mit **`/p visit <spieler>`** besuchst du das erste Plot eines anderen Spielers.

```text
/p visit Aron
/p visit Aron 2
/p visit Aron Shop
```

Du kannst wie bei `/p home` eine Plotnummer, Plot-ID oder den persönlichen Plotnamen des Zielspielers angeben.

Der Plotbesitzer kann Teleports für bestimmte Besuchergruppen über eine Flag einschränken.

---

## ℹ️ Plot-Informationen ansehen

Mit **`/p info`** erhältst du Informationen über das Plot, auf dem du gerade stehst.

Angezeigt werden unter anderem:

- Plot-ID und Welt
- persönlicher Plotname, falls du selbst Besitzer bist und einen Namen gesetzt hast
- Hauptbesitzer und Anzahl der Besitzer
- Anzahl Mitglieder, Vertraute und gesperrte Spieler
- optionale Plotbeschreibung
- wichtige Schalter wie PvP, Explosionen, Feuer und Containerzugriff
- Anzahl zusammengefasster Plotflächen

Der Besitzer kann die Informationen für Besucher über die Einstellung **„Plot-Info verstecken“** ausblenden.

---

## 🏷️ Persönlichen Plotnamen vergeben

Jeder Besitzer kann demselben Plot **seinen eigenen persönlichen Namen** geben. Ein Mitbesitzer kann das gemeinsame Plot also anders benennen als du.

```text
/p name Lager
/p name Mein Shop
/p name reset
```

Der Name ist auf **32 Zeichen** begrenzt. Längere Eingaben werden auf 32 Zeichen gekürzt.

Der persönliche Name wird in deiner Plotliste angezeigt und kann als Teleport-Auswahl verwendet werden.

---

## 📍 Plot-Spawnpunkt setzen

Mit **`/p sethome`** speicherst du deine aktuelle Position und Blickrichtung als gemeinsamen Spawnpunkt des logischen Plots.

```text
/p sethome
```

Du musst dich dabei auf demselben Plot oder einem Teil des verbundenen Merge-Verbunds befinden.

Danach verwenden `/p home`, `/p visit` und der Teleport-Button diesen Punkt.

> Der Spawnpunkt gehört zum Plot-Verbund und ist nicht für jeden Besitzer getrennt. Setzt ein Mitbesitzer einen neuen Spawnpunkt, ändert sich das Ziel für alle Besucher des Plots.

---

## 🔢 Persönliche Plot-Reihenfolge

Über **`/p order`** kannst du festlegen, welches deiner Plots #1, #2, #3 usw. ist.

Im Menü stehen diese Aktionen zur Verfügung:

- **Auf Platz #1**
- **Eine Position nach vorne**
- **Eine Position nach hinten**
- **Ans Ende**

Die Reihenfolge ist **pro Besitzer getrennt**. Dein Mitbesitzer kann denselben Plot bei sich an einer anderen Position einsortieren.

`/p home` ohne Nummer verwendet immer dein Plot #1.

---

## 👥 Spieler verwalten

Öffne auf deinem Plot **`/p players`** oder klicke im Plot-Menü auf **„Spieler verwalten“**.

Das Menü zeigt:

- Besitzer des Plots
- bereits eingetragene Mitglieder, Vertraute und gesperrte Spieler
- aktuell online befindliche Spieler

Klicke einen Spieler an. Danach kannst du gezielt eine Rolle auswählen:

- Kein Zugriff
- Mitglied
- Vertraut
- Mitbesitzer
- Gesperrt

Der aktuelle Status wird im Rollenmenü markiert. Dadurch kannst du einen Vertrauten auch wieder zu einem normalen Mitglied machen.

Der **Hauptbesitzer** kann nicht herabgestuft oder entfernt werden.

### Spieler per Befehl verwalten

```text
/p add <spieler>
/p trust <spieler>
/p deny <spieler>
/p remove <spieler>
```

Für Mitbesitzer:

```text
/p owner add <spieler>
/p owner remove <spieler>
```

Die Befehle sind besonders hilfreich, wenn ein Offline-Spieler nicht im Inventarmenü angezeigt wird.

---

## 🧱 Plot-Umrandung ändern

Mit **`/p border`** öffnest du die Materialauswahl für die äußere Umrandung des Plots.

Der Rand liegt **einen Block über der Plot-Oberfläche**. Bei einem Merge wird die Außenkontur des gesamten Verbunds verwendet; innere Trennlinien bleiben entfernt.

Im Menü stehen die vom Server freigegebenen Randmaterialien alphabetisch zur Auswahl.

Alternativ kannst du ein Material direkt angeben:

```text
/p border QUARTZ_BLOCK
/p border STONE_BRICK_SLAB
/p border reset
```

`reset` stellt das Standardmaterial der Welt wieder her.

**Tipp:** Für normale Spieler ist das Inventarmenü einfacher, weil dort nur geeignete freigegebene Materialien angezeigt werden.

---

## 🔗 Plots verbinden (Merge)

Mehrere direkt nebeneinanderliegende Plots können zu einer gemeinsamen Fläche verbunden werden.

### Voraussetzungen

- Die Plots müssen direkt aneinandergrenzen.
- Du musst beide Plots verwalten dürfen.
- Beide Plots müssen **exakt denselben Besitzerkreis** haben.
- Bereits verbundene Plots können nicht nochmals in derselben Richtung verbunden werden.

### Manuell verbinden

```text
/p merge north
/p merge east
/p merge south
/p merge west
```

Deutsch funktioniert ebenfalls, z. B. `nord`, `osten`, `süd`, `westen`.

Beim Merge wird die Straße zwischen den Plots entfernt. Die ehemalige Straßenfläche gehört anschließend zur gemeinsamen bebaubaren Plotfläche. Die Außenumrandung wird um den gesamten Verbund gelegt.

### Automatisch verbinden

```text
/p merge auto
```

RX_Plots sucht rekursiv alle direkt angrenzenden Plots mit exakt demselben Besitzerkreis und verbindet alle passenden inneren Kanten.

Nach dem Merge:

- erscheint der Verbund in „Meine Plots“ nur noch einmal
- `/p home` und `/p visit` behandeln den Verbund als ein Plot
- `/p middle` benutzt die Mitte des gesamten Verbunds
- Rand, Spawnpunkt und Verwaltung beziehen sich auf das logische Gesamtplot

### Verbindung wieder trennen

Eine einzelne Richtung trennst du mit:

```text
/p unmerge north
/p unmerge east
/p unmerge south
/p unmerge west
```

Die Straße an dieser Verbindung wird wiederhergestellt.

### Nur das Plot unter dir aus einem Merge lösen

```text
/p unmerge this
```

Du musst dabei direkt auf der physischen Plotfläche stehen. Das ausgewählte Teilplot verliert alle eigenen Merge-Verbindungen. Die übrigen Plots behalten ihre Verbindungen untereinander, soweit sie bereits bestanden.

---

## 🧹 Plot leeren

Mit **`/p clear`** öffnest du zuerst ein Bestätigungsmenü.

Beim endgültigen Leeren:

- werden die Blöcke des gesamten logischen Plot-Verbunds auf den Grundzustand zurückgesetzt
- werden Nicht-Spieler-Entities auf der betroffenen Fläche entfernt
- bleibt der Merge bestehen
- bleiben Besitzer und Spielerrollen bestehen
- bleiben Flags erhalten
- bleiben Plotname und Plot-Spawnpunkt erhalten

Direkte Bestätigung per Befehl:

```text
/p clear confirm
```

> **Achtung:** Gebaute Blöcke und Entities auf der Plotfläche gehen beim Leeren verloren.

---

## 🗑️ Plot löschen

Mit **`/p delete`** öffnest du ein Bestätigungsmenü. Nur der **Hauptbesitzer** kann ein Plot endgültig löschen.

```text
/p delete confirm
```

Beim Löschen wird das Plot zuerst zurückgesetzt und anschließend vollständig freigegeben.

Bei einem Merge wird **der gesamte logische Merge-Verbund gelöscht**. Dazu gehören auch alle verbundenen physischen Plotflächen. Ehemalige Straßen werden wiederhergestellt.

Gelöscht werden unter anderem:

- Besitzer und Mitbesitzer
- Mitglieder, Vertraute und Sperren
- Plot-Einstellungen
- persönlicher Plotname
- Plot-Spawnpunkt
- Merge-Verbindungen

> **Achtung:** Löschen ist deutlich umfassender als `/p clear`.

---

# 🚩 Plot-Einstellungen und Flags

Flags sind Regeln für dein Grundstück. Über **`/p settings`** öffnest du die Einstellungsübersicht.

Du siehst nur Kategorien und Flags, die dein Rang tatsächlich ändern darf. Fehlt eine Einstellung vollständig, ist sie für dich auf dem Server nicht freigeschaltet.

## Bedienung der Flag-Menüs

- **Ein/Aus-Flags:** normal anklicken, um umzuschalten.
- **Auswahl- oder Zahlenflags:** anklicken, um durch übliche Werte zu wechseln. Beliebige gültige Werte können per Befehl gesetzt werden.
- **Textflags:** das Menü zeigt den passenden `/p flag ...`-Befehl an.
- **Materiallisten (`break`, `place`, `use`):** öffnen einen eigenen Materialeditor.

Es gibt keine besondere Rechtsklick- oder Shift-Klick-Funktion bei den normalen Plot-Menüs. Ein normaler Klick reicht aus.

## 🧱 Materialeditor für `break`, `place` und `use`

Bei diesen drei Flags kannst du Besucher gezielt für einzelne Blockarten freischalten.

Im Materialeditor kannst du:

1. ein bereits ausgewähltes Material anklicken, um es zu entfernen
2. unten in deinem eigenen Inventar auf einen Block klicken, um dessen Material hinzuzufügen
3. **„Material auswählen“** unten rechts öffnen
4. alle Blockmaterialien alphabetisch durchblättern
5. Materialien durch Anklicken an- oder abwählen
6. die gesamte Materialliste leeren

Das angeklickte Item aus deinem Inventar wird dabei **nicht verbraucht und nicht verschoben**.

**Fortgeschritten:** Über den Befehl können `break`, `place` und `use` auch als kommagetrennte Materialliste gesetzt werden. Unterstützt werden außerdem gültige Vanilla-Block-Tags mit `#`, z. B. ein passender Block-Tag statt vieler Einzelmaterialien.

---

## 🧱 Bau-Flags

| Flag | Wirkung | Standard |
|---|---|---|
| `break` | Liste von Blockarten, die normale Besucher abbauen dürfen. | keine Materialien |
| `place` | Liste von Blockarten, die normale Besucher platzieren dürfen. | keine Materialien |
| `redstone` | Aktiviert oder deaktiviert Redstone-Signale auf dem Plot. | an |
| `disable-physics` | Unterbindet Blockphysik innerhalb des Plots. | aus |
| `concrete-harden` | Erlaubt, dass Betonpulver durch Wasser zu Beton wird. | an |
| `tile-drop` | Legt fest, ob abgebaute Blöcke Items droppen. | an |

## 🔧 Interaktions-Flags

| Flag | Wirkung | Standard |
|---|---|---|
| `use` | Liste von Blockarten, die Besucher benutzen dürfen. | keine Materialien |
| `edit-sign` | Besucher dürfen Schilder bearbeiten. | aus |
| `device-interact` | Besucher dürfen Geräte wie Türen, Knöpfe, Hebel, Falltüren und Gates bedienen. | aus |
| `lectern-read-book` | Besucher dürfen Bücher aus Lesepulten nehmen. | aus |
| `container-use` | Besucher dürfen Container öffnen. | aus |

`use` ist eine gezielte Ausnahme: Ist z. B. eine bestimmte Tür in der `use`-Liste, darf ein Besucher diesen Block benutzen, auch wenn die allgemeinere Geräteeinstellung nicht freigeschaltet ist.

---

## ⚔️ Kampf-Flags

| Flag | Wirkung | Standard |
|---|---|---|
| `pvp` | Erlaubt Schaden zwischen Spielern auf demselben Plot. | aus |
| `pve` | Erlaubt Besuchern allgemein, Entities anzugreifen. | aus |
| `invincible` | Spieler erhalten auf dem Plot keinen Schaden. | aus |
| `keep-inventory` | Spieler behalten beim Tod auf dem Plot ihr Inventar. | aus |
| `projectiles` | Besucher dürfen Projektile wie Pfeile oder Tridents verwenden. | aus |
| `projectile-change-block` | Projektile dürfen Blöcke verändern. | aus |
| `fishing` | Besucher dürfen eine Angel benutzen. Diese Flag ist unabhängig von `projectiles`. | aus |
| `instabreak` | Besitzer/Mitglieder/Vertraute bauen in Survival sofort ab. | aus |

---

## 🐄 Entity-Flags

Diese Regeln betreffen in erster Linie **Besucher ohne Baurecht**. Besitzer, Mitbesitzer, Mitglieder und Vertraute haben bei vielen direkten Interaktionen einen Baurechts-Bypass.

| Flag | Wirkung | Standard |
|---|---|---|
| `animal-attack` | Besucher dürfen Tiere angreifen. | aus |
| `animal-interact` | Besucher dürfen mit Tieren interagieren. | aus |
| `hostile-attack` | Besucher dürfen Monster angreifen. | aus |
| `hostile-interact` | Besucher dürfen mit Monstern interagieren. | aus |
| `tamed-attack` | Besucher dürfen gezähmte Tiere angreifen. | aus |
| `tamed-interact` | Besucher dürfen mit gezähmten Tieren interagieren. | aus |
| `villager-interact` | Besucher dürfen mit Dorfbewohnern handeln bzw. interagieren. | aus |
| `player-interact` | Erlaubt Besucher-Interaktionen mit Spielern. | aus |
| `hanging-break` | Besucher dürfen Bilder und Rahmen entfernen. | aus |
| `hanging-place` | Besucher dürfen Bilder und Rahmen platzieren. | aus |
| `misc-break` | Besucher dürfen sonstige Entities, z. B. Rüstungsständer, entfernen. | aus |
| `misc-place` | Besucher dürfen sonstige Entities, z. B. Rüstungsständer, platzieren. | aus |
| `misc-interact` | Besucher dürfen mit sonstigen Entities interagieren. | aus |
| `vehicle-break` | Besucher dürfen Fahrzeuge entfernen. | aus |
| `vehicle-place` | Besucher dürfen Boote, Minecarts usw. platzieren. | aus |
| `vehicle-use` | Besucher dürfen Fahrzeuge benutzen. | aus |
| `entity-change-block` | Erlaubt Entities allgemein, Blöcke zu verändern. | aus |
| `mob-break` | Erlaubt Mobs, Blöcke zu zerstören. | aus |
| `mob-place` | Erlaubt Mobs, Blöcke zu platzieren. | aus |

---

## 🌱 Wachstums- und Natur-Flags

| Flag | Wirkung | Standard |
|---|---|---|
| `crop-grow` | Feldfrüchte und allgemeines Pflanzenwachstum. | an |
| `grass-grow` | Gras darf sich ausbreiten. | an |
| `kelp-grow` | Kelp darf wachsen. | an |
| `mycel-grow` | Myzel darf sich ausbreiten. | an |
| `vine-grow` | Ranken dürfen wachsen. | an |
| `coral-dry` | Korallen dürfen austrocknen. | aus |
| `copper-oxide` | Ungewachstes Kupfer darf oxidieren. | aus |
| `leaf-decay` | Blätter dürfen zerfallen. | an |
| `ice-form` | Wasser darf zu Eis gefrieren. | aus |
| `ice-melt` | Eis darf schmelzen. | aus |
| `snow-form` | Schnee darf entstehen. | aus |
| `snow-melt` | Schnee darf schmelzen. | an |
| `soil-dry` | Ackerboden darf vollständig austrocknen. | aus |

---

## 🌍 Welt- und Umgebungs-Flags

| Flag | Wirkung | Standard / Werte |
|---|---|---|
| `explosions` | Explosionen dürfen Blöcke innerhalb desselben logischen Plots beschädigen. Plotgrenzen bleiben geschützt. | aus |
| `fire-spread` | Allgemeiner zusätzlicher Schalter für Feuerverhalten. | aus |
| `block-burn` | Blöcke dürfen durch Feuer verbrennen. | aus |
| `block-ignition` | Blöcke dürfen sich entzünden. | an |
| `beacon-effects` | Beacon-Effekte dürfen auf Entities auf dem Plot angewendet werden. | an |
| `liquid-flow` | Steuert Flüssigkeitsfluss innerhalb des Plots. Über Plotgrenzen fließen Flüssigkeiten trotzdem nicht. | `default`, `true`, `false` |
| `weather` | Persönliches Wetter beim Betreten. | `default`, `clear`, `rain` |
| `time` | Persönliche Uhrzeit beim Betreten. | `-1` = Standard, sonst 0–24000 |
| `gamemode` | Spielmodus für Besitzer, Mitglieder und Vertraute beim Betreten. | `none`, `survival`, `creative`, `adventure`, `spectator` |
| `guest-gamemode` | Spielmodus für normale Besucher beim Betreten. | `none`, `survival`, `creative`, `adventure`, `spectator` |

Beim Verlassen werden persönliche Uhrzeit und Wetter zurückgesetzt. Ein durch die Plotregel geänderter Spielmodus wird auf den vorherigen Spielmodus zurückgestellt.

---

## 🚪 Besucher- und Zugangs-Flags

| Flag | Wirkung | Standard / Werte |
|---|---|---|
| `untrusted-visit` | Legt fest, ob normale unvertraute Besucher das Plot betreten dürfen. | an |
| `deny-exit` | Verhindert bei Nicht-Besitzern das Verlassen des Plots. | aus |
| `deny-portals` | Verhindert das Erstellen von Portalen auf dem Plot. | aus |
| `deny-portal-travel` | Verhindert Dimensionswechsel über Portale vom Plot aus. | aus |
| `drop-protection` | Besucher dürfen Drops auf dem Plot nicht aufnehmen. | aus |
| `item-drop` | Spieler dürfen Items auf dem Plot fallen lassen. | an |
| `fly` | Erlaubt Flug auf dem Plot. Beim Verlassen wird der vorherige Flugstatus wiederhergestellt. | aus |
| `forcefield` | Hält Besucher davon ab, sich Buildern auf dem Plot stark zu nähern. | aus |
| `deny-teleport` | Sperrt Plot-Teleports für ausgewählte Rollen. | `none`, `members`, `nonmembers`, `trusted`, `nontrusted`, `nonowners` |

### Werte von `deny-teleport`

| Wert | Wer wird vom Plot-Teleport ausgeschlossen? |
|---|---|
| `none` | niemand zusätzlich |
| `members` | Mitglieder |
| `nonmembers` | Spieler, die weder Mitglied, Vertraut noch Besitzer sind |
| `trusted` | Vertraute |
| `nontrusted` | normale Besucher und Mitglieder; Vertraute/Besitzer bleiben erlaubt |
| `nonowners` | alle außer Besitzern |

---

## 💬 Anzeige- und Nachrichten-Flags

| Flag | Wirkung | Standard |
|---|---|---|
| `notify-enter` | Online-Besitzer erhalten eine Nachricht, wenn jemand das Plot betritt. | aus |
| `notify-leave` | Online-Besitzer erhalten eine Nachricht, wenn jemand das Plot verlässt. | aus |
| `hide-info` | Verbirgt `/p info` vor Nicht-Besitzern. | aus |
| `titles` | Aktiviert oder deaktiviert den eingestellten Plot-Titel beim Betreten. | `default` |
| `description` | Freier Beschreibungstext, der in `/p info` angezeigt wird. | leer |
| `greeting` | Chat-Nachricht beim Betreten. | leer |
| `farewell` | Chat-Nachricht beim Verlassen. | leer |
| `plot-title` | Titel und optionaler Untertitel beim Betreten. | leer |

Für `plot-title` trennt ein `|` Titel und Untertitel, z. B.:

```text
/p flag plot-title Willkommen|Viel Spaß auf meinem Plot!
```

Damit der Titel eingeblendet wird, muss zusätzlich `titles` auf `true` stehen.

---

## 📊 Entity-Limits

Alle Limits akzeptieren Werte von **-1 bis 10000**. `-1` bedeutet unbegrenzt bzw. keine zusätzliche Begrenzung.

| Flag | Wirkung | Standard |
|---|---|---|
| `animal-cap` | Maximale Anzahl Tiere. | -1 |
| `entity-cap` | Maximale Anzahl aller gezählten Nicht-Spieler-Entities. | -1 |
| `hostile-cap` | Maximale Anzahl Monster. | -1 |
| `misc-cap` | Maximale Anzahl sonstiger Entities. | -1 |
| `mob-cap` | Maximale Anzahl Tiere + Monster. | -1 |
| `vehicle-cap` | Maximale Anzahl Fahrzeuge. | -1 |

Ist ein Limit erreicht, werden passende neue Entities nicht mehr normal hinzugefügt. Rüstungsständer werden beim Platzieren separat geprüft und nicht direkt durch den allgemeinen Spawn-Cap abgewiesen.

---

## ✨ Weitere umgesetzte Flags

| Flag | Wirkung | Standard / Eingabe |
|---|---|---|
| `prevent-creative-copy` | Verhindert bei Besuchern das Creative-Pick-Item-Kopieren auf dem Plot. | aus |
| `weaving-death-place` | Erlaubt das Platzieren von Spinnweben durch den Weaving-Effekt beim Tod. | aus |
| `blocked-cmds` | Kommagetrennte Liste von Befehlen, die für Besucher auf dem Plot gesperrt sind. | leer |
| `music` | Spielt beim Betreten den Sound einer Musikdisc und stoppt ihn beim Verlassen. | leer |
| `feed` | Erhöht regelmäßig den Hungerwert. Eingabe: `<sekunden> <menge>`; das Intervall muss mindestens 1 Sekunde betragen. | aus |
| `heal` | Heilt regelmäßig. Eingabe: `<sekunden> <menge>`; das Intervall muss mindestens 1 Sekunde betragen. | aus |

Beispiele:

```text
/p flag blocked-cmds home,spawn
/p flag music cat
/p flag feed 10 2
/p flag heal 15 1
```

---

## ⌨️ Flags per Befehl ändern

Grundform:

```text
/p flag <flag> <wert>
```

Boolean-Beispiele:

```text
/p flag pvp on
/p flag pvp off
/p flag fishing true
/p flag explosions false
```

Zurücksetzen auf den Standardwert:

```text
/p flag pvp reset
```

Bei einem Ein/Aus-Flag reicht auch:

```text
/p flag pvp
```

Dann wird der aktuelle Wert umgeschaltet.

Bei `break`, `place` und `use` öffnet `/p flag <flag>` direkt den Materialeditor.

---

# ⌨️ Vollständige Befehlsübersicht für Spieler

Alle Befehle können mit **`/p`**, **`/plot`** oder **`/plots`** begonnen werden. In der Tabelle wird der kurze Einstieg `/p` verwendet.

| Befehl | Beschreibung | Beispiel |
|---|---|---|
| `/p` | Öffnet die Hauptverwaltung. Root-Aliase: `/plot`, `/plots`. | `/p` |
| `/p menu` | Öffnet die Hauptverwaltung. Alias: `gui`. | `/p menu` |
| `/p help` | Zeigt die Ingame-Hilfe. Aliase: `hilfe`, `?`. | `/p help` |
| `/p claim` | Beansprucht das freie Plot unter dir. Alias: `beanspruchen`. | `/p claim` |
| `/p auto` | Sucht, beansprucht und besucht automatisch ein freies Plot. | `/p auto` |
| `/p home [auswahl]` | Teleportiert zu einem eigenen Plot. Alias: `h`. Auswahl = Nummer, persönlicher Name oder Plot-ID. | `/p home 2` |
| `/p middle` | Teleportiert in die Mitte des gesamten aktuellen Plot-Verbunds. Aliase: `mid`, `center`, `mitte`. | `/p middle` |
| `/p visit <spieler> [auswahl]` | Besucht ein Plot eines anderen Spielers. Aliase: `v`, `besuchen`. | `/p visit Aron 2` |
| `/p list` | Öffnet „Meine Plots“. Aliase: `mine`, `plots`. | `/p list` |
| `/p info` | Zeigt Informationen zum aktuellen Plot. Alias: `i`. | `/p info` |
| `/p settings` | Öffnet die Plot-Einstellungen des aktuellen eigenen Plots. Aliase: `set`, `einstellungen`, `flags`. | `/p settings` |
| `/p players` | Öffnet die Spielerverwaltung. Aliase: `members`, `spieler`, `mitglieder`. | `/p players` |
| `/p border` | Öffnet die Auswahl der Plot-Umrandung. Aliase: `rand`, `umrandung`. | `/p border` |
| `/p border <material>` | Setzt den Plot-Rand auf ein Blockmaterial. | `/p border QUARTZ_BLOCK` |
| `/p border reset` | Setzt den Rand auf das Standardmaterial zurück. | `/p border reset` |
| `/p add <spieler>` | Macht einen Spieler zum Mitglied. Aliase: `member`, `mitglied`, `hinzufügen`, `hinzufuegen`. | `/p add Aron` |
| `/p trust <spieler>` | Macht einen Spieler zum Vertrauten. Aliase: `trusted`, `vertrauen`. | `/p trust Aron` |
| `/p deny <spieler>` | Sperrt einen Spieler vom Plot. Aliase: `block`, `blockieren`. | `/p deny Aron` |
| `/p remove <spieler>` | Entfernt die besondere Rolle/Sperre eines Spielers. Aliase: `untrust`, `undeny`, `entfernen`, `freigeben`. | `/p remove Aron` |
| `/p owner add <spieler>` | Fügt einen Mitbesitzer hinzu. Aliase des Unterbefehls: `owner`, `besitzer`, `coowner`, `mitbesitzer`. | `/p owner add Aron` |
| `/p owner remove <spieler>` | Entfernt einen Mitbesitzer. Der Hauptbesitzer kann nicht entfernt werden. | `/p owner remove Aron` |
| `/p order` | Öffnet die persönliche Reihenfolge deiner Plots. Aliase: `reihenfolge`, `sort`. | `/p order` |
| `/p sethome` | Setzt den gemeinsamen Plot-Spawnpunkt auf deine aktuelle Position und Blickrichtung. | `/p sethome` |
| `/p name <name>` | Vergibt deinen persönlichen Plotnamen. Aliase: `rename`, `benennen`. | `/p name Lager` |
| `/p name reset` | Entfernt deinen persönlichen Plotnamen. | `/p name reset` |
| `/p merge` | Öffnet das Merge-Menü. Alias: `verbinden`. | `/p merge` |
| `/p merge <richtung>` | Verbindet das aktuelle physische Plot mit dem Nachbarplot. Richtungen: north/east/south/west sowie n/e/s/w und deutsche Varianten. | `/p merge east` |
| `/p merge auto` | Verbindet automatisch alle angrenzenden Plots mit demselben Besitzerkreis. | `/p merge auto` |
| `/p unmerge` | Öffnet das Merge-Menü. Alias: `trennen`. | `/p unmerge` |
| `/p unmerge <richtung>` | Trennt genau die Verbindung in einer Richtung und stellt die Straße wieder her. | `/p unmerge west` |
| `/p unmerge this` | Entfernt nur das physische Plot unter dir aus seinem Merge-Verbund. Aliase für `this`: `current`, `hier`, `dieses`. | `/p unmerge this` |
| `/p clear` | Öffnet die Bestätigung zum Leeren des gesamten logischen Plots. Aliase: `leeren`, `reset`. | `/p clear` |
| `/p clear confirm` | Führt das Leeren direkt aus. | `/p clear confirm` |
| `/p delete` | Öffnet die Bestätigung zum Löschen. Aliase: `removeplot`, `löschen`, `loeschen`. | `/p delete` |
| `/p delete confirm` | Löscht das Plot bzw. den gesamten Merge-Verbund. Nur Hauptbesitzer. | `/p delete confirm` |
| `/p flag` | Öffnet die Einstellungen. | `/p flag` |
| `/p flag <flag>` | Schaltet Boolean-Flags um, öffnet bei `break/place/use` den Materialeditor oder zeigt bei anderen Typen den aktuellen Wert. | `/p flag pvp` |
| `/p flag <flag> <wert>` | Setzt einen konkreten Flag-Wert. | `/p flag weather rain` |
| `/p flag <flag> reset` | Setzt eine Flag auf ihren Standardwert zurück. | `/p flag weather reset` |

### Schreibweise der Parameter

- `<spieler>` = Pflichtangabe
- `[auswahl]` = optionale Angabe
- `<richtung>` = Pflichtangabe, sobald du eine bestimmte Merge-Kante ändern möchtest
- `<wert>` = hängt vom Typ der Flag ab

Die Befehle unterstützen Autovervollständigung. Bei Flags werden nur Einstellungen vorgeschlagen, die du tatsächlich ändern darfst.

---

# 🖥️ Menüs und Inventare

## 🧭 Hauptmenü „Verwaltung“

Öffnen mit **`/p`**.

Je nach Standort siehst du:

- **Dieses Plot verwalten** – nur wenn du Besitzer/Mitbesitzer des aktuellen Plots bist
- **Dieses Plot beanspruchen** – wenn du auf einem freien Plot stehst
- **Keine Plotfläche** – wenn du z. B. auf einer Straße stehst
- **Freies Plot finden** – automatischer Claim
- **Meine Plots** – persönliche Plotliste
- **Schließen**

## 🏡 „Meine Plots“

Zeigt jedes logische Plot genau einmal. Bei einem Merge wird die Anzahl zusammengefasster Flächen angezeigt.

Pro Eintrag siehst du unter anderem:

- persönlichen Namen bzw. Plotnummer
- Plot-ID
- Welt
- Hauptbesitzer/Mitbesitzer-Status
- Größe des Merge-Verbunds

Sind mehrere Plots vorhanden, erscheint zusätzlich **„Reihenfolge ändern“**.

## ⚙️ Plot-Verwaltung

Enthält:

- Zum Plot teleportieren
- Einstellungen
- Spieler verwalten
- Plot-Spawnpunkt setzen
- Anzeige des persönlichen Plotnamens und des passenden Namensbefehls
- Plots verbinden
- persönliche Reihenfolge
- Plot leeren
- Plot löschen bzw. Hinweis, dass dies nur der Hauptbesitzer darf

## 🚩 Einstellungen

Die Kategorien werden automatisch nach deinen Rechten gefiltert. Kategorien ohne eine einzige freigeschaltete Einstellung werden gar nicht angezeigt.

Zusätzlich findest du:

- Plot-Umrandung
- Merge-Verwaltung

## 👥 Spielerverwaltung

Ein Klick auf einen Spieler öffnet das Rollenmenü. Dort wählst du die gewünschte Rolle direkt aus. Der aktuelle Zustand wird markiert.

## 🧱 Umrandung

Zeigt die freigegebenen Randmaterialien auf mehreren Seiten. Das aktuelle Material ist markiert. Ein normaler Klick wählt ein neues Material.

## 🔗 Merge-Menü

Zeigt Norden, Westen, Osten und Süden. Je nach Nachbar erscheint:

- kein beanspruchtes Plot
- fremdes/nicht verwaltbares Plot
- **Verbinden**
- **Trennen**

Zusätzlich gibt es **„Automatisch verbinden“**.

## 🔢 Reihenfolge

Im Reihenfolge-Menü wählst du ein Plot und kannst es danach auf #1, eine Position nach vorne, eine Position nach hinten oder ans Ende verschieben.

## 🧹 Clear-/Delete-Bestätigung

Beide gefährlichen Aktionen öffnen ein separates Bestätigungsinventar. Dadurch wird ein versehentliches Löschen durch einen einzelnen Klick vermieden.

## 🧱 Materiallisten und Materialauswahl

Für `break`, `place` und `use` gibt es ein eigenes Inventar. Die ausgewählten Materialien werden angezeigt und können einzeln entfernt werden. Über **„Material auswählen“** öffnest du die alphabetische Gesamtauswahl.

Ein Klick auf einen Block in deinem **eigenen unteren Inventar** fügt dessen Material ebenfalls hinzu, ohne das Item zu verbrauchen.

---

# 🌎 Besondere Weltmechaniken

## Einheitliches Biom

Der aktuelle Standard der Plotwelt verwendet ein einheitliches **PLAINS-/Ebenen-Biom** für neu generierte Chunks. Das konkrete Biom kann serverseitig geändert werden.

## Natürliche Tiere und Monster

Im Standardverhalten der Plotwelt werden natürliche Mob- und Tier-Spawns unterdrückt. Mobs können im aktuellen Standard unter anderem weiterhin über folgende erlaubte Quellen entstehen:

- normale Spawner
- Trial-Spawner
- Spawn-Eggs
- Spawn-Eggs aus Dispensern

Das bedeutet: Ein Spieler kann Tiere oder Monster gezielt erzeugen, ohne dass die Welt gleichzeitig überall natürliche Mobs spawnt. Entity-Limits eines Plots können neue Spawns zusätzlich begrenzen.

## Straßen und Plotgrenzen

Straßen, Kreuzungen, freie Plots und äußere Plot-Ränder sind kein normaler Baubereich. RX_Plots blockiert dort unter anderem direktes Abbauen/Platzieren sowie viele indirekte Veränderungen durch Kolben, Flüssigkeiten, Explosionen und andere Mechaniken.

Bei einem Merge wird die entfernte Straße zwischen verbundenen Plots zu einem Teil der gemeinsamen bebaubaren Fläche.

---

# ⭐ Fortschritt, Belohnungen und Besonderheiten

RX_Plots besitzt aktuell **kein eigenes Fortschritts-, Level-, Geld- oder Belohnungssystem**.

Es gibt daher im aktuellen Stand:

- keine Plot-XP
- keine Plot-Level
- keine täglichen Plot-Belohnungen
- keine Kaufpreise für Plots
- keine Upgrade-Kosten
- keine eingebauten Cooldowns für normale Plotaktionen

Die wichtigste Begrenzung ist das **Plotlimit**. In der mitgelieferten Standardkonfiguration sind es **4 physische Plotflächen pro Besitzer/Mitbesitzer**. Der Server kann diesen Wert verändern.

Außerdem können einzelne Flags je nach Rang freigeschaltet oder verborgen sein.

---

# 💡 Tipps und Tricks

1. **Setze dein Lieblingsplot auf #1.** Dann reicht künftig `/p home` ohne Nummer.
2. **Nutze `/p middle` bei großen Merges.** Damit findest du schnell die tatsächliche Mitte des gesamten Verbunds.
3. **Setze nach dem Bauen `/p sethome`.** Besucher landen dann genau dort, wo du sie haben möchtest.
4. **Gib Freunden zunächst „Mitglied“ oder „Vertraut“ statt Mitbesitzer.** Mitbesitzer können dein Plot vollständig verwalten.
5. **Achte vor einem Merge auf den Besitzerkreis.** Zwei Plots können nur normal verbunden werden, wenn alle Besitzer exakt übereinstimmen.
6. **`/p clear` ist nicht dasselbe wie `/p delete`.** Clear behält Plotdaten und Merge; Delete gibt das Plot vollständig frei.
7. **Ein Merge spart kein Plotlimit.** Die physischen Flächen bleiben weiterhin beansprucht.
8. **Verwende für `break`, `place` und `use` den Materialeditor.** Er ist deutlich einfacher als lange Materialnamen im Chat einzugeben.
9. **Wenn eine Flag fehlt, ist sie wahrscheinlich für deinen Rang nicht freigeschaltet.** Das Menü versteckt nicht erlaubte Einstellungen vollständig.
10. **Für mehrteilige persönliche Namen nutze am besten die Plotliste.** Die Auswahl über `/p home <Name>` ist aktuell am zuverlässigsten mit einem einteiligen Namen.
11. **Sperre störende Besucher mit „Gesperrt“.** Sie können das Plot anschließend nicht normal betreten.
12. **Bei einem 2×2- oder größeren Grundstück ist `/p merge auto` meist einfacher** als jede Straße einzeln zu verbinden.

---

# ❓ Häufig gestellte Fragen (FAQ)

## 1. Wie bekomme ich mein erstes Plot?

Nutze **`/p`** und klicke auf **„Freies Plot finden“**. Alternativ kannst du `/p auto` verwenden oder dich auf ein freies Plot stellen und `/p claim` eingeben.

## 2. Wie viele Plots darf ich besitzen?

Im aktuellen Standard sind es **4 physische Plotflächen**. Der Server kann das Limit anpassen. Mitbesitz und gemergte Teilflächen zählen weiterhin als besessene physische Flächen.

## 3. Warum sehe ich „Dieses Plot verwalten“ nicht?

Der Button wird nur angezeigt, wenn du Besitzer oder Mitbesitzer des aktuellen Plots bist. Mitglieder, Vertraute und Besucher dürfen das Plot nicht verwalten.

## 4. Was ist der Unterschied zwischen Mitglied und Vertraut?

Im aktuellen Stand dürfen beide Rollen bauen. Sie bleiben getrennt, damit Besucher- und Teleportregeln gezielt zwischen den Rollen unterscheiden können.

## 5. Kann ein Mitbesitzer mein Plot löschen?

Nein. Das vollständige Löschen ist dem **Hauptbesitzer** vorbehalten. Mitbesitzer dürfen aber viele andere Verwaltungseinstellungen ändern.

## 6. Was passiert bei `/p clear`?

Das gesamte logische Plot wird auf den Grundzustand zurückgesetzt. Gebaute Blöcke und Nicht-Spieler-Entities auf der Plotfläche werden entfernt. Besitzer, Rollen, Flags, Name, Spawnpunkt und Merge bleiben erhalten.

## 7. Was passiert bei `/p delete`?

Das Plot wird zurückgesetzt und anschließend vollständig freigegeben. Bei einem Merge betrifft das den **gesamten Merge-Verbund**. Plotdaten, Rollen, Flags, Homes und Verbindungen werden entfernt und Straßen wiederhergestellt.

## 8. Wie verbinde ich mehrere Plots?

Nutze `/p merge <richtung>` oder `/p merge auto`. Die beteiligten Plots müssen denselben Besitzerkreis haben und direkt aneinandergrenzen.

## 9. Wie trenne ich nur einen Teil aus einem Merge?

Stelle dich direkt auf die betreffende physische Plotfläche und nutze:

```text
/p unmerge this
```

Die übrigen Plots behalten ihre bestehenden Verbindungen untereinander.

## 10. Warum kann ich eine bestimmte Flag nicht sehen?

RX_Plots zeigt nur Einstellungen an, die dein Rang verändern darf. Nicht freigeschaltete Flags und sogar komplett leere Kategorien werden ausgeblendet.

## 11. Wie erlaube ich Besuchern nur bestimmte Blöcke?

Nutze die Flags `break`, `place` und `use`. Im zugehörigen Materialeditor kannst du einzelne Blockarten auswählen. Besucher bekommen dadurch nur die ausgewählten Ausnahmen.

## 12. Warum funktioniert Angeln nicht, obwohl Projektile erlaubt sind?

Angeln hat eine **eigene Flag `fishing`**. Die Angel ist absichtlich unabhängig von `projectiles`. Aktiviere daher die Angeln-Flag, wenn Besucher angeln dürfen sollen.

## 13. Kann ich festlegen, wo Besucher auf meinem Plot landen?

Ja. Stelle dich an die gewünschte Position, schaue in die gewünschte Richtung und nutze `/p sethome`.

## 14. Was ist der Unterschied zwischen `/p home` und `/p middle`?

`/p home` nutzt den gespeicherten Plot-Spawnpunkt. `/p middle` berechnet die Mitte des gesamten Merge-Verbunds und ignoriert den gespeicherten Spawnpunkt.

## 15. Kann jeder meinen Plotnamen sehen?

Der Name ist **persönlich pro Besitzer**. Er dient vor allem deiner eigenen Sortierung und Auswahl. Ein Mitbesitzer kann denselben Plot anders benennen.

## 16. Warum spawnen nicht überall natürliche Tiere und Monster?

Die Plotwelt blockiert im aktuellen Standard natürliche Mob-Spawns. Gezielte Spawns über Spawner, Trial-Spawner oder Spawn-Eggs bleiben erlaubt, solange keine Plot-Limits dagegenstehen.

## 17. Kann ich den Plot-Rand abbauen oder die Straße verändern?

Nein. Der äußere Plot-Rand, Straßen, Kreuzungen und freie Plotflächen sind geschützt. Nur eine durch Merge entfernte innere Straße wird Teil der gemeinsamen bebaubaren Plotfläche.

## 18. Kann ich meine Reihenfolge später wieder ändern?

Ja. Nutze jederzeit `/p order`. Die Reihenfolge ist persönlich und beeinflusst unter anderem, welches Plot `/p home` ohne Nummer auswählt.

## 19. Warum kann ich zwei eigene Plots nicht mergen?

Prüfe, ob sie direkt nebeneinanderliegen und ob **alle Besitzer auf beiden Plots identisch** sind. Hat nur eines der Plots einen zusätzlichen Mitbesitzer, wird der Merge abgelehnt.

## 20. Gibt es Plot-Kosten oder ein Wirtschaftssystem?

Nein. RX_Plots besitzt im aktuellen Stand kein eigenes Economy- oder Kaufsystem für Plots.

---

# ✅ Kurzreferenz für Anfänger

```text
/p                     Plot-Menü öffnen
/p auto                freies Plot finden
/p home                zu Plot #1
/p list                eigene Plots anzeigen
/p sethome             Plot-Spawnpunkt setzen
/p players             Spieler verwalten
/p settings            Plot-Regeln öffnen
/p border              Plot-Rand auswählen
/p merge auto          passende Nachbarplots verbinden
/p middle              Mitte des Plot-Verbunds
/p info                Plot-Informationen
```

**Merke:** Wenn du etwas lieber anklickst als eintippst, erreichst du fast alle wichtigen Verwaltungsfunktionen direkt über **`/p`**.
