diff --git a/ArmorStands.md b/ArmorStands.md index 3a3731c..67d96ac 100644 --- a/ArmorStands.md +++ b/ArmorStands.md @@ -1,164 +1,90 @@ -# ArmorStands +# 🛠️ ArmorStands & NPCs -Ein GUI-basierter Editor fur ArmorStands mit vielen Anpassungsmöglichkeiten. +Ein GUI-basierter Editor für ArmorStands mit erweiterten Funktionen für interaktive NPCs, die sogar auf die Spielwelt reagieren. -## Übersicht +--- -- Grafische Oberflache zum Bearbeiten -- Kopf, Körper und Arme drehen -- Sichtbarkeit und Eigenschaften anpassen -- Commands an ArmorStands binden - -## Befehle +## 📊 Befehlsübersicht | Befehl | Aliases | Beschreibung | Berechtigung | -|--------|---------|-------------|--------------| -| `/nexustools` | `/nt`, `/ntools`, `/astools` | Offnet den Editor | `nexuslobby.armorstand.use` | -| `/nexuscmd` | `/ncmd`, `/ascmd` | Bindet Command | `nexuslobby.armorstand.cmd` | +|:-------|:--------|:-------------|:-------------| +| `/nexustools` | `/nt`, `/astools` | Öffnet die Editor-GUI | `nexuslobby.armorstand.use` | +| `/nexuscmd` | `/ascmd`, `/ncmd` | Bindet Befehle an Klicks | `nexuslobby.armorstand.cmd` | +| `/asdynamic` | `/asdyn` | **Schaltet dynamische Effekte um** | `nexuslobby.admin` | --- -## ArmorStand Editor +## 🌓 Neu: Dynamic ArmorStands -### GUI öffnen +Mit dem `DynamicArmorStandModule` reagieren deine NPCs automatisch auf die Umgebung. Wenn du einen ArmorStand mit `/asdynamic` markierst, geschehen folgende Dinge: -1. Schaue einen ArmorStand an -2. Fuhre `/nexustools` aus -3. Die Editor-GUI öffnet sich - -### Funktionen - -| Funktion | Beschreibung | -|----------|-------------| -| **Kopf drehen** | Dreht den Kopf des ArmorStands | -| **Korper drehen** | Dreht den gesamten Korper | -| **Arme umschalten** | Zeigt/versteckt die Arme | -| **Sichtbarkeit** | Macht den ArmorStand unsichtbar/sichtbar | -| **Basisplatte** | Zeigt/versteckt die Basisplatte | -| **Gravitation** | Aktiviert/deaktiviert Schwerkraft | -| **Position** | Feintuning der Position | -| **Equipment** | Rustung und Items bearbeiten | +* **🌙 Nacht-Modus (20:00 - 06:00):** Der ArmorStand nimmt automatisch eine **Fackel** in die Off-Hand. +* **🌧️ Wetter-Logik:** Bei Regen oder Sturm setzt der ArmorStand automatisch einen **Lederhelm** (Regenschutz) auf. +* **Persistent:** Diese Einstellung wird im `PersistentDataContainer` des Entities gespeichert und bleibt auch nach einem Server-Neustart erhalten. --- -## Command Binding - -Mit `/nexuscmd` kannst du Commands an ArmorStands binden, die beim Anklicken ausgeführt werden. +## 🎨 ArmorStand Editor (/nexustools) ### Verwendung -1. Schaue einen ArmorStand an -2. Fuhre aus: `/nexuscmd ` +1. Schaue den gewünschten ArmorStand direkt an. +2. Führe `/nexustools` aus. +3. Nutze die GUI, um folgende Eigenschaften anzupassen: + +| Funktion | Effekt | +|:---------|:-------| +| **Kopf/Körper** | Stufenloses Drehen der Körperteile. | +| **Arme** | Schaltet die Sichtbarkeit von Armen um. | +| **Sichtbarkeit** | Macht den Stand unsichtbar (ideal für NPCs). | +| **Basisplatte** | Entfernt die Steinplatte am Boden. | +| **Gravitation** | Lässt den ArmorStand in der Luft schweben. | + +> **Tipp:** Halte **Shift (Schleichen)** während des Klickens in der GUI gedrückt, um das Feintuning (kleinere Grad-Schritte) zu nutzen. + +--- + +## 📜 Command Binding (/nexuscmd) + +Du kannst jeden beliebigen Befehl an einen ArmorStand binden. Dieser wird ausgeführt, sobald ein Spieler den Stand anklickt. + +### Verwendung +```bash +/nexuscmd +``` + +Platzhalter `{player}` verwenden, um den Klicker anzusprechen. ### Beispiele -```bash -# Nachricht senden -/nexuscmd say Willkommen im Shop! - -# Spieler teleportieren -/nexuscmd tp {player} 0 64 0 - -# Menu offnen -/nexuscmd serverswitcher - -# Warp-Punkt -/nexuscmd warp spawn -``` - -### Platzhalter - -| Platzhalter | Beschreibung | -|-------------|-------------| -| `{player}` | Name des klickenden Spielers | -| `{uuid}` | UUID des Spielers | +* `/nexuscmd spawn` - Teleportiert den Spieler zum Spawn. +* `/nexuscmd say Hallo {player}, willkommen!` - Der NPC begrüßt den Spieler. +* `/nexuscmd serverswitcher` - Öffnet das Server-Menü. --- -## Konfiguration - -In `armorstands.yml`: - +## ⚙️ Konfiguration (armorstands.yml) ```yaml -# ArmorStandTools Configuration -prefix: "§8[§6ArmorStand§8] §7" -no-permission: "§cDu hast keine Berechtigung dafür!" -gui-title: "Armor Stand Editor" -armorstand-not-found: "§cKein ArmorStand in der Nahe gefunden!" -tool-selected: "§7Tool ausgewählt: §6{tool}" - +# Einstellungen für das Dynamic-Modul & Editor settings: - require-creative: false # Nur im Creative-Modus nutzbar - cooldown-ticks: 20 # Cooldown zwischen Interaktionen - allow-command-blocks: true # Erlaubt Command-Ausführung - log-commands: true # Loggt ausgeführte Commands + require-creative: false # Nutzung auch im Survival erlauben + update-interval-ticks: 100 # Prüfung der Dynamic-Stands (alle 5 Sek) + allow-command-blocks: true gui: - filler-material: BLACK_STAINED_GLASS_PANE + title: "§8» §6ArmorStand Editor" tools: - head: "§eKopf drehen" - body: "§eKorper drehen" - arms: "§eArme umschalten" - invisible: "§eSichtbarkeit umschalten" + dynamic: "§bDynamische Effekte (Zeit/Wetter)" + invisible: "§eSichtbarkeit" + arms: "§eArme anzeigen" ``` --- -## GUI-Layout +## 💡 Anwendungsbeispiel: Der "Lobby-Wächter" -``` -+---+---+---+---+---+---+---+---+---+ -| # | # | # | # | # | # | # | # | # | -+---+---+---+---+---+---+---+---+---+ -| # |Kpf|Krp|Arm|Inv|Bas|Grv| # | # | -+---+---+---+---+---+---+---+---+---+ -| # | # | # | # | X | # | # | # | # | -+---+---+---+---+---+---+---+---+---+ - -# = Glasscheibe (Dekoration) -Kpf = Kopf drehen -Krp = Körper drehen -Arm = Arme umschalten -Inv = Sichtbarkeit -Bas = Basisplatte -Grv = Gravitation -X = Schliessen -``` - ---- - -## Tipps - -1. **Feintuning:** Halte Shift gedruckt für kleinere Anpassungen - -2. **Sicherheit:** Command-Binding nur an vertrauenswürdige Spieler vergeben - -3. **Performance:** ArmorStands mit Commands sollten sparsam eingesetzt werden - -4. **Backup:** ArmorStand-Daten werden in der Welt gespeichert - ---- - -## Anwendungsbeispiele - -### NPC erstellen - -1. Platziere einen ArmorStand -2. Offne `/nexustools` -3. Mache ihn unsichtbar -4. Gib ihm einen Spielerkopf (über Equipment) -5. Verstecke die Basisplatte -6. Binde einen Command: `/nexuscmd say Hallo {player}!` - -### Shop-Dekoration - -1. Platziere mehrere ArmorStands -2. Gib jedem Rüstung oder Items -3. Positioniere sie als Schaufenster-Puppen -4. Optional: Binde Shop-Commands - -### Wegweiser - -1. Erstelle ArmorStands an wichtigen Punkten -2. Gib ihnen Schilder oder Banner -3. Binde Teleport-Commands für Navigation +1. Platziere einen ArmorStand am Eingang. +2. Nutze `/nexustools`, um ihm Arme zu geben und die Platte zu entfernen. +3. Rüste ihn mit deiner Server-Rüstung aus. +4. Nutze `/asdynamic`, damit er nachts eine Fackel hält und bei Regen nicht nass wird. +5. Nutze `/nexuscmd say Viel Spaß auf dem Netzwerk, {player}!`, damit er Spieler grüßt. \ No newline at end of file