Parkour aktualisiert
66
Parkour.md
66
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.
|
||||
- **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.
|
||||
Reference in New Issue
Block a user