From 4dec19aead6f21e661679d935284b7e6ca219d8d Mon Sep 17 00:00:00 2001 From: M_Viper Date: Fri, 23 Jan 2026 06:02:21 +0000 Subject: [PATCH] =?UTF-8?q?Gadgets=20hinzugef=C3=BCgt?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Gadgets.md | 70 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 Gadgets.md diff --git a/Gadgets.md b/Gadgets.md new file mode 100644 index 0000000..c252112 --- /dev/null +++ b/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! \ No newline at end of file