Parkour

Das Parkour-System von NexusLobby ist ein modulares, partikelbasiertes System, das ohne physische Druckplatten oder Blöcke auskommt. Spieler interagieren mit einem markierten NPC, starten einen Timer und müssen eine unsichtbare Strecke ablaufen, die nur durch Partikel sichtbar wird.

🛠 Features

• NPC-Interaktion: Startet ausschließlich durch Rechtsklick auf einen markierten ArmorStand.
• Zwei Strecken: Es können zwei vollständige Parcours (Strecke 1 & 2) hinterlegt werden. Beim Start wird zufällig eine der beiden gewählt – beide müssen die gleiche Anzahl an Checkpoints haben.
• Dynamische Checkpoints: Werden per Befehl gesetzt und durch blaue Partikel (SOULFIREFLAME) markiert.
• Ziel-Erkennung: Grüne Partikel (HAPPYVILLAGER) erscheinen erst, wenn alle Checkpoints passiert wurden.
• Automatischer Reset: Fällt ein Spieler unter Höhe Y=50, wird er zum letzten Checkpoint teleportiert.
• Live-Timer: Die aktuelle Laufzeit wird in Echtzeit in der Actionbar angezeigt.
• Leaderboard: Speichert die Top 10 Bestzeiten in der parkour.yml.
• Gadget-Schutz: Spieler im aktiven Parkour sind immun gegen Freeze-Ray, Meteorit und Enterhaken anderer Spieler.

—

📋 Einrichtung & Workflow

Alle Setup-Befehle erfordern am Ende eine Strecken-Nummer: 1 oder 2.

1. Den Start-NPC markieren

Platziere einen ArmorStand als Start-Figur. Schau ihn direkt an und nutze:
„`
/nexus parkour setstart <1|2>
„`

• Markiert den ArmorStand intern mit dem Tag parkournpc (wird von beiden Strecken geteilt).
• Speichert deine aktuelle Position als Startpunkt der gewählten Strecke.

2. Die Strecke definieren

Laufe den Parcours-Weg ab. An jedem Zwischenpunkt nutze:
„`
/nexus parkour setcheckpoint <1|2>
„`

• Checkpoints werden automatisch nummeriert (#1, #2, …).
• Spieler müssen die Punkte in exakter Reihenfolge passieren.
• Wichtig: Beide Strecken sollten die gleiche Anzahl an Checkpoints haben.

3. Das Ziel festlegen

Gehe zum Endpunkt und nutze:
„`
/nexus parkour setfinish <1|2>
„`

• Setzt den Punkt, an dem der Timer stoppt und die Zeit gewertet wird.

4. Status prüfen

„`
/nexus parkour info
„`
Zeigt an, welche Strecken vollständig konfiguriert sind (✔/✘) und wie viele Checkpoints sie haben.

—

🏆 Leaderboard & Placeholder

| Placeholder | Beschreibung |
|————-|————–|
| %nexuslobbyparkourtop% | Gibt die vollständige Top-10-Liste mit Spielernamen und Zeiten aus. |

Beispiel für ein Hologramm:
„`
/holo create parkour none %nexuslobbyparkourtop%
„`

—

💻 Befehlsreferenz

Für Administratoren

| Befehl | Beschreibung |
|——–|————–|
| /nexus parkour setstart <1|2> | Markiert den NPC und setzt die Start-Position der gewählten Strecke. |
| /nexus parkour setcheckpoint <1|2> | Fügt einen Checkpoint an der aktuellen Position zur gewählten Strecke hinzu. |
| /nexus parkour setfinish <1|2> | Setzt das Ziel der gewählten Strecke. |
| /nexus parkour info | Zeigt den Konfigurations-Status beider Strecken. |
| /nexus parkour removeall | Löscht beide Strecken vollständig (Checkpoints & Ziel). |
| /nexus parkour clear | Löscht alle gespeicherten Bestzeiten (Top 10). |

Für Spieler

| Befehl | Beschreibung |
|——–|————–|
| /nexus parkour reset | Bricht den aktuellen Lauf ab. |
| /spawn | Teleportiert zum Lobby-Spawn und bricht den Parkour ab. |

—

🔒 Berechtigungen

| Permission | Beschreibung |
|————|————–|
| nexuslobby.admin | Vollzugriff auf alle Setup-Befehle und Verwaltungsfunktionen. |

—

⚠️ Wichtige Hinweise

• Zwei Strecken, gleiche Länge: Das System wählt beim Start zufällig eine Strecke. Haben beide eine unterschiedliche Checkpoint-Anzahl, erscheint eine Warnung im Server-Log, der Parcours startet trotzdem.
• Nur eine Strecke konfiguriert: Ist nur Strecke 1 oder nur Strecke 2 vollständig eingerichtet, wird automatisch die verfügbare gewählt – kein Fehler.
• Streckenänderung: Nutze /nexus parkour removeall, um beide Strecken zu löschen und komplett neu zu beginnen. Laufende Runs werden dabei automatisch beendet.
• Absturzsicherung: Der Teleport zum Checkpoint greift bei Y < 50. Baue deinen Parcours oberhalb dieser Höhe.
• Gadget-Schutz: Spieler, die aktiv einen Parcours absolvieren, können nicht durch Freeze-Ray oder Meteorit gestört werden.

—

📊 Datenstruktur (parkour.yml)

„`yaml
tracks:
1:
start: # Startposition Strecke 1
finish: # Ziel Strecke 1
checkpoints:
1: …
2: …
2:
start: # Startposition Strecke 2
finish: # Ziel Strecke 2
checkpoints:
1: …
2: …

besttimes:
: # Schnellste Zeit des Spielers (streckenübergreifend)

names:
:
„`