From b1f881abbbadc0b5157fb28d044dedfb68b0e38f Mon Sep 17 00:00:00 2001 From: M_Viper Date: Sat, 24 Jan 2026 21:16:41 +0000 Subject: [PATCH] Parkour aktualisiert --- Parkour.md | 66 +++++++++++++++++++++++++++++++++++------------------- 1 file changed, 43 insertions(+), 23 deletions(-) diff --git a/Parkour.md b/Parkour.md index d977750..5726362 100644 --- a/Parkour.md +++ b/Parkour.md @@ -4,37 +4,57 @@ Das Parkour-System von NexusLobby ist ein modulares, partikelbasiertes System, d ## 🛠 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. +- **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 +``` -* `/setstart` - * Markiert den NPC intern mit dem Tag `parkour_npc`. - * Speichert deine aktuelle Position als Startpunkt für den Timer. +- 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 +``` -* `/setcheckpoint` - * Das System nummeriert die Punkte automatisch (Checkpoint #1, #2, etc.). - * Spieler müssen diese Punkte in der exakten Reihenfolge passieren. +- 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 +``` -* `/setfinish` - * Setzt den Punkt, an dem der Timer stoppt und die Zeit gewertet wird. +- Setzt den Punkt, an dem der Timer stoppt und die Zeit gewertet wird. + +## 🏆 Leaderboard & Placeholder + +Um die Top 10 Bestzeiten in Hologrammen oder im Scoreboard anzuzeigen, nutzt das Plugin die PlaceholderAPI. + +| Placeholder | Beschreibung | +|-------------|--------------| +| `%nexus_parkour_top%` | Gibt die vollständige Liste der Top 10 Spieler inklusive Zeiten aus. | + +**Beispiel für ein Hologramm:** +``` +/holo create parkour_stats §6§lTOP 10 BESTZEITEN +/holo edit parkour_stats add %nexus_parkour_top% +``` ## 💻 Befehlsreferenz @@ -57,19 +77,19 @@ Gehe zum Endpunkt deines Parkours und nutze: ## 🔒 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. +- `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. +- **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`) +## 📊 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. \ No newline at end of file +- **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. \ No newline at end of file