From 44f6efbdfd993c310437c2c65d3888b6a70856d5 Mon Sep 17 00:00:00 2001 From: M_Viper Date: Sat, 28 Feb 2026 09:35:14 +0000 Subject: [PATCH] Gadgets aktualisiert --- Gadgets.md | 131 ++++++++++++++++++++++++++++++++++++----------------- 1 file changed, 90 insertions(+), 41 deletions(-) diff --git a/Gadgets.md b/Gadgets.md index eb0ace9..1943d78 100644 --- a/Gadgets.md +++ b/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: -* **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`). +### Features: +- **Treue Begleiter:** Pets folgen automatisch. Bei Teleport oder zu großer Distanz spawnen sie sofort nach. +- **Unbesiegbar:** Pets können weder sterben noch durch Spieler verletzt werden. +- **Automatischer Cleanup:** Beim Verlassen des Servers wird das Pet sofort entfernt. +- **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 | -| :--- | :--- | :--- | -| **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 | +| Hut | Effekt | +|-----|--------| +| Meereslaterne / Leuchtfeuer | ✨ Glitzern (End Rod) | +| Lagerfeuer | 💨 Rauch | +| Monsterlaterne | 🔥 Flammen | +| 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... | -| :--- | :--- | -| `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. | +``` +/nexus gadgetshield +``` + +- **Toggle:** Ein zweiter Aufruf deaktiviert den Schutz wieder. +- **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? -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. +| Befehl | Beschreibung | +|--------|--------------| +| *(Rechtsklick auf Truhe)* | Öffnet das Gadget-Menü | +| `/nexus gadgetshield` | Gadget-Schutz für Admins ein-/ausschalten | -### 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! +## 🔒 Berechtigungen + +| 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. -* **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 +- **Cooldown-Werte** sind direkt in `GadgetModule.java` als Konstanten hinterlegt und können dort angepasst werden: + ```java + 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 + ``` +- **Gadget-Schutz-Logik** liegt in `GadgetShield.java` (Package `de.nexuslobby.modules.gadgets`). +- **Performance:** Die Pet-Follow-Logik arbeitet ohne Pfadfindungs-Algorithmen, was die CPU-Last nahezu auf null senkt. \ No newline at end of file