Table of Contents

Gadgets

🎒 Das Gadget-Menü
🛠 Aktive Gadgets (Kategorie: Lustiges)
🐾 Das Pet-System (Haustiere)

Features:
Verfügbare Pets:

🎩 Hüte mit Partikeleffekten
🛡 Admin-Gadget-Schutz
💻 Befehlsreferenz
🔒 Berechtigungen
⚠️ Wichtige Hinweise
⚙️ Technische Details (Für Admins)

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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:

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.

Gadgets

🎒 Das Gadget-Menü

🛠 Aktive Gadgets (Kategorie: Lustiges)

🐾 Das Pet-System (Haustiere)

Features:

Verfügbare Pets:

🎩 Hüte mit Partikeleffekten

🛡 Admin-Gadget-Schutz

💻 Befehlsreferenz

🔒 Berechtigungen

⚠️ Wichtige Hinweise

⚙️ Technische Details (Für Admins)

NexusLobby Wiki

Home

Erste Schritte

Konfiguration

Module

Technik & Extras