# 🌐 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.

![Minecraft](https://img.shields.io/badge/Minecraft-1.21+-green)
![Java](https://img.shields.io/badge/Java-21+-orange)
![Version](https://img.shields.io/badge/Version-2.1-blue)
![License](https://img.shields.io/badge/License-Proprietary-red)

---

## 📖 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**