Parkour hinzugefügt

Parkour.md

@@ -0,0 +1,75 @@
+# 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.
+* **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**: Speichert die Top 10 Bestzeiten in der Datenbank.
+
+## 📋 Einrichtung & Workflow
+
+### 1. Den Start-NPC markieren
+
+Platziere einen ArmorStand als Start-Figur. Schau ihn an und nutze:
+
+* `/setstart`
+  * Markiert den NPC intern mit dem Tag `parkour_npc`.
+  * Speichert deine aktuelle Position als Startpunkt für den Timer.
+
+### 2. Die Strecke definieren
+
+Laufe den Parkour-Weg ab. An jedem Punkt, der als Zwischenspeicher dienen soll, nutze:
+
+* `/setcheckpoint`
+  * Das System nummeriert die Punkte automatisch (Checkpoint #1, #2, etc.).
+  * Spieler müssen diese Punkte in der exakten Reihenfolge passieren.
+
+### 3. Das Ziel festlegen
+
+Gehe zum Endpunkt deines Parkours und nutze:
+
+* `/setfinish`
+  * Setzt den Punkt, an dem der Timer stoppt und die Zeit gewertet wird.
+
+## 💻 Befehlsreferenz
+
+### Für Administratoren
+
+| Befehl | Beschreibung |
+|--------|--------------|
+| `/setstart` | Markiert den NPC und setzt die Start-Position. |
+| `/setcheckpoint` | Fügt einen neuen Checkpoint an der aktuellen Position hinzu. |
+| `/setfinish` | Setzt das Ziel des Parkours. |
+| `/nexus parkour removeall` | Löscht die gesamte Strecke (Checkpoints & Ziel), um einen Neubau zu ermöglichen. |
+| `/nexus parkour clear` | Löscht alle gespeicherten Bestzeiten (Top 10). |
+
+### Für Spieler
+
+| Befehl | Beschreibung |
+|--------|--------------|
+| `/nexus parkour reset` | Bricht den aktuellen Lauf ab und blendet Timer/Partikel aus. |
+| `/spawn` | Teleportiert zum Lobby-Spawn und bricht den Parkour ab. |
+
+## 🔒 Berechtigungen (Permissions)
+
+* `nexuslobby.admin`: Voller Zugriff auf alle Setup-Befehle (`/set...`) sowie das Löschen der Strecke und der Statistiken.
+* `nexuslobby.silentjoin`: Erlaubt das Betreten des Servers ohne Join-Nachricht.
+
+## ⚠️ Wichtige Hinweise zur Verwaltung
+
+* **Sicherheit**: Die Konfiguration erfolgt ausschließlich über In-Game-Befehle. Manuelle Änderungen an den Konfigurationsdateien sind nicht vorgesehen, um die Datenintegrität zu schützen.
+* **Streckenänderung**: Wenn du eine Strecke ändern möchtest, nutze `/nexus parkour removeall`. Dies bereinigt die Konfiguration vollständig, sodass du sofort mit `/setcheckpoint` eine neue Route von Grund auf bauen kannst.
+* **Absturzsicherung**: Der automatische Teleport zurück zum Checkpoint greift standardmäßig bei Y=50. Achte darauf, dass dein Parkour über dieser Höhe gebaut wird.
+
+## 📊 Datenstruktur (`parkour.yml`)
+
+Das System verwaltet die Daten automatisch. Hier ein Einblick in die Struktur:
+
+* `locations`: Speichert Start, Ziel und alle durchnummerierten Checkpoints.
+* `besttimes`: Speichert die schnellsten Zeiten verknüpft mit der UUID des Spielers.
+* `names`: Speichert die Spielernamen für die Anzeige im Top-10-Leaderboard.