Gadgets

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)

Pets in NexusLobby sind echte Entities, keine Partikel.

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 |

—

🎩 Hüte mit Partikeleffekten

Bestimmte Hüte erzeugen automatisch Partikeleffekte:

| Hut | Effekt |
|—–|——–|
| Meereslaterne / Leuchtfeuer | ✨ Glitzern (End Rod) |
| Lagerfeuer | 💨 Rauch |
| Monsterlaterne | 🔥 Flammen |
| Zaubertisch | 🔮 Runen (Enchant) |

—

🛡 Admin-Gadget-Schutz

Admins können sich mit folgendem Befehl gegen alle kampfbezogenen Gadgets anderer Spieler schützen:

„`
/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.

—

💻 Befehlsreferenz

| Befehl | Beschreibung |
|——–|————–|
| (Rechtsklick auf Truhe) | Öffnet das Gadget-Menü |
| /nexus gadgetshield | Gadget-Schutz für Admins ein-/ausschalten |

—

🔒 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)

• Cooldown-Werte sind direkt in GadgetModule.java als Konstanten hinterlegt und können dort angepasst werden:

„`java
private static final long METEORCDMS = 15000L; // 15 Sekunden
private static final long FREEZECDMS = 10000L; // 10 Sekunden
private static final long GRAPPLINGCDMS = 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.