Gadgets aktualisiert
131
Gadgets.md
131
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!
|
||||
- **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.
|
||||
Reference in New Issue
Block a user