Gadgets hinzugefügt

Gadgets.md

@@ -0,0 +1,70 @@
+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 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.
+
+### Features der Pets:
+* **Treue Begleiter:** Pets folgen dir automatisch. Wenn du dich wegteleportierst oder zu weit entfernst, spawnen sie sofort bei dir nach.
+* **Unbesiegbar:** Pets können nicht sterben, verbrennen oder durch Spieler verletzt werden.
+* **Cleanup:** Sobald ein Spieler den Server verlässt, wird sein Pet automatisch entfernt, um den Server sauber zu halten.
+* **Namensschilder:** Jedes Pet trägt automatisch den Namen seines Besitzers (z.B. `Viper's Wolf`).
+
+---
+
+## 🛠 Gadget-Liste (Werkzeuge)
+
+Hier sind die Gadgets, die in der Lobby für Spaß und schnellere Fortbewegung sorgen:
+
+| Gadget | Funktion | Bedienung |
+| :--- | :--- | :--- |
+| **Grappling Hook** | Ein Enterhaken, der dich zu Zielen zieht. | Rechtsklick mit der Angel |
+| **Double Jump** | Erlaubt einen zusätzlichen Sprung in der Luft. | 2x Leertaste drücken |
+| **Player Hider** | Macht andere Spieler unsichtbar (weniger Lags). | Rechtsklick mit dem Item |
+| **Gadget-Menü** | Eine Übersicht aller verfügbaren Items. | Rechtsklick auf die Truhe |
+
+---
+
+## 🔑 Berechtigungen (Permissions)
+
+Damit Spieler die Gadgets nutzen können, müssen folgende Rechte (z.B. via LuckPerms) vergeben werden:
+
+| Permission | Erlaubt... |
+| :--- | :--- |
+| `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. |
+| `nexuslobby.gadget.hide` | Nutzung des Spieler-Versteckers. |
+
+---
+
+## ❓ Anleitung für Anfänger
+
+### Wie bekomme ich ein Gadget?
+In deiner Hotbar (Inventarleiste) findest du meistens eine **Truhe** oder einen **Kompass**. 
+1. Mache einen **Rechtsklick** mit der Truhe in der Hand.
+2. Ein Menü öffnet sich.
+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?
+Drücke einfach **zweimal schnell hintereinander die Leertaste**. Du bekommst einen Schub nach vorne/oben. Perfekt, um Abkürzungen auf der Map zu finden!
+
+---
+
+## ⚙️ 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.
+* **Welten-Schutz:** Gadgets funktionieren standardmäßig nur in den Welten, die in der `config.yml` als Lobby-Welten definiert sind.
+* **Konfiguration:** Icons, Namen und Soundeffekte der Gadgets können in der `visuals.yml` angepasst werden.
+
+---
+
+## 💡 Tipp für Profis
+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!