PlaceholderAPI hinzugefügt

2026-01-22 14:39:59 +00:00
parent a2172e558f
commit 1f0bfef444
1 changed files with 179 additions and 0 deletions
--- a/PlaceholderAPI.md
+++ b/PlaceholderAPI.md
@@ -0,0 +1,179 @@
+# PlaceholderAPI
+
+NexusLobby bietet eigene Platzhalter und unterstutzt alle PlaceholderAPI-Erweiterungen.
+
+## NexusLobby Platzhalter
+
+| Platzhalter | Beschreibung | Beispiel |
+|-------------|-------------|----------|
+| `%nexuslobby_maintenance_status%` | Wartungsmodus-Status | `§aDeaktiviert` / `§cAktiv` |
+| `%nexuslobby_version%` | Plugin-Version | `1.0.0` |
+| `%nexuslobby_build_mode%` | Baumodus-Status | `§aAktiv` / `§cInaktiv` |
+
+---
+
+## Verwendung in Konfigurationen
+
+### Scoreboard (visuals.yml)
+
+```yaml
+scoreboard:
+  default:
+    lines:
+      - " &8>> &fSpieler: &e%player_name%"
+      - " &8>> &fRang: &7%luckperms_prefix%"
+      - " &8>> &fGeld: &e%vault_eco_balance_formatted%"
+      - " &8>> &fOnline: &a%server_online%"
+```
+
+### BossBar (visuals.yml)
+
+```yaml
+bossbar:
+  messages:
+    - "&e{online} &fSpieler online"
+    - "&fWillkommen &e%player_name%&f!"
+```
+
+---
+
+## Empfohlene Expansions
+
+### Installation
+
+```bash
+/papi ecloud download <expansion>
+/papi reload
+```
+
+### Basis-Expansions
+
+| Expansion | Befehl | Platzhalter |
+|-----------|--------|-------------|
+| Player | `/papi ecloud download Player` | `%player_name%`, `%player_health%` |
+| Server | `/papi ecloud download Server` | `%server_online%`, `%server_tps_1%` |
+
+### Wirtschaft
+
+| Expansion | Befehl | Platzhalter |
+|-----------|--------|-------------|
+| Vault | `/papi ecloud download Vault` | `%vault_eco_balance%`, `%vault_eco_balance_formatted%` |
+
+### Berechtigungen
+
+| Expansion | Befehl | Platzhalter |
+|-----------|--------|-------------|
+| LuckPerms | `/papi ecloud download LuckPerms` | `%luckperms_prefix%`, `%luckperms_suffix%` |
+
+### Netzwerk
+
+| Expansion | Befehl | Platzhalter |
+|-----------|--------|-------------|
+| Bungee | `/papi ecloud download Bungee` | `%bungee_total%`, `%bungee_<server>%` |
+
+---
+
+## Haufig verwendete Platzhalter
+
+### Spieler
+
+| Platzhalter | Beschreibung |
+|-------------|-------------|
+| `%player_name%` | Spielername |
+| `%player_displayname%` | Anzeigename |
+| `%player_uuid%` | UUID |
+| `%player_ping%` | Ping in ms |
+| `%player_health%` | Gesundheit |
+| `%player_food_level%` | Hunger |
+| `%player_gamemode%` | Spielmodus |
+| `%player_world%` | Aktuelle Welt |
+| `%player_x%` | X-Koordinate |
+| `%player_y%` | Y-Koordinate |
+| `%player_z%` | Z-Koordinate |
+
+### Server
+
+| Platzhalter | Beschreibung |
+|-------------|-------------|
+| `%server_online%` | Online-Spieler |
+| `%server_max_players%` | Max. Spieler |
+| `%server_tps_1%` | TPS (1 Min.) |
+| `%server_tps_5%` | TPS (5 Min.) |
+| `%server_tps_15%` | TPS (15 Min.) |
+| `%server_ram_used%` | RAM verwendet (MB) |
+| `%server_ram_max%` | RAM max. (MB) |
+| `%server_ram_free%` | RAM frei (MB) |
+| `%server_total_entities%` | Entities |
+| `%server_total_chunks%` | Geladene Chunks |
+| `%server_time_HH:mm:ss%` | Serverzeit |
+
+### LuckPerms
+
+| Platzhalter | Beschreibung |
+|-------------|-------------|
+| `%luckperms_prefix%` | Prefix |
+| `%luckperms_suffix%` | Suffix |
+| `%luckperms_primary_group_name%` | Hauptgruppe |
+| `%luckperms_groups%` | Alle Gruppen |
+| `%luckperms_has_permission_<perm>%` | Hat Permission |
+
+### Vault
+
+| Platzhalter | Beschreibung |
+|-------------|-------------|
+| `%vault_eco_balance%` | Kontostand (Zahl) |
+| `%vault_eco_balance_formatted%` | Kontostand (formatiert) |
+| `%vault_eco_balance_fixed%` | Kontostand (2 Dezimalen) |
+
+### BungeeCord
+
+| Platzhalter | Beschreibung |
+|-------------|-------------|
+| `%bungee_total%` | Spieler gesamt |
+| `%bungee_<server>%` | Spieler auf Server |
+
+---
+
+## Beispiel-Konfiguration
+
+### Vollstandiges Scoreboard
+
+```yaml
+scoreboard:
+  default:
+    title: "&6&lNEXUSLOBBY"
+    lines:
+      - "&1 "
+      - "&6&lPROFIL"
+      - " &8>> &f%player_name%"
+      - " &8>> &7%luckperms_prefix%"
+      - "&2 "
+      - "&6&lSTATISTIK"
+      - " &8>> &fPing: &a%player_ping%ms"
+      - " &8>> &fGeld: &e%vault_eco_balance_formatted%"
+      - "&3 "
+      - "&6&lSERVER"
+      - " &8>> &fOnline: &e%server_online%&8/&7%server_max_players%"
+      - " &8>> &fTPS: &a%server_tps_1%"
+      - "&4 "
+      - "&8nexuslobby.de"
+```
+
+### Admin-Scoreboard
+
+```yaml
+scoreboard:
+  owner:
+    title: "&c&lADMIN"
+    lines:
+      - "&1 "
+      - "&c&lPERFORMANCE"
+      - " &8>> &fTPS: &a%server_tps_1%"
+      - " &8>> &fRAM: &e%server_ram_used%&8/&7%server_ram_max%MB"
+      - "&2 "
+      - "&c&lWARTUNG"
+      - " &8>> &fStatus: %nexuslobby_maintenance_status%"
+      - " &8>> &fBuild: %nexuslobby_build_mode%"
+      - "&3 "
+      - " &8>> &fVersion: &7%nexuslobby_version%"
+```