Table of Contents

Parkour

🛠 Features
📋 Einrichtung & Workflow

1. Den Start-NPC markieren
2. Die Strecke definieren
3. Das Ziel festlegen
4. Status prüfen

🏆 Leaderboard & Hologramme
💻 Befehlsreferenz

Für Administratoren
Für Spieler

🔒 Berechtigungen
⚠️ Wichtige Hinweise
📊 Datenstruktur (parkour.yml)

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.

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 (SOUL_FIRE_FLAME) markiert.
Ziel-Erkennung: Grüne Partikel (HAPPY_VILLAGER) 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: Für jede Strecke gibt es eine eigene Top 10 (parkour1 und parkour2), die als Hologramm angezeigt werden.
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 parkour_npc (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 & Hologramme

Für jede Strecke gibt es ein eigenes Leaderboard-Hologramm:

Strecke 1: Hologramm-ID parkour1
Strecke 2: Hologramm-ID parkour2

Die Hologramme werden automatisch am Zielpunkt aktualisiert, sobald ein neuer Rekord erreicht wird.

Manuelles Setzen/Bewegen eines Hologramms:

/holo create parkour1 <NONE|FAST|SLOW> <Text>
/holo create parkour2 <NONE|FAST|SLOW> <Text>

Als <Text> kann auch %nexuslobby_parkour_top_1% bzw. %nexuslobby_parkour_top_2% verwendet werden, wenn du PlaceholderAPI nutzt.

💻 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.

besttimes: names:

📊 Datenstruktur (parkour.yml)

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:
  1:
    <uuid>: <sekunden>   # Bestzeiten für Strecke 1
  2:
    <uuid>: <sekunden>   # Bestzeiten für Strecke 2
names:
  1:
    <uuid>: <spielername>
  2:
    <uuid>: <spielername>