Gadgets aktualisiert

Gadgets.md

@@ -1,70 +1,119 @@
 # Gadgets
 
-Das Gadget-Modul von **NexusLobby** sorgt für Action und Unterhaltung in der Lobby. Es kombiniert nützliche Werkzeuge mit lebendigen Tierbegleitern (Pets), die dem Spieler treu folgen.
+Das Gadget-Modul von **NexusLobby** sorgt für Action und Unterhaltung in der Lobby. Es kombiniert nützliche Werkzeuge mit lebendigen Tierbegleitern (Pets) und bietet einen eingebauten Schutz für Admins und Parcours-Spieler.
+
+---
+
+## 🎒 Das Gadget-Menü
+
+Öffne das Menü per **Rechtsklick** auf die **Truhe** in deiner Hotbar. Es unterteilt sich in folgende Kategorien:
+
+| Kategorie | Icon | Inhalt |
+|-----------|------|--------|
+| **Ballons** | Leine | Farbige Wollballons, die über dir schweben |
+| **Hüte** | Goldhelm | Dekorative Blöcke als Kopfbedeckung mit Partikeleffekten |
+| **Begleiter** | Knochen | Echte Tier-Entities (Wolf, Katze, Panda) |
+| **Lustiges** | Feuerwerk | Aktive Gadgets (siehe unten) |
+| **Partikel** | Nether-Stern | Dauerhafte Auren um den Spieler |
+
+---
+
+## 🛠 Aktive Gadgets (Kategorie: Lustiges)
+
+| Gadget | Material | Funktion | Cooldown |
+|--------|----------|----------|----------|
+| **Enterhaken** | Angel | Rechtsklick – zieht dich zu deinem Zielpunkt | **3 Sekunden** |
+| **Freeze-Ray** | Packeis | Rechtsklick – friert einen Spieler für ~3 Sekunden ein | **10 Sekunden** |
+| **Paintball-Gun** | Goldne Hacke | Rechtsklick – schießt farbige Partikel | – |
+| **Meteorit** | Feuerladung | Rechtsklick – lässt an der Zielposition eine Explosion entstehen | **15 Sekunden** |
+| **Schutzzone** | Schild | Toggle – hält andere Spieler von dir fern | – |
+| **Chicken-Rain** | Ei | Lässt eine Wolke aus Hühnern erscheinen | – |
+
+> **Cooldown-Feedback:** Ist ein Gadget noch im Cooldown, erscheint eine Nachricht mit den verbleibenden Sekunden und ein Bass-Sound als Signal.
 
 ---
 
 ## 🐾 Das Pet-System (Haustiere)
 
-In NexusLobby sind Pets keine einfachen Partikel, sondern **echte Entities**. Sie verhalten sich wie loyale Begleiter und sind für maximale Performance optimiert.
+Pets in NexusLobby sind **echte Entities**, keine Partikel.
 
-### Features der Pets:
+### Features:
-* **Treue Begleiter:** Pets folgen dir automatisch. Wenn du dich wegteleportierst oder zu weit entfernst, spawnen sie sofort bei dir nach.
+- **Treue Begleiter:** Pets folgen automatisch. Bei Teleport oder zu großer Distanz spawnen sie sofort nach.
-* **Unbesiegbar:** Pets können nicht sterben, verbrennen oder durch Spieler verletzt werden.
+- **Unbesiegbar:** Pets können weder sterben noch durch Spieler verletzt werden.
-* **Cleanup:** Sobald ein Spieler den Server verlässt, wird sein Pet automatisch entfernt, um den Server sauber zu halten.
+- **Automatischer Cleanup:** Beim Verlassen des Servers wird das Pet sofort entfernt.
-* **Namensschilder:** Jedes Pet trägt automatisch den Namen seines Besitzers (z.B. `Viper's Wolf`).
+- **Namensschild:** Jedes Pet trägt den Namen seines Besitzers (z.B. `Viper's Wolf`).
+
+### Verfügbare Pets:
+| Pet | Aktivierung |
+|-----|-------------|
+| 🐺 Wolf | Gadget-Menü → Begleiter → Wolf |
+| 🐱 Katze | Gadget-Menü → Begleiter → Katze |
+| 🐼 Panda | Gadget-Menü → Begleiter → Panda |
 
 ---
 
-## 🛠 Gadget-Liste (Werkzeuge)
+## 🎩 Hüte mit Partikeleffekten
 
-Hier sind die Gadgets, die in der Lobby für Spaß und schnellere Fortbewegung sorgen:
+Bestimmte Hüte erzeugen automatisch Partikeleffekte:
 
-| Gadget | Funktion | Bedienung |
+| Hut | Effekt |
-| :--- | :--- | :--- |
+|-----|--------|
-| **Grappling Hook** | Ein Enterhaken, der dich zu Zielen zieht. | Rechtsklick mit der Angel |
+| Meereslaterne / Leuchtfeuer | ✨ Glitzern (End Rod) |
-| **Double Jump** | Erlaubt einen zusätzlichen Sprung in der Luft. | 2x Leertaste drücken |
+| Lagerfeuer | 💨 Rauch |
-| **Player Hider** | Macht andere Spieler unsichtbar (weniger Lags). | Rechtsklick mit dem Item |
+| Monsterlaterne | 🔥 Flammen |
-| **Gadget-Menü** | Eine Übersicht aller verfügbaren Items. | Rechtsklick auf die Truhe |
+| Zaubertisch | 🔮 Runen (Enchant) |
 
 ---
 
-## 🔑 Berechtigungen (Permissions)
+## 🛡 Admin-Gadget-Schutz
 
-Damit Spieler die Gadgets nutzen können, müssen folgende Rechte (z.B. via LuckPerms) vergeben werden:
+Admins können sich mit folgendem Befehl gegen alle kampfbezogenen Gadgets anderer Spieler schützen:
 
-| Permission | Erlaubt... |
+```
-| :--- | :--- |
+/nexus gadgetshield
-| `nexuslobby.gadgets.use` | Das Haupt-Gadget-Menü zu öffnen. |
+```
-| `nexuslobby.pets.all` | Zugriff auf alle Tierbegleiter (Wolf, Katze, etc.). |
+
-| `nexuslobby.gadget.hook` | Speziell die Nutzung des Enterhakens. |
+- **Toggle:** Ein zweiter Aufruf deaktiviert den Schutz wieder.
-| `nexuslobby.gadget.hide` | Nutzung des Spieler-Versteckers. |
+- **Schutz gegen:** Freeze-Ray, Meteorit, Enterhaken.
+- **Feedback:** Chime-Sound = aktiviert, Bass-Sound = deaktiviert.
+- Spieler, die einen Parcours absolvieren, sind **automatisch** ebenfalls geschützt – ohne diesen Befehl.
 
 ---
 
-## ❓ Anleitung für Anfänger
+## 💻 Befehlsreferenz
 
-### Wie bekomme ich ein Gadget?
+| Befehl | Beschreibung |
-In deiner Hotbar (Inventarleiste) findest du meistens eine **Truhe** oder einen **Kompass**. 
+|--------|--------------|
-1. Mache einen **Rechtsklick** mit der Truhe in der Hand.
+| *(Rechtsklick auf Truhe)* | Öffnet das Gadget-Menü |
-2. Ein Menü öffnet sich.
+| `/nexus gadgetshield` | Gadget-Schutz für Admins ein-/ausschalten |
-3. Klicke auf ein Gadget oder ein Pet, um es zu aktivieren.
 
-### Mein Pet ist weg, was tun?
+---
-Keine Sorge! Pets spawnen automatisch nach, wenn du dich bewegst. Wenn es gar nicht mehr auftaucht, öffne einfach das Gadget-Menü erneut und wähle es neu aus.
 
-### Wie fliege ich mit dem Double Jump?
+## 🔒 Berechtigungen
-Drücke einfach **zweimal schnell hintereinander die Leertaste**. Du bekommst einen Schub nach vorne/oben. Perfekt, um Abkürzungen auf der Map zu finden!
+
+| Permission | Beschreibung |
+|------------|--------------|
+| `nexuslobby.admin` | Zugriff auf `/nexus gadgetshield` |
+
+> Gadgets selbst sind für alle Spieler ohne eigene Permission verfügbar. Möchtest du den Zugriff einschränken, kannst du das Gadget-Item aus der `giveLobbyItems`-Methode in der `ItemsModule.java` entfernen oder per Permission absichern.
+
+---
+
+## ⚠️ Wichtige Hinweise
+
+- **Parcours-Schutz:** Spieler, die aktiv einen Parcours absolvieren, können nicht eingefroren oder durch Meteorite getroffen werden. Der Schütze erhält eine entsprechende Rückmeldung.
+- **Gadget-Sperre im Parcours:** Wer selbst im Parcours läuft, kann Freeze-Ray und Meteorit nicht abfeuern.
+- **Cooldown:** Wird ein Gadget zu früh erneut benutzt, erscheint eine Nachricht wie: `§c§lFreeze-Ray §7hat noch §e8s §7Cooldown.`
 
 ---
 
 ## ⚙️ Technische Details (Für Admins)
 
-* **Performance:** Das Plugin nutzt eine optimierte Follow-Logik ohne Pfadfindungs-Algorithmen (`Navigation`), was die CPU-Last pro Pet fast auf Null senkt.
+- **Cooldown-Werte** sind direkt in `GadgetModule.java` als Konstanten hinterlegt und können dort angepasst werden:
-* **Welten-Schutz:** Gadgets funktionieren standardmäßig nur in den Welten, die in der `config.yml` als Lobby-Welten definiert sind.
+  ```java
-* **Konfiguration:** Icons, Namen und Soundeffekte der Gadgets können in der `visuals.yml` angepasst werden.
+  private static final long METEOR_CD_MS    = 15_000L; // 15 Sekunden
-
+  private static final long FREEZE_CD_MS    = 10_000L; // 10 Sekunden
----
+  private static final long GRAPPLING_CD_MS =  3_000L; //  3 Sekunden
-
+  ```
-## 💡 Tipp für Profis
+- **Gadget-Schutz-Logik** liegt in `GadgetShield.java` (Package `de.nexuslobby.modules.gadgets`).
-Kombiniere den **Double Jump** mit dem **Grappling Hook**, um extrem weite Distanzen in der Lobby zu überwinden. Das ist ein beliebtes Feature für VIP-Spieler!
+- **Performance:** Die Pet-Follow-Logik arbeitet ohne Pfadfindungs-Algorithmen, was die CPU-Last nahezu auf null senkt.