🪧Placeholder

Das Perks Plugin unterstützt vollständig PlaceholderAPI und bietet eine Vielzahl von Platzhaltern, um Perk-Status und Timer in anderen Plugins wie Scoreboards, Tab-Listen, Holograms und mehr anzuzeigen.

---

Installation

1

1. PlaceholderAPI installieren

1. Lade PlaceholderAPI herunter

2. Platziere die .jar Datei im plugins Ordner

3. Starte den Server neu

2

2. Perks Plugin installieren

Das Perks Plugin erkennt PlaceholderAPI automatisch und registriert alle Placeholders.

Überprüfung:

/papi info perks

Output:

Perks Expansion
Author: Dyroxplays
Version: 1.0

---

Verfügbare Placeholders

Format

Alle Placeholders beginnen mit %perks_ und enden mit %:

%perks_<typ>_<identifier>%

---

Status-Placeholders

Status-Placeholders zeigen an, ob ein Perk aktiviert, deaktiviert oder gesperrt ist.

Format

%perks_status_<PERK_NAME>%

Beispiele

%perks_status_NO_FALL_DAMAGE%
%perks_status_FLY%
%perks_status_KEEP_INV%
%perks_status_DOUBLE_XP%
%perks_status_GARDENER_1%

Ausgaben

Die Ausgabe ist in der config.yml konfigurierbar:

replacementplaceholders:
  status:
    enabled: '&aAktiviert'      # Perk ist aktiv
    disabled: '&7Deaktiviert'   # Perk ist inaktiv
    blocked: '&cNicht freigeschalten'  # Keine Permission oder Welt gesperrt

Beispiel-Ausgabe:

• Perk aktiv: &aAktiviert → ✓ Aktiviert

• Perk inaktiv: &7Deaktiviert → ✗ Deaktiviert

• Perk gesperrt: &cNicht freigeschalten → 🔒 Nicht freigeschalten

---

Timer-Placeholders

Timer-Placeholders zeigen die verbleibende Zeit für Cooldowns an.

Format

%perks_timer_<TIMER_NAME>%

Verfügbare Timer

Gärtner-Cooldown

%perks_timer_GARDENER%

Zeigt die verbleibende Cooldown-Zeit des Gärtner-Perks an.

Beispiel-Ausgabe:

• Während Cooldown: 0:14 (14 Sekunden verbleibend)

• Kein Cooldown: `` (leer)

Fly-Timer

%perks_timer_FLY%

Zeigt die verbleibende Zeit des Fly-Modus an (z.B. bei Plot-based Fly).

Beispiel-Ausgabe:

• Während Fly aktiv: 2:30 (2 Minuten 30 Sekunden verbleibend)

• Kein Timer: `` (leer)

Konfiguration

Die Anzeige der Timer ist konfigurierbar:

replacementplaceholders:
  timer_GARDENER:
    current: '%min%:%sec%'  # Format während Cooldown läuft
    empty: ''               # Anzeige wenn kein Cooldown
  timer_FLY:
    current: '%min%:%sec%'  # Format während Timer läuft
    empty: ''               # Anzeige wenn kein Timer

Custom Format-Beispiele:

# Mit Icons und Farben
timer_GARDENER:
  current: '⏱ &c%min%m %sec%s'
  empty: '&a✓ Bereit'

# Nur Sekunden
timer_FLY:
  current: '&e%sec%s'
  empty: '∞'

# Ausführlich
timer_GARDENER:
  current: '&7Cooldown: &c%min%:%sec%'
  empty: '&aKein Cooldown'

Verfügbare Variablen:

• %min% - Minuten (ohne führende Null)

• %sec% - Sekunden (mit führender Null, z.B. 05)

---

Konfigurierbare Ausgaben

Alle Placeholder-Ausgaben können vollständig angepasst werden:

config.yml

replacementplaceholders:
  timer_GARDENER:
    current: '%min%:%sec%'
    empty: ''
  timer_FLY:
    current: '%min%:%sec%'
    empty: ''
  status:
    enabled: '&aAktiviert'
    disabled: '&7Deaktiviert'
    blocked: '&cNicht freigeschalten'

Custom Beispiele

Minimalistisch

status:
  enabled: '&a✓'
  disabled: '&7✗'
  blocked: '&c🔒'

Mit Emojis

status:
  enabled: '✅ &aAn'
  disabled: '⭕ &7Aus'
  blocked: '🔒 &cGesperrt'

Detailliert

status:
  enabled: '&a[&l✓&a] Aktiviert'
  disabled: '&7[&l✗&7] Deaktiviert'
  blocked: '&c[&l!&c] Keine Berechtigung'

---

Alle verfügbaren Perk-Placeholders

Basis-Perks

%perks_status_NO_FALL_DAMAGE%
%perks_status_NO_HUNGER%
%perks_status_FLY%
%perks_status_KEEP_INV%
%perks_status_KEEP_HOTBAR%
%perks_status_KEEP_XP%
%perks_status_DOUBLE_XP%
%perks_status_QUAD_XP%
%perks_status_DROP_TO_INV%
%perks_status_EXTRA_HEARTS_5%
%perks_status_EXTRA_HEARTS_10%
%perks_status_GARDENER_1%
%perks_status_GARDENER_2%

Potion-Effect Perks

Für Potion-Effekte verwendest du den Config-Key (mit Unterstrichen statt Semikolons):

Config:

POTION_EFFECT_SPEED_-1_1:
  perkType: POTION_EFFECT;SPEED;-1;1

Placeholder:

%perks_status_POTION_EFFECT_SPEED_-1_1%

Weitere Beispiele:

%perks_status_POTION_EFFECT_REGENERATION_-1_1%
%perks_status_POTION_EFFECT_JUMP_-1_2%
%perks_status_POTION_EFFECT_INCREASE_DAMAGE_-1_1%
%perks_status_POTION_EFFECT_NIGHT_VISION_-1_0%

Mob-Schutz Perks

%perks_status_NO_CREEPER_DAMAGE%
%perks_status_NO_ZOMBIE_DAMAGE%
%perks_status_NO_SKELETON_DAMAGE%
%perks_status_NO_SPIDER_DAMAGE%
%perks_status_NO_ENDERMAN_DAMAGE%
%perks_status_NO_BLAZE_DAMAGE%
%perks_status_NO_GHAST_DAMAGE%
%perks_status_NO_SLIME_DAMAGE%
%perks_status_NO_GUARDIAN_DAMAGE%
%perks_status_NO_ZOMBIFIED_PIGLIN_DAMAGE%

Timer Placeholders

%perks_timer_GARDENER%
%perks_timer_FLY%

---

Tipps & Best Practices

1

1. Testen von Placeholders

Verwende den PAPI-Parse Befehl zum Testen:

/papi parse <spieler> %perks_status_FLY%

2

2. Performance

Alle Placeholders sind optimiert und cachen Daten. Du kannst sie bedenkenlos in Scoreboards verwenden, die jede Sekunde aktualisieren.

3

3. Farben

Vergiss nicht, dass die Farben in der Config konfiguriert werden:

replacementplaceholders:
  status:
    enabled: '&a✓'  # ← Hier ändern!

4

4. Debugging

Bei Problemen:

1. Check ob PlaceholderAPI installiert ist:

   /papi info perks

2. Teste Placeholder direkt:

   /papi parse <spieler> %perks_status_FLY%

3. Check Plugin-Log:

   [Perks] PlaceholderAPI integration enabled

---

Weitere Informationen:

• Beschreibung.md - Plugin-Übersicht

• Konfiguration.md - Detaillierte Config-Anleitung

• PerkTypes.md - Alle verfügbaren Perk-Typen

Externe Links:

• ScoreboardPlus kaufen

• PlaceholderAPI Wiki