README.md aktualisiert

README.md

@@ -800,6 +800,120 @@ Bei 1500+ PNG-Dateien:
 
 ---
 
+# 🗿 ArmorStand-Editor (SurvivalPlus)
+
+## Übersicht
+
+Der ArmorStand-Editor ermöglicht das vollständige Bearbeiten von ArmorStands direkt ingame – ohne externe Tools.
+
+| Aktion | Beschreibung |
+|--------|-------------|
+| **Shift+Rechtsklick** auf einen ArmorStand | Editor öffnen |
+| **Rechtsklick** auf einen ArmorStand | Hinterlegten BungeeCord-Command / Server-Switch ausführen |
+| **Shift+Linksklick** auf einen ArmorStand | ArmorStand löschen |
+
+**Benötigte Permissions:**
+
+| Permission | Beschreibung | Standard |
+|------------|-------------|---------|
+| `survivalplus.armorstand.edit` | Editor öffnen, Ausrüstung & Pose bearbeiten | op |
+| `survivalplus.armorstand.destroy` | ArmorStand per Shift+Linksklick löschen | op |
+
+---
+
+## Haupt-GUI
+
+Öffnet sich per Shift+Rechtsklick oder `/asedit`.
+
+| Slot | Funktion |
+|------|---------|
+| Sichtbarkeit | Sichtbar / Unsichtbar umschalten |
+| Arme | Arme ein-/ausblenden |
+| Basisplatte | Basisplatte ein-/ausblenden |
+| Schwerkraft | Schwerkraft ein-/ausschalten |
+| Größe | Normal / Klein umschalten |
+| Unverletzlichkeit | Unverletzlich / Verletzlich umschalten |
+| Namens-Anzeige | Customname ein-/ausblenden |
+| Namen setzen | Namen per Chat eingeben (Farbcodes mit `&` möglich, `remove` zum Löschen) |
+| Kopf / Körper / Arme / Beine | Pose-Sub-GUI öffnen |
+| **Ausrüstung** | Ausrüstungs-GUI öffnen |
+| **BungeeCord-Command** | BungeeCord-GUI öffnen |
+| Pose zurücksetzen | Alle Winkel auf 0° setzen |
+| Editor schließen | GUI schließen |
+
+---
+
+## Ausrüstungs-GUI
+
+Öffnet sich über „Ausrüstung" im Haupt-GUI.
+
+**Items setzen:**
+- **Shift-Klick** auf ein Item im eigenen Inventar → wird automatisch in den richtigen Slot gesetzt (Helm, Brust, Beine, Schuhe, Mainhand)
+- **Item auf Cursor nehmen** (normaler Klick im Inventar) und dann auf einen Ausrüstungs-Slot klicken → setzt das Item; altes Item kommt auf den Cursor zurück
+
+**Items entfernen:**
+- Auf einen besetzten Slot klicken **ohne** Cursor-Item → Item geht zurück ins Inventar
+
+| Slot | Ausrüstungsplatz |
+|------|----------------|
+| 10 | Helm |
+| 12 | Brustteil |
+| 14 | Beinteil |
+| 16 | Schuhe |
+| 11 | Mainhand |
+| 13 | Offhand |
+
+**Automatische Slot-Erkennung beim Shift-Klick:**
+
+| Item-Typ | Ziel-Slot |
+|----------|----------|
+| `*_HELMET`, `*_SKULL`, `*_HEAD`, Kürbis, Spielerkopf | Helm |
+| `*_CHESTPLATE`, Elytra | Brust |
+| `*_LEGGINGS` | Beine |
+| `*_BOOTS` | Schuhe |
+| Alles andere | Mainhand |
+
+---
+
+## Pose-GUI
+
+Öffnet sich für Kopf, Körper, linken Arm, rechten Arm, linkes Bein oder rechtes Bein.
+
+- Rotation auf **X-, Y- und Z-Achse** je in Schritten von **±5°** (fein) oder **±15°** (grob)
+- Aktueller Winkel wird live angezeigt
+- Zurück-Pfeil → Haupt-GUI
+
+---
+
+## BungeeCord-Command-GUI
+
+Öffnet sich über „BungeeCord-Command" im Haupt-GUI.
+
+| Option | Beschreibung |
+|--------|-------------|
+| **Server-Switch** | Spieler wird beim Rechtsklick auf den Stand zu einem anderen BungeeCord-Server weitergeleitet. Server-Namen im Chat eingeben (z.B. `lobby`). |
+| **Command ausführen** | Führt beim Rechtsklick einen Befehl als Spieler aus. Befehl **ohne** `/` im Chat eingeben (z.B. `spawn`). |
+| **Entfernen** | Löscht den hinterlegten Command/Server-Switch. |
+
+> Mit `cancel` im Chat wird die Eingabe abgebrochen.
+>
+> Server-Switch und Command schließen sich gegenseitig aus – es kann nur eines aktiv sein.
+
+Commands und Server-Switch-Daten werden im **Persistent Data Container (PDC)** des ArmorStands gespeichert und überleben Server-Neustarts.
+
+---
+
+## Befehle
+
+| Befehl | Beschreibung | Permission |
+|--------|-------------|------------|
+| `/asedit` | Öffnet den Editor für den nächsten ArmorStand (≤ 5 Blöcke) | `survivalplus.armorstand.edit` |
+| `/ascommand` | Alias für `/asedit` | `survivalplus.armorstand.edit` |
+| `/showarmorstands [Radius]` | Macht unsichtbare ArmorStands sichtbar | `survivalplus.showarmorstands` |
+| `/cleardebugarmorstands` | Entfernt alle Debug-ArmorStands | `survivalplus.cleardebugarmorstands` |
+
+---
+
 # 🔐 Sicherheitshinweis
 
 Aktuell sind API-Endpunkte öffentlich (`__return_true`).