600 lines
24 KiB
Markdown
600 lines
24 KiB
Markdown
# 🌐 NexusLobby
|
||
|
||
<p align="center">
|
||
<img src="https://m-viper.de/img/NexusLobby.png" width="500" alt="NexusLobby">
|
||
</p>
|
||
|
||
**NexusLobby** macht aus einer leeren Welt eine fertige Minecraft-Lobby. Du bekommst Spawn, Scoreboard, Portale zu anderen Servern, einen Parkour, Fußball, sprechende NPCs, Wartungsmodus, VPN-Sperre und vieles mehr. Alles in einem einzigen Plugin und ohne Programmierkenntnisse.
|
||
|
||
|
||
|
||
|
||
|
||
|
||
---
|
||
|
||
## 📖 Inhaltsverzeichnis
|
||
|
||
1. [Was brauche ich?](#-was-brauche-ich)
|
||
2. [Installation in 6 Schritten](#-installation-in-6-schritten)
|
||
3. [Die ersten 5 Minuten](#-die-ersten-5-minuten)
|
||
4. [Wo steht was? Die wichtigen Dateien](#-wo-steht-was-die-wichtigen-dateien)
|
||
5. [Funktionen und wie du sie einrichtest](#-funktionen-und-wie-du-sie-einrichtest)
|
||
6. [Alle Befehle](#-alle-befehle)
|
||
7. [Rechte vergeben](#-rechte-vergeben)
|
||
8. [Probleme und Lösungen](#-probleme-und-lösungen)
|
||
9. [Änderungen in Version 2.1](#-änderungen-in-version-21)
|
||
10. [Hilfe und Lizenz](#-hilfe-und-lizenz)
|
||
|
||
---
|
||
|
||
## ✅ Was brauche ich?
|
||
|
||
| Was | Wofür | Pflicht? |
|
||
|-----|-------|----------|
|
||
| Ein **Paper-Server** ab Version **1.21** (Spigot geht auch, Paper ist besser) | Der Server, auf dem das Plugin läuft | **Ja** |
|
||
| **Java 21** oder neuer | Damit der Server startet | **Ja** |
|
||
| **LuckPerms** | Rechte vergeben und Prefixe im Scoreboard | Empfohlen |
|
||
| **PlaceholderAPI** | Damit Platzhalter wie `%luckperms_prefix%` im Scoreboard Text statt Code zeigen | Empfohlen |
|
||
| **BungeeCord** (oder ein kompatibler Proxy) | Nur, wenn du Spieler zwischen mehreren Servern schicken willst | Optional |
|
||
|
||
---
|
||
|
||
## 📦 Installation in 6 Schritten
|
||
|
||
1. **Server stoppen.**
|
||
2. Die Datei `NexusLobby-2.1.jar` in den Ordner `plugins` deines Servers legen.
|
||
3. **Eine alte NexusLobby-Datei löschen**, falls dort schon eine liegt. Sonst werden zwei Versionen geladen.
|
||
4. **Server starten.** Das Plugin legt jetzt seinen eigenen Ordner `plugins/NexusLobby/` mit allen Einstellungsdateien an.
|
||
5. **Server noch einmal neu starten**, damit alles sauber geladen ist.
|
||
6. Ingame (oder in der Konsole) `/nexus reload` eingeben, wenn du später etwas an den Dateien änderst.
|
||
|
||
> 💡 **Wichtig:** Ein Plugin ersetzt du immer mit einem **Neustart**. `/nexus reload` lädt nur die Einstellungen neu, nicht die Jar-Datei.
|
||
|
||
---
|
||
|
||
## 🚀 Die ersten 5 Minuten
|
||
|
||
Mach das als Erstes, in dieser Reihenfolge:
|
||
|
||
1. **Spawn setzen.** Stell dich dorthin, wo Spieler ankommen sollen, und gib ein:
|
||
```
|
||
/nexus setspawn
|
||
```
|
||
2. **Rechte vergeben.** Ohne Rechte darf niemand außer OPs etwas. Siehe [Rechte vergeben](#-rechte-vergeben).
|
||
3. **Scoreboard prüfen.** Zeigt es Text wie `%luckperms_prefix%` an? Dann fehlt PlaceholderAPI. Siehe [Probleme und Lösungen](#-probleme-und-lösungen).
|
||
4. **Lobby-Schutz prüfen.** Spieler können standardmäßig nicht bauen, nicht kämpfen und keine Items droppen. Das ist so gewollt.
|
||
5. **Deine Grenze setzen** (optional): `/border circle 50` macht einen runden Bereich mit 50 Blöcken Radius um dich.
|
||
|
||
---
|
||
|
||
## 📁 Wo steht was? Die wichtigen Dateien
|
||
|
||
Alle Dateien liegen auf dem Server in `plugins/NexusLobby/`.
|
||
|
||
| Datei | Was steht dort? | Wann ändere ich sie? |
|
||
|-------|-----------------|----------------------|
|
||
| `config.yml` | Spawn, Sprache, Chat-Prefix, Tablist, Kompass-Menü, Doppelsprung, Void-Schutz, Fußball, Wartungsmodus | Für fast alle Grundeinstellungen |
|
||
| `settings.yml` | Lobby-Regeln (PvP, Bauen, Items droppen …) und **VPN- und Länder-Sperre** | Wenn du Regeln oder die Sperre ändern willst |
|
||
| `visuals.yml` | Scoreboard, BossBar, ActionBar | Wenn du Texte oben, unten oder rechts ändern willst |
|
||
| `lang.yml` | Alle Nachrichten des Plugins auf Deutsch und Englisch | Wenn du eine Nachricht umformulieren willst |
|
||
| `conversations.yml` | Die Gespräche der NPCs | Wenn du eigene Dialoge schreiben willst |
|
||
| `parkour.yml` | Strecken, Checkpoints und Bestzeiten | **Nicht von Hand ändern.** Das machst du per Befehl |
|
||
| `portals.yml` | Deine Portale | **Nicht von Hand ändern.** Das machst du per Befehl |
|
||
| `armorstands.yml` | Gespeicherte NPC-Daten | **Nicht ändern** |
|
||
|
||
### So bearbeitest du eine Datei
|
||
|
||
1. Server-Dateien öffnen (FTP oder das Panel deines Hosters).
|
||
2. Die Datei bearbeiten und **speichern**.
|
||
3. Ingame `/nexus reload` eingeben.
|
||
|
||
### Farben im Text
|
||
|
||
Überall, wo Text steht, gehen Farbcodes mit dem `&`-Zeichen:
|
||
|
||
| Code | Farbe | Code | Farbe |
|
||
|------|-------|------|-------|
|
||
| `&a` | Grün | `&c` | Rot |
|
||
| `&e` | Gelb | `&6` | Gold |
|
||
| `&b` | Türkis | `&9` | Blau |
|
||
| `&7` | Grau | `&f` | Weiß |
|
||
| `&l` | **Fett** | `&r` | Zurücksetzen |
|
||
|
||
Beispiel: `&6&lWillkommen &7auf der Lobby` ergibt einen fetten goldenen Text, dann einen grauen.
|
||
|
||
> ⚠️ **Achtung bei YAML-Dateien:** Die Einrückung (Leerzeichen am Zeilenanfang) ist wichtig. Lösche oder füge sie nicht aus Versehen hinzu. Nimm **keine Tabs**, nur Leerzeichen.
|
||
|
||
---
|
||
|
||
## 🧩 Funktionen und wie du sie einrichtest
|
||
|
||
### 🏠 Spawn
|
||
|
||
Spieler landen beim Joinen und nach dem Tod am Spawn.
|
||
|
||
- Setzen: `/nexus setspawn`
|
||
- Hinkommen: `/spawn` (auch `/l` und `/hub`)
|
||
|
||
### 📊 Scoreboard (die Anzeige rechts)
|
||
|
||
Die Texte stehen in `visuals.yml` unter `scoreboard:`. Dort gibt es einen Titel und Zeilen für normale Spieler (`default`) und für Admins (`owner`).
|
||
|
||
- Ein- und ausschalten für dich: `/nexus sb on` und `/nexus sb off`
|
||
- Admin-Version zeigen: `/nexus sb admin`
|
||
- Spieler-Version zeigen: `/nexus sb spieler`
|
||
- Soll es für neue Spieler **standardmäßig ausgeblendet** sein? In `config.yml`: `scoreboard-default-visible: false`
|
||
- Wie oft es sich aktualisiert, steht in `visuals.yml` bei `update_ticks` (20 = jede Sekunde).
|
||
|
||
> 💡 Damit Platzhalter wie `%luckperms_prefix%` oder `%bungee_total%` funktionieren, brauchst du **PlaceholderAPI**. Siehe [Probleme und Lösungen](#-probleme-und-lösungen).
|
||
|
||
### 📋 Tablist (die Liste mit der TAB-Taste)
|
||
|
||
In `config.yml` unter `tablist:`. Dort stellst du Kopfzeile (`header`), Fußzeile (`footer`) und das Aktualisierungsintervall ein.
|
||
|
||
### 🚧 Lobby-Grenze (Border)
|
||
|
||
Eine **unsichtbare** Grenze, die Spieler nicht überschreiten dürfen. Wer sie überschreitet, wird zum Spawn zurückgeschickt.
|
||
|
||
**Rund (Kreis):**
|
||
1. Stell dich in die **Mitte** der Lobby.
|
||
2. Gib ein: `/border circle 50` (50 ist der Radius in Blöcken).
|
||
|
||
**Eckig (Rechteck):**
|
||
1. Hol dir das Werkzeug mit `/giveportalwand`.
|
||
2. **Linksklick** auf eine Ecke und **Rechtsklick** auf die gegenüberliegende Ecke.
|
||
3. Gib ein: `/border square`
|
||
|
||
**Ausschalten:** `/border disable`
|
||
|
||
> ⚠️ **Zum Testen:** Wer das Recht `nexuslobby.admin` oder `nexuslobby.border.bypass` hat, wird **nicht** zurückgeschickt. Teste mit einem normalen Account.
|
||
|
||
### 🌀 Portale
|
||
|
||
Portale schicken Spieler auf einen anderen Server oder an einen anderen Ort.
|
||
|
||
**So erstellst du ein Portal (der Ablauf ist wichtig):**
|
||
|
||
1. **Werkzeug holen:** `/giveportalwand` (du bekommst einen Blaze Rod).
|
||
2. **Zwei Ecken markieren:** **Linksklick** auf einen Block = Position 1, **Rechtsklick** auf einen Block = Position 2. Du musst einen Block anklicken, nicht in die Luft.
|
||
3. **Portal erstellen:**
|
||
```
|
||
/portal create <Name> <server|world>
|
||
```
|
||
- `server` = auf einen anderen Server (über BungeeCord)
|
||
- `world` = an einen anderen Ort auf diesem Server
|
||
4. **Ziel setzen (nicht vergessen!):**
|
||
```
|
||
/portal setdest <Name> <Ziel>
|
||
```
|
||
|
||
**Beispiele für das Ziel:**
|
||
|
||
| Portal-Typ | Befehl | Bedeutung |
|
||
|------------|--------|-----------|
|
||
| Server | `/portal setdest Survival survival` | Schickt zum BungeeCord-Server `survival` |
|
||
| Welt, zum Spawn | `/portal setdest Hub SPAWN` | Schickt zum Lobby-Spawn |
|
||
| Welt, Koordinaten | `/portal setdest Mini world_mini 0 64 0` | Schickt zu diesen Koordinaten |
|
||
|
||
> ⚠️ **Ohne `setdest` steht beim Betreten „Verbinde zum Server: null“.** Dann hat das Portal kein Ziel. Der Servername muss genau so heißen wie in deiner BungeeCord-Config. Er ist derselbe wie bei `/server survival`.
|
||
|
||
**Weitere Portal-Befehle:**
|
||
|
||
| Befehl | Was er macht |
|
||
|--------|--------------|
|
||
| `/portal setparticle <Name> <Partikel>` | Ändert den Partikel, z. B. `END_ROD`, `FLAME`, `HEART`, `HAPPY_VILLAGER` |
|
||
| `/portal setspawn <Name>` | Setzt, wo der Spieler vor dem Server-Wechsel steht. Stell dich davor, er wird 2 Blöcke hinter dich gesetzt |
|
||
| `/portal list` | Zeigt alle Portale |
|
||
| `/portal delete <Name>` | Löscht ein Portal |
|
||
|
||
> 💡 Schreibe den Portalnamen **genau so**, wie du ihn beim Erstellen geschrieben hast (Groß- und Kleinschreibung).
|
||
|
||
### 🏃 Parkour
|
||
|
||
Ein Parkour mit Zeitmessung, Checkpoints, Bestenliste und Trainer-NPC. Es gibt **zwei Strecken** (1 und 2). Beim Start wird zufällig eine gewählt.
|
||
|
||
**Einrichten (Beispiel Strecke 1):**
|
||
|
||
1. **Start:** Stell dich an den Start und gib `/nexus parkour setstart 1` ein. Schaust du dabei einen ArmorStand (den Trainer) an, wird er automatisch zum Start-NPC.
|
||
2. **Checkpoints:** Geh zu jedem Checkpoint **in der richtigen Reihenfolge** und gib dort `/nexus parkour setcheckpoint 1` ein.
|
||
3. **Ziel:** Stell dich ins Ziel und gib `/nexus parkour setfinish 1` ein.
|
||
4. **Prüfen:** `/nexus parkour info`
|
||
|
||
Für Strecke 2 machst du dasselbe mit der `2` am Ende.
|
||
|
||
> 💡 **Beide Strecken sollten gleich viele Checkpoints haben.** Sonst steht eine Warnung in der Konsole, und die Strecken sind unterschiedlich lang.
|
||
|
||
**Bestenliste als Hologramm:** Stell dich dorthin, wo sie stehen soll, und gib `/nexus parkour holo 1` ein. Das braucht PlaceholderAPI.
|
||
|
||
**Weitere Parkour-Befehle:**
|
||
|
||
| Befehl | Was er macht |
|
||
|--------|--------------|
|
||
| `/nexus parkour reset` | Bricht deinen eigenen Lauf ab (das darf jeder) |
|
||
| `/nexus parkour clear` | Löscht alle Bestzeiten |
|
||
| `/nexus parkour removeall` | Löscht die komplette Strecke |
|
||
|
||
**Sturz-Höhe einstellen (wichtig):**
|
||
|
||
Wer unter eine bestimmte Höhe fällt, kommt zum letzten Checkpoint zurück. Standard ist **Höhe Y = 50**. Liegt dein Parkour oder der Trainer **unter 50**, wirst du bei jedem Schritt zurückgesetzt, und der Chat läuft mit „Abgestürzt!“ voll.
|
||
|
||
Die Lösung: In `plugins/NexusLobby/config.yml` (nicht in `parkour.yml`) fügst du ein:
|
||
|
||
```yaml
|
||
parkour:
|
||
fall_y: 40
|
||
```
|
||
|
||
Der Wert muss **unter dem tiefsten Punkt** liegen, an dem Spieler stehen. Deine Höhe siehst du mit **F3** bei `XYZ` (die mittlere Zahl).
|
||
|
||
### ⚽ Fußball
|
||
|
||
Ein Ball, den Spieler schießen und dribbeln können. Mit Toren und Teams.
|
||
|
||
| Befehl | Was er macht |
|
||
|--------|--------------|
|
||
| `/nexus ball setspawn` | Setzt, wo der Ball erscheint |
|
||
| `/nexus ball respawn` | Holt den Ball neu |
|
||
| `/nexus ball remove` | Entfernt den Ball |
|
||
|
||
**Tor einrichten:**
|
||
1. Geh zur **inneren Ecke** des Tors und gib `/nexus ball goal pos1` ein.
|
||
2. Geh zur **gegenüberliegenden Ecke** (auch 1 bis 2 Blöcke hinter das Tor) und gib `/nexus ball goal pos2` ein.
|
||
3. Speichern: `/nexus ball goal save torBlau 1` (Team 1 = Blau, Team 2 = Rot).
|
||
|
||
Die Box muss mindestens **3 Blöcke hoch** und **1,5 Blöcke tief** sein. Mit `/nexus ball goal show` machst du sie sichtbar. Mit `/nexus ball goal debug` siehst du die Ball-Position live.
|
||
|
||
Wenn der Ball nichts tut, prüfe in `config.yml` unter `ball:`, ob `enabled: true` steht.
|
||
|
||
### 🤖 NPCs und Gespräche
|
||
|
||
Mit ArmorStands baust du NPCs. Die können Gespräche führen, dir mit dem Blick folgen und Befehle ausführen.
|
||
|
||
**NPC bearbeiten:** Schau einen ArmorStand an und gib `/nexustools` ein (auch `/nt`). Es öffnet sich ein Menü.
|
||
|
||
**Befehle:**
|
||
|
||
| Befehl | Was er macht |
|
||
|--------|--------------|
|
||
| `/nexuscmd lookat` | Der NPC schaut Spielern nach (an und aus) |
|
||
| `/nexuscmd name <Text>` | Gibt dem NPC einen Namen. `none` entfernt ihn |
|
||
| `/nexuscmd say <Text>` | Der NPC sagt etwas in einer Sprechblase |
|
||
|
||
Du musst dabei den NPC **anschauen**.
|
||
|
||
**Gespräch zwischen NPCs einrichten:**
|
||
|
||
1. Schau den ersten NPC an: `/nexuscmd conv select1`
|
||
2. Schau den zweiten NPC an: `/nexuscmd conv select2`
|
||
3. Optional: `select3` und `select4` für bis zu vier NPCs
|
||
4. Verknüpfen: `/nexuscmd conv link <Gespräch-ID>`
|
||
5. Testen: `/nexuscmd conv start <Gespräch-ID>`
|
||
6. Wieder lösen: Schau den NPC an und gib `/nexuscmd conv unlink` ein.
|
||
|
||
Du brauchst **mindestens zwei NPCs**, auch wenn im Text nur einer spricht.
|
||
|
||
**Eigene Gespräche schreiben:** In `conversations.yml`. Jedes Gespräch hat drei Tageszeiten (`morgens`, `mittags`, `abends`) mit je einer Liste von Zeilen:
|
||
|
||
```yaml
|
||
conversations:
|
||
mein_gespraech:
|
||
morgens:
|
||
dialogue:
|
||
- '&eWächter: &7Guten Morgen!'
|
||
- '&aBürger: &7Dir auch!'
|
||
mittags:
|
||
dialogue:
|
||
- '&eWächter: &7Schöner Tag heute.'
|
||
abends:
|
||
dialogue:
|
||
- '&eWächter: &7Gute Nacht!'
|
||
```
|
||
|
||
Danach `/nexus reload`. Das Gespräch kannst du dann mit `mein_gespraech` verknüpfen.
|
||
|
||
> 💡 Schon dabei sind unter anderem `parkour_begruessung`, `owner_besuch`, `fussball_match`, `baum_drama` und `familien_spaziergang`.
|
||
|
||
### 🔤 Hologramme
|
||
|
||
Schwebende Texte.
|
||
|
||
- Erstellen: `/holo create <ID> <Text>`
|
||
- Löschen: `/holo delete <ID>`
|
||
|
||
### 🖼️ MapArt
|
||
|
||
Ein Bild aus dem Internet als Wandbild aus Item-Frames.
|
||
|
||
```
|
||
/mapart <Bild-URL> <Breite>x<Höhe>
|
||
```
|
||
|
||
Beispiel: `/mapart https://example.com/bild.png 3x2`
|
||
|
||
### 🎬 Intro-Tour
|
||
|
||
Eine Kamerafahrt für neue Spieler.
|
||
|
||
| Befehl | Was er macht |
|
||
|--------|--------------|
|
||
| `/intro add` | Fügt einen Kamerapunkt an deiner Position hinzu |
|
||
| `/intro clear` | Löscht alle Punkte |
|
||
| `/intro start` | Startet die Tour zum Testen |
|
||
|
||
### 🔨 Baumodus
|
||
|
||
Normale Spieler dürfen in der Lobby nichts bauen. Mit `/build` schaltest du den **Baumodus** für dich ein und aus. Du brauchst dafür das Recht `nexuslobby.build`.
|
||
|
||
### 🔧 Wartungsmodus
|
||
|
||
Sperrt den Server für normale Spieler, während du daran arbeitest.
|
||
|
||
- Einschalten: `/maintenance on`
|
||
- Ausschalten: `/maintenance off`
|
||
- Wer trotzdem joinen darf, braucht das Recht `nexuslobby.join.maintenance`.
|
||
- Die Kick-Nachricht steht in `config.yml` unter `maintenance:`.
|
||
|
||
### 🛡️ VPN- und Länder-Sperre
|
||
|
||
Schließt Spieler mit VPN oder Proxy und Spieler aus bestimmten Ländern aus.
|
||
|
||
**Die Einstellungen stehen in `settings.yml`:**
|
||
|
||
```yaml
|
||
security:
|
||
vpn-blocker:
|
||
enabled: false # true = VPN und Proxy sperren
|
||
kick-message: "&cVPN und Proxies sind auf diesem Server nicht erlaubt!"
|
||
|
||
country-blocker:
|
||
enabled: false # true = nur bestimmte Länder erlauben
|
||
allowed-countries:
|
||
- "DE"
|
||
- "AT"
|
||
- "CH"
|
||
kick-message: "&cZugriff aus deinem Land (%country%) ist leider nicht gestattet."
|
||
```
|
||
|
||
- `enabled: false` heißt: Die Sperre ist **aus**. Das ist der Standard, wenn nichts eingetragen ist.
|
||
- Wer das Recht `nexuslobby.security.bypass` hat, wird nie gesperrt. Dafür muss **LuckPerms** installiert sein.
|
||
- Die Prüfung nutzt den kostenlosen Dienst `ip-api.com`. Mobilfunk- und Hoster-IPs werden dort manchmal fälschlich als VPN erkannt. Wenn jemand zu Unrecht gekickt wird, gib ihm das Bypass-Recht.
|
||
|
||
### 🦘 Doppelsprung, Void-Schutz und mehr
|
||
|
||
Alle diese Funktionen schaltest du in `config.yml` mit `enabled: true` oder `false` ein und aus:
|
||
|
||
| Funktion | Bereich in `config.yml` | Was sie macht |
|
||
|----------|-------------------------|---------------|
|
||
| **Doppelsprung** | `doublejump:` | In der Luft nochmal springen. Mit `velocity` stellst du die Höhe ein |
|
||
| **Void-Schutz** | `void_protection:` | Wer in die Leere fällt, kommt zum Spawn |
|
||
| **Spieler verstecken** | `hider:` | Ein Item, mit dem Spieler andere ausblenden |
|
||
| **Kompass-Menü** | `compass:` und `items:` | Menü zum Server-Wechsel |
|
||
| **Server-Status** | `servers:` | Zeigt an ArmorStands, ob ein Server online ist |
|
||
| **Spieler-Info** | `player_inspect:` | Rechtsklick auf einen Spieler zeigt dessen Statistiken |
|
||
|
||
**Lobby-Regeln** (PvP, Bauen, Items droppen, Explosionen, Fallschaden …) stehen in `settings.yml`. Ingame öffnest du sie mit `/settings`, ein Klick-Menü.
|
||
|
||
---
|
||
|
||
## 📋 Alle Befehle
|
||
|
||
`<…>` bedeutet: Du musst etwas eintragen. `[…]` bedeutet: optional.
|
||
|
||
### Allgemein
|
||
|
||
| Befehl | Was er macht | Recht |
|
||
|--------|--------------|-------|
|
||
| `/spawn` (auch `/l`, `/hub`) | Zum Spawn | alle |
|
||
| `/serverswitcher` | Server-Menü öffnen | `nexuslobby.serverswitcher` |
|
||
| `/build` | Baumodus ein/aus | `nexuslobby.build` |
|
||
| `/settings` | Lobby-Regeln ändern | `nexuslobby.admin` |
|
||
| `/maintenance <on\|off>` | Wartungsmodus | `nexuslobby.maintenance` |
|
||
|
||
### Verwaltung (`/nexus`, auch `/nexuslobby` und `/lobby`)
|
||
|
||
| Befehl | Was er macht | Recht |
|
||
|--------|--------------|-------|
|
||
| `/nexus reload` | Einstellungen neu laden | `nexuslobby.admin` |
|
||
| `/nexus setspawn` | Spawn setzen | `nexuslobby.admin` |
|
||
| `/nexus silentjoin <on\|off>` | Join und Quit unsichtbar | `nexuslobby.admin` |
|
||
| `/nexus sb <on\|off\|admin\|spieler>` | Scoreboard steuern | `nexuslobby.admin` |
|
||
|
||
### Parkour
|
||
|
||
| Befehl | Was er macht |
|
||
|--------|--------------|
|
||
| `/nexus parkour setstart <1\|2>` | Start setzen |
|
||
| `/nexus parkour setcheckpoint <1\|2>` | Checkpoint setzen |
|
||
| `/nexus parkour setfinish <1\|2>` | Ziel setzen |
|
||
| `/nexus parkour holo <1\|2>` | Bestenlisten-Hologramm |
|
||
| `/nexus parkour info` | Zeigt die Strecken |
|
||
| `/nexus parkour reset` | Eigenen Lauf abbrechen |
|
||
| `/nexus parkour clear` | Bestzeiten löschen |
|
||
| `/nexus parkour removeall` | Strecke löschen |
|
||
|
||
Recht: `nexuslobby.admin` (nur `reset` darf jeder).
|
||
|
||
### Fußball
|
||
|
||
| Befehl | Was er macht |
|
||
|--------|--------------|
|
||
| `/nexus ball setspawn` | Ball-Spawn setzen |
|
||
| `/nexus ball respawn` | Ball neu holen |
|
||
| `/nexus ball remove` | Ball entfernen |
|
||
| `/nexus ball goal pos1`, `pos2`, `save <Name> <Team>`, `show`, `debug` | Tore einrichten |
|
||
|
||
### Portale und Grenze
|
||
|
||
| Befehl | Was er macht | Recht |
|
||
|--------|--------------|-------|
|
||
| `/giveportalwand` | Portal-Werkzeug | `nexuslobby.portal.give` |
|
||
| `/portal create <Name> <server\|world>` | Portal erstellen | `nexuslobby.portal` |
|
||
| `/portal setdest <Name> <Ziel>` | Ziel setzen | `nexuslobby.portal` |
|
||
| `/portal setparticle <Name> <Partikel>` | Partikel ändern | `nexuslobby.portal` |
|
||
| `/portal setspawn <Name>` | Ankunftspunkt setzen | `nexuslobby.portal` |
|
||
| `/portal list` | Alle Portale | `nexuslobby.portal` |
|
||
| `/portal delete <Name>` | Portal löschen | `nexuslobby.portal` |
|
||
| `/border circle <Radius>` | Runde Grenze | `nexuslobby.admin` |
|
||
| `/border square` | Eckige Grenze | `nexuslobby.admin` |
|
||
| `/border disable` | Grenze aus | `nexuslobby.admin` |
|
||
|
||
### NPCs und Extras
|
||
|
||
| Befehl | Was er macht | Recht |
|
||
|--------|--------------|-------|
|
||
| `/nexustools` (auch `/nt`) | NPC-Editor | `nexuslobby.armorstand.use` |
|
||
| `/nexuscmd …` (auch `/ncmd`, `/conv`) | NPC-Befehle und Gespräche | `nexuslobby.armorstand.cmd` |
|
||
| `/holo create <ID> <Text>` | Hologramm erstellen | `nexuslobby.hologram` |
|
||
| `/holo delete <ID>` | Hologramm löschen | `nexuslobby.hologram` |
|
||
| `/mapart <URL> <BxH>` | MapArt erstellen | `nexuslobby.mapart` |
|
||
| `/intro <add\|clear\|start>` | Intro-Tour | `nexuslobby.admin` |
|
||
|
||
---
|
||
|
||
## 🔐 Rechte vergeben
|
||
|
||
Rechte steuerst du am einfachsten mit **LuckPerms**. Ein Recht gibst du so:
|
||
|
||
```
|
||
/lp user <Spielername> permission set <Recht> true
|
||
```
|
||
|
||
Für eine ganze Gruppe (z. B. alle Admins):
|
||
|
||
```
|
||
/lp group admin permission set <Recht> true
|
||
```
|
||
|
||
**Beispiel:** Dem Spieler `M_Viper` das Recht zum Bauen geben:
|
||
|
||
```
|
||
/lp user M_Viper permission set nexuslobby.build true
|
||
```
|
||
|
||
### Die wichtigsten Rechte
|
||
|
||
| Recht | Was es erlaubt |
|
||
|-------|----------------|
|
||
| `nexuslobby.admin` | Fast alles: Reload, Spawn, Border, Parkour, Einstellungen |
|
||
| `nexuslobby.build` | Baumodus nutzen |
|
||
| `nexuslobby.portal` | Portale erstellen und löschen |
|
||
| `nexuslobby.portal.give` | Portal-Werkzeug bekommen |
|
||
| `nexuslobby.maintenance` | Wartungsmodus schalten |
|
||
| `nexuslobby.armorstand.use` | NPC-Editor öffnen |
|
||
| `nexuslobby.armorstand.cmd` | NPC-Befehle und Gespräche |
|
||
| `nexuslobby.hologram` | Hologramme verwalten |
|
||
| `nexuslobby.mapart` | MapArt erstellen |
|
||
| `nexuslobby.serverswitcher` | Server-Menü öffnen (**alle Spieler haben es standardmäßig**) |
|
||
| `nexuslobby.scoreboard.admin` | Admin-Scoreboard sehen |
|
||
|
||
### Ausnahmen (Bypass)
|
||
|
||
| Recht | Was es umgeht |
|
||
|-------|---------------|
|
||
| `nexuslobby.security.bypass` | VPN- und Länder-Sperre |
|
||
| `nexuslobby.join.maintenance` | Wartungsmodus (darf trotzdem joinen) |
|
||
| `nexuslobby.border.bypass` | Die Lobby-Grenze |
|
||
|
||
> 💡 Alle diese Rechte haben **OPs** automatisch. Normale Spieler bekommen nur `nexuslobby.serverswitcher` von selbst.
|
||
|
||
---
|
||
|
||
## 🛠️ Probleme und Lösungen
|
||
|
||
### Im Scoreboard steht `%luckperms_prefix%` oder `%bungee_total%`
|
||
|
||
**Ursache:** PlaceholderAPI fehlt oder ihm fehlen die Erweiterungen.
|
||
|
||
**Lösung:** PlaceholderAPI installieren. Dann in der Server-Konsole:
|
||
|
||
```
|
||
/papi ecloud download LuckPerms
|
||
/papi ecloud download Bungee
|
||
/papi reload
|
||
```
|
||
|
||
### Ich werde mit „Abgestürzt! Zurück zum Checkpoint.“ im Dauerfeuer zugespammt
|
||
|
||
**Ursache:** Dein Trainer-NPC oder Parkour liegt tiefer als die Sturz-Höhe (Standard Y = 50).
|
||
|
||
**Lösung:** In `config.yml` einen niedrigeren Wert setzen. Siehe [Parkour](#-parkour), Abschnitt „Sturz-Höhe“.
|
||
|
||
### Beim Portal steht „Verbinde zum Server: null“
|
||
|
||
**Ursache:** Dem Portal fehlt das Ziel.
|
||
|
||
**Lösung:** `/portal setdest <Name> <Servername>`. Siehe [Portale](#-portale).
|
||
|
||
### „Bitte markiere erst zwei Punkte mit dem Portal-Werkzeug!“
|
||
|
||
**Ursache:** Du hast `/portal create` benutzt, ohne vorher zwei Ecken zu markieren.
|
||
|
||
**Lösung:** Erst `/giveportalwand`, dann Links- und Rechtsklick auf zwei Blöcke, dann `/portal create`.
|
||
|
||
### Ich werde beim Joinen gekickt, obwohl der VPN-Blocker aus ist
|
||
|
||
**Ursache:** Bis Version 2.0 las das Plugin die Sperre aus der falschen Datei.
|
||
|
||
**Lösung:** Auf **Version 2.1** aktualisieren und in `settings.yml` prüfen, dass `enabled: false` steht. Danach Server neu starten. Wenn es weiter passiert, steht der Grund in der Server-Konsole. Es könnte auch der Wartungsmodus sein.
|
||
|
||
### Das Scoreboard flackert
|
||
|
||
**Ursache:** In Version 2.0 und älter wurde es jede Sekunde komplett neu aufgebaut.
|
||
|
||
**Lösung:** Auf **Version 2.1** aktualisieren. Wenn es danach noch flackert, läuft ein zweites Scoreboard- oder Tab-Plugin (z. B. TAB). Schalte eines davon aus.
|
||
|
||
### Ich werde an der Grenze nicht zurückgeschickt
|
||
|
||
**Ursache:** Du bist OP oder hast `nexuslobby.border.bypass`.
|
||
|
||
**Lösung:** Teste mit einem normalen Account.
|
||
|
||
### Der Ball erscheint mehrfach
|
||
|
||
**Lösung:** `/nexus ball remove`, danach `/nexus ball setspawn`.
|
||
|
||
### NPCs schauen den Spielern nicht nach
|
||
|
||
**Lösung:** Schau den NPC an und gib `/nexuscmd lookat` ein. Es schaltet um. Wenn es an war, ist es jetzt aus, gib den Befehl dann noch einmal ein.
|
||
|
||
### Der Server-Status am NPC stimmt nicht
|
||
|
||
**Lösung:** Prüfe in `config.yml` unter `servers:` die IP und den Port. Der Name muss genau dem BungeeCord-Servernamen entsprechen. Der Server muss erreichbar sein (Firewall, Ports).
|
||
|
||
### Nach einer Änderung passiert nichts
|
||
|
||
**Lösung:** Hast du die Datei gespeichert? Dann `/nexus reload`. Bei einer neuen Jar-Datei brauchst du einen **Neustart**.
|
||
|
||
---
|
||
|
||
## 🆕 Änderungen in Version 2.1
|
||
|
||
- 🐛 **Scoreboard flackert nicht mehr.** Es wird nur noch aktualisiert, was sich wirklich ändert.
|
||
- 🐛 **VPN- und Länder-Sperre** lesen jetzt die `settings.yml`. Vorher wurde dein Wert ignoriert, und Spieler wurden trotz `enabled: false` gekickt.
|
||
- 🐛 **Die Kick-Nachricht ist nie mehr leer.** Es gibt einen Standardtext.
|
||
- 🔧 Ist keine Sperre eingetragen, ist sie **aus** (vorher an).
|
||
- 🔧 Die Sperre stürzt nicht mehr ab, wenn der Prüfdienst unvollständig antwortet.
|
||
|
||
---
|
||
|
||
## 💬 Hilfe und Lizenz
|
||
|
||
- 🌐 Webseite: https://m-viper.de
|
||
- 📚 Dokumentation: https://viper-network.de/wiki/NexusLobby/
|
||
- 💬 Discord: https://discord.com/invite/FdRs4BRd8D
|
||
|
||
**Wenn du Hilfe brauchst:** Schreib im Discord, welche **Version** du hast, was du **gemacht** hast und was **passiert ist**. Ein Screenshot oder die Fehlerzeile aus der Server-Konsole hilft sehr.
|
||
|
||
### Lizenz und Nutzungsbedingungen
|
||
|
||
**ALLE RECHTE VORBEHALTEN.** Dieses Plugin ist urheberrechtlich geschützt.
|
||
|
||
- Die Weitergabe, Verbreitung oder Veröffentlichung ist **untersagt**.
|
||
- Änderungen, Modifikation oder Dekompilierung des Codes sind **verboten**.
|
||
- Das Plugin darf nicht verkauft, vermietet oder kommerziell genutzt werden.
|
||
- Eine Weitergabe an Dritte ist ohne ausdrückliche schriftliche Genehmigung nicht gestattet.
|
||
|
||
Bei Verstößen behalten wir uns rechtliche Schritte vor.
|
||
|
||
**Copyright © 2026 – M_Viper – Alle Rechte vorbehalten**
|