# Konfiguration

Diese Seite erklärt die vollständige Konfiguration des Perks Plugins und zeigt, wie du eigene Perks erstellen kannst.

{% hint style="info" %}
**Tipp:** Nach Änderungen an der Config kannst du `/perks reload` verwenden, um die Änderungen ohne Server-Neustart zu laden.
{% endhint %}

## Grundkonfiguration

{% code title="config.yml example" expandable="true" %}

```yml
# ##// Plugin Coded by Dyroxplays. \##

prefix: '&7[&6Perks&7]'
GARDENER_COOLDOWN_MS: 15000
replacementplaceholders:
  timer_GARDENER:
    current: '%min%:%sec%'
    empty: ''
  timer_FLY:
    current: '%min%:%sec%'
    empty: ''
  status:
    enabled: '&aAktiviert'
    disabled: '&7Deaktiviert'
    blocked: '&cNicht freigeschalten'
gui:
  name: '                &6&lPerks'
  lenght: 6
placeholder:
  enable: true
  BLACK_STAINED_GLASS_PANE: 0-53
fly:
  sec: 5
  message: '&cDu kannst nur noch &e%sec% Sekunden &cfliegen'
  blockedworld:
  - world
instantsmel:
- SAND-GLASS
- COBBLESTONE-STONE
messages:
  noperm: '&cDazu hast du keine Rechte'
MySQL:
  host: 172.18.0.1
  port: '3306'
  username: xx
  datebase: xx
  password: xxxx
items:
  prevPage:
    material: PLAYER_HEAD
    skullowner: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZjdhYWNhZDE5M2UyMjI2OTcxZWQ5NTMwMmRiYTQzMzQzOGJlNDY0NGZiYWI1ZWJmODE4MDU0MDYxNjY3ZmJlMiJ9fX0=
    name: '&7«'
    slot: 52
  nextPage:
    material: PLAYER_HEAD
    skullowner: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMTliZjMyOTJlMTI2YTEwNWI1NGViYTcxM2FhMWIxNTJkNTQxYTFkODkzODgyOWM1NjM2NGQxNzhlZDIyYmYifX19
    name: '&7»'
    slot: 53
  enabled:
    material: LIME_DYE
    name: '&aAktiviert'
  disabled:
    material: GRAY_DYE
    name: '&7Deaktiviert'
  blocked:
    material: RED_DYE
    name: '&cNicht freigeschalten'
    lore:
    - '&cFür diesen Perk hast du aktuell keine Rechte'
perks:
  '1':
    NO_FALL_DAMAGE:
      enable: true
      perkType: NO_FALL_DAMAGE
      permission: perks.no_fall_damage
      material: NETHERITE_BOOTS
      amount: 1
      name: '&6Kein Fallschaden'
      lore:
      - '&8&m----------'
      - '&7Du erhältst keinen Fallschaden mehr.'
      slot: 10
      infoslot: 11
      blockedworld:
      - world_nether
    NO_HUNGER:
      enable: true
      perkType: NO_HUNGER
      permission: perks.no_hunger
      material: COOKED_BEEF
      amount: 1
      name: '&6Kein Hunger'
      lore:
      - '&8&m----------'
      - '&7Deine Hunger-Anzeige sinkt nicht mehr.'
      slot: 19
      infoslot: 20
      blockedworld:
      - world_nether
    FLY:
      enable: true
      perkType: FLY
      permission: perks.fly
      material: FEATHER
      amount: 1
      name: '&6Fly'
      lore:
      - '&8&m----------'
      - '&7Flug-Modus auf dem eigenen Plot'
      slot: 28
      infoslot: 29
      blockedworld:
      - world_nether
    POTION_EFFECT_REGENERATION_-1_1:
      enable: true
      perkType: POTION_EFFECT;REGENERATION;-1;1
      permission: perks.potion_effect_regeneration_-1_1
      material: GOLDEN_APPLE
      amount: 1
      name: '&dRegeneration+'
      lore:
      - '&8&m----------'
      - '&7Regeneration 2 Effekt.'
      slot: 37
      infoslot: 38
      blockedworld:
      - world_nether
    POTION_EFFECT_REGENERATION_-1_3:
      enable: true
      perkType: POTION_EFFECT;REGENERATION;-1;3
      permission: perks.potion_effect_regeneration_-1_3
      material: ENCHANTED_GOLDEN_APPLE
      amount: 1
      name: '&dRegeneration+2'
      lore:
      - '&8&m----------'
      - '&7Regeneration 4 Effekt.'
      slot: 14
      infoslot: 15
      blockedworld:
      - world_nether
    POTION_EFFECT_SPEED_-1_0:
      enable: true
      perkType: POTION_EFFECT;SPEED;-1;0
      permission: perks.potion_effect_speed_-1_0
      material: SUGAR
      amount: 1
      name: '&bSchnelligkeit+'
      lore:
      - '&8&m----------'
      - '&7+20% Geschwindigkeit.'
      slot: 23
      infoslot: 24
      blockedworld:
      - world_nether
    POTION_EFFECT_SPEED_-1_1:
      enable: true
      perkType: POTION_EFFECT;SPEED;-1;1
      permission: perks.potion_effect_speed_-1_1
      material: FEATHER
      amount: 1
      name: '&bSchnelligkeit+2'
      lore:
      - '&8&m----------'
      - '&7Verbesserte Geschwindigkeit.'
      slot: 32
      infoslot: 33
      blockedworld:
      - world_nether
    POTION_EFFECT_FAST_DIGGING_-1_1:
      enable: true
      perkType: POTION_EFFECT;FAST_DIGGING;-1;1
      permission: perks.potion_effect_fast_digging_-1_1
      material: GOLDEN_PICKAXE
      amount: 1
      name: '&eEile+'
      lore:
      - '&8&m----------'
      - '&7Eile 2 Effekt.'
      slot: 41
      infoslot: 42
      blockedworld:
      - world_nether
  '2':
    POTION_EFFECT_FAST_DIGGING_-1_3:
      enable: true
      perkType: POTION_EFFECT;FAST_DIGGING;-1;3
      permission: perks.potion_effect_fast_digging_-1_3
      material: NETHERITE_PICKAXE
      amount: 1
      name: '&eEile+2'
      lore:
      - '&8&m----------'
      - '&7Eile 4 Effekt.'
      slot: 10
      infoslot: 11
      blockedworld:
      - world_nether
    POTION_EFFECT_DAMAGE_RESISTANCE_-1_1:
      enable: true
      perkType: POTION_EFFECT;DAMAGE_RESISTANCE;-1;1
      permission: perks.potion_effect_damage_resistance_-1_1
      material: IRON_CHESTPLATE
      amount: 1
      name: '&9Resistenz+'
      lore:
      - '&8&m----------'
      - '&7Resistenz 2 Effekt.'
      slot: 19
      infoslot: 20
      blockedworld:
      - world_nether
    POTION_EFFECT_DAMAGE_RESISTANCE_-1_3:
      enable: true
      perkType: POTION_EFFECT;DAMAGE_RESISTANCE;-1;3
      permission: perks.potion_effect_damage_resistance_-1_3
      material: NETHERITE_CHESTPLATE
      amount: 1
      name: '&9Resistenz+2'
      lore:
      - '&8&m----------'
      - '&7Resistenz 4 Effekt.'
      slot: 28
      infoslot: 29
      blockedworld:
      - world_nether
    POTION_EFFECT_INCREASE_DAMAGE_-1_0:
      enable: true
      perkType: POTION_EFFECT;INCREASE_DAMAGE;-1;0
      permission: perks.potion_effect_increase_damage_-1_0
      material: IRON_SWORD
      amount: 1
      name: '&cStärke+'
      lore:
      - '&8&m----------'
      - '&7Erhöhter Angriffsschaden.'
      slot: 37
      infoslot: 38
      blockedworld:
      - world_nether
    POTION_EFFECT_INCREASE_DAMAGE_-1_1:
      enable: true
      perkType: POTION_EFFECT;INCREASE_DAMAGE;-1;1
      permission: perks.potion_effect_increase_damage_-1_1
      material: NETHERITE_SWORD
      amount: 1
      name: '&cStärke+2'
      lore:
      - '&8&m----------'
      - '&7Massiver Angriffsschaden.'
      slot: 14
      infoslot: 15
      blockedworld:
      - world_nether
    POTION_EFFECT_FIRE_RESISTANCE_-1_0:
      enable: true
      perkType: POTION_EFFECT;FIRE_RESISTANCE;-1;0
      permission: perks.potion_effect_fire_resistance_-1_0
      material: LAVA_BUCKET
      amount: 1
      name: '&6Feuerresistenz+'
      lore:
      - '&8&m----------'
      - '&7Du erhältst keinen Feuerschaden.'
      slot: 23
      infoslot: 24
      blockedworld:
      - world_nether
    POTION_EFFECT_WATER_BREATHING_-1_0:
      enable: true
      perkType: POTION_EFFECT;WATER_BREATHING;-1;0
      permission: perks.potion_effect_water_breathing_-1_0
      material: WATER_BUCKET
      amount: 1
      name: '&3Unterwasseratmung+'
      lore:
      - '&8&m----------'
      - '&7Du hast unbegrenzt Luft.'
      slot: 32
      infoslot: 33
      blockedworld:
      - world_nether
    POTION_EFFECT_NIGHT_VISION_-1_0:
      enable: true
      perkType: POTION_EFFECT;NIGHT_VISION;-1;0
      permission: perks.potion_effect_night_vision_-1_0
      material: ENDER_EYE
      amount: 1
      name: '&fNachtsicht+'
      lore:
      - '&8&m----------'
      - '&7Nachtsicht-Effekt.'
      slot: 41
      infoslot: 42
      blockedworld:
      - world_nether
  '3':
    POTION_EFFECT_INVISIBILITY_-1_0:
      enable: true
      perkType: POTION_EFFECT;INVISIBILITY;-1;0
      permission: perks.potion_effect_invisibility_-1_0
      material: POTION
      amount: 1
      name: '&7Unsichtbarkeit+'
      lore:
      - '&8&m----------'
      - '&7Unsichtbarkeit-Effekt.'
      slot: 10
      infoslot: 11
      blockedworld:
      - world_nether
    DOUBLE_XP:
      enable: true
      perkType: DOUBLE_XP
      permission: perks.double_xp
      material: EXPERIENCE_BOTTLE
      amount: 2
      name: '&aDoppelte XP'
      lore:
      - '&8&m----------'
      - '&7Doppelte Menge an XP.'
      slot: 19
      infoslot: 20
      blockedworld:
      - world_nether
    QUAD_XP:
      enable: true
      perkType: QUAD_XP
      permission: perks.quad_xp
      material: EXPERIENCE_BOTTLE
      amount: 4
      name: '&aVierfach XP'
      lore:
      - '&8&m----------'
      - '&7Vierfache Menge an XP.'
      slot: 28
      infoslot: 29
      blockedworld:
      - world_nether
    KEEP_HOTBAR:
      enable: true
      perkType: KEEP_HOTBAR
      permission: perks.keep_hotbar
      material: CHEST
      amount: 1
      name: '&6KeepHotbar'
      lore:
      - '&8&m----------'
      - '&7Hotbar ist beim Tod sicher.'
      slot: 37
      infoslot: 38
      blockedworld:
      - world_nether
    KEEP_INV:
      enable: true
      perkType: KEEP_INV
      permission: perks.keep_inv
      material: ENDER_CHEST
      amount: 1
      name: '&6KeepInventory'
      lore:
      - '&8&m----------'
      - '&7Inventar ist beim Tod sicher.'
      slot: 14
      infoslot: 15
      blockedworld:
      - world_nether
    KEEP_XP:
      enable: true
      perkType: KEEP_XP
      permission: perks.keep_xp
      material: EXPERIENCE_BOTTLE
      amount: 1
      name: '&6KeepXP'
      lore:
      - '&8&m----------'
      - '&7XP sind beim Tod sicher.'
      slot: 23
      infoslot: 24
      blockedworld:
      - world_nether
    DROP_TO_INV:
      enable: true
      perkType: DROP_TO_INV
      permission: perks.drop_to_inv
      material: HOPPER
      amount: 1
      name: '&6DropToInv'
      lore:
      - '&8&m----------'
      - '&7Abgebaute Blöcke landen'
      - '&7direkt in deinem Inventar.'
      slot: 32
      infoslot: 33
      blockedworld:
      - world_nether
    EXTRA_HEARTS_5:
      enable: true
      perkType: EXTRA_HEARTS_5
      permission: perks.extra_hearts_5
      material: REDSTONE
      amount: 5
      name: '&c5 Extra-Herzen'
      lore:
      - '&8&m----------'
      - '&7Du erhältst 5 zusätzliche Herzen.'
      slot: 41
      infoslot: 42
      blockedworld:
      - world_nether
  '4':
    EXTRA_HEARTS_10:
      enable: true
      perkType: EXTRA_HEARTS_10
      permission: perks.extra_hearts_10
      material: NETHER_STAR
      amount: 10
      name: '&c10 Extra-Herzen'
      lore:
      - '&8&m----------'
      - '&7Du erhältst 10 zusätzliche Herzen.'
      slot: 10
      infoslot: 11
      blockedworld:
      - world_nether
    NO_CREEPER_DAMAGE:
      enable: true
      perkType: NO_CREEPER_DAMAGE
      permission: perks.no_creeper_damage
      material: CREEPER_SPAWN_EGG
      amount: 1
      name: '&6Kein Creeper-Schaden'
      lore:
      - '&8&m----------'
      - Creeper fügen dir keinen Schaden zu.
      slot: 19
      infoslot: 20
      blockedworld:
      - world_nether
    NO_BLAZE_DAMAGE:
      enable: true
      perkType: NO_BLAZE_DAMAGE
      permission: perks.no_blaze_damage
      material: BLAZE_SPAWN_EGG
      amount: 1
      name: '&6Kein Lohen-Schaden'
      lore:
      - '&8&m----------'
      - Lohen fügen dir keinen Schaden zu.
      slot: 28
      infoslot: 29
      blockedworld:
      - world_nether
    NO_ENDERMAN_DAMAGE:
      enable: true
      perkType: NO_ENDERMAN_DAMAGE
      permission: perks.no_enderman_damage
      material: ENDERMAN_SPAWN_EGG
      amount: 1
      name: '&6Kein Enderman-Schaden'
      lore:
      - '&8&m----------'
      - Enderman fügen dir keinen Schaden zu.
      slot: 37
      infoslot: 38
      blockedworld:
      - world_nether
    NO_SPIDER_DAMAGE:
      enable: true
      perkType: NO_SPIDER_DAMAGE
      permission: perks.no_spider_damage
      material: SPIDER_SPAWN_EGG
      amount: 1
      name: '&6Kein Spinnen-Schaden'
      lore:
      - '&8&m----------'
      - Spinnen fügen dir keinen Schaden zu.
      slot: 14
      infoslot: 15
      blockedworld:
      - world_nether
    NO_ZOMBIE_DAMAGE:
      enable: true
      perkType: NO_ZOMBIE_DAMAGE
      permission: perks.no_zombie_damage
      material: ZOMBIE_SPAWN_EGG
      amount: 1
      name: '&6Kein Zombie-Schaden'
      lore:
      - '&8&m----------'
      - Zombie fügen dir keinen Schaden zu.
      slot: 23
      infoslot: 24
      blockedworld:
      - world_nether
    NO_GHAST_DAMAGE:
      enable: true
      perkType: NO_GHAST_DAMAGE
      permission: perks.no_ghast_damage
      material: GHAST_SPAWN_EGG
      amount: 1
      name: '&6Kein Ghast-Schaden'
      lore:
      - '&8&m----------'
      - Ghast fügen dir keinen Schaden zu.
      slot: 32
      infoslot: 33
      blockedworld:
      - world_nether
    NO_SKELETON_DAMAGE:
      enable: true
      perkType: NO_SKELETON_DAMAGE
      permission: perks.no_skeleton_damage
      material: SKELETON_SPAWN_EGG
      amount: 1
      name: '&6Kein Skelett-Schaden'
      lore:
      - '&8&m----------'
      - Skelett fügen dir keinen Schaden zu.
      slot: 41
      infoslot: 42
      blockedworld:
      - world_nether
  '5':
    NO_SLIME_DAMAGE:
      enable: true
      perkType: NO_SLIME_DAMAGE
      permission: perks.no_slime_damage
      material: SLIME_SPAWN_EGG
      amount: 1
      name: '&6Kein Schleim-Schaden'
      lore:
      - '&8&m----------'
      - Schleim fügen dir keinen Schaden zu.
      slot: 10
      infoslot: 11
      blockedworld:
      - world_nether
    NO_GUARDIAN_DAMAGE:
      enable: true
      perkType: NO_GUARDIAN_DAMAGE
      permission: perks.no_guardian_damage
      material: GUARDIAN_SPAWN_EGG
      amount: 1
      name: '&6Kein Wächter-Schaden'
      lore:
      - '&8&m----------'
      - Wächter fügen dir keinen Schaden zu.
      slot: 19
      infoslot: 20
      blockedworld:
      - world_nether
    NO_ZOMBIFIED_PIGLIN_DAMAGE:
      enable: true
      perkType: NO_ZOMBIFIED_PIGLIN_DAMAGE
      permission: perks.no_zombified_piglin_damage
      material: ZOMBIFIED_PIGLIN_SPAWN_EGG
      amount: 1
      name: '&6Kein Pigman-Schaden'
      lore:
      - '&8&m----------'
      - Pigman fügen dir keinen Schaden zu.
      slot: 28
      infoslot: 29
      blockedworld:
      - world_nether
    GARDENER_1:
      enable: true
      perkType: GARDENER_1
      permission: perks.gardener_1
      material: WHEAT_SEEDS
      amount: 1
      name: '&2Gärtner'
      lore:
      - '&8&m----------'
      - '&7Pflanzen wachsen schneller (Sneaken).'
      slot: 37
      infoslot: 38
      blockedworld:
      - world_nether
    GARDENER_2:
      enable: true
      perkType: GARDENER_2
      permission: perks.gardener_2
      material: PUMPKIN_SEEDS
      amount: 1
      name: '&2Gärtner+'
      lore:
      - '&8&m----------'
      - '&73x3 Pflanzen wachsen schneller (Sneaken).'
      slot: 14
      infoslot: 15
      blockedworld:
      - world_nether

```

{% endcode %}

### Prefix

{% tabs %}
{% tab title="Standard" %}

```yaml
prefix: '&7[&6Perks&7]'
```

Der Prefix wird vor allen Plugin-Nachrichten angezeigt.
{% endtab %}

{% tab title="Mit HEX-Farben (1.16+)" %}

```yaml
prefix: '&#FF5500[&#FFD700Perks&#FF5500]'
```

{% hint style="success" %}
HEX-Farben werden automatisch in Minecraft 1.16+ unterstützt!
{% endhint %}
{% endtab %}

{% tab title="Mit Gradient" %}

```yaml
prefix: '&#FF0000[&#FF5500P&#FFAA00e&#FFD700r&#FFAA00k&#FF5500s&#FF0000]'
```

Erstelle beeindruckende Farbverläufe!
{% endtab %}
{% endtabs %}

### Cooldowns

```yaml
GARDENER_COOLDOWN_MS: 15000  # 15 Sekunden in Millisekunden
```

{% hint style="warning" %}
**Hinweis:** Die Zeit wird in **Millisekunden** angegeben.

15000 ms = 15 Sekunden
{% endhint %}

### Fly-Einstellungen

```yaml
fly:
  sec: 5  # Warnzeit in Sekunden bevor der Fly-Modus endet
  message: '&cDu kannst nur noch &e%sec% Sekunden &cfliegen'
  blockedworld:
    - world  # Welten, in denen Fly nicht funktioniert
```

### Instant Smelt

```yaml
instantsmel:
  - SAND-GLASS        # Sand wird zu Glas
  - COBBLESTONE-STONE # Cobblestone wird zu Stone
```

{% hint style="info" %}
**Format:** `URSPRUNG-ERGEBNIS`
{% endhint %}

<details>

<summary>📦 Weitere Instant Smelt Beispiele</summary>

```yaml
instantsmel:
  - SAND-GLASS
  - RED_SAND-GLASS
  - COBBLESTONE-STONE
  - IRON_ORE-IRON_INGOT
  - GOLD_ORE-GOLD_INGOT
  - COPPER_ORE-COPPER_INGOT
  - ANCIENT_DEBRIS-NETHERITE_SCRAP
  - WET_SPONGE-SPONGE
  - CLAY-TERRACOTTA
  - NETHERRACK-NETHER_BRICK
```

</details>

### Nachrichten

```yaml
messages:
  noperm: '&cDazu hast du keine Rechte'
```

***

## MySQL-Einstellungen

{% tabs %}
{% tab title="Lokaler Server" %}

```yaml
MySQL:
  host: localhost
  port: '3306'
  username: minecraft
  datebase: perks
  password: 'deinPasswort123'
```

{% endtab %}

{% tab title="Externer Server" %}

```yaml
MySQL:
  host: 172.18.0.1      # MySQL Server IP
  port: '3306'           # MySQL Port
  username: username     # MySQL Benutzername
  datebase: database     # Datenbank-Name
  password: password     # MySQL Passwort
```

{% endtab %}

{% tab title="Mit Custom Port" %}

```yaml
MySQL:
  host: db.example.com
  port: '3307'           # Custom Port
  username: perks_user
  datebase: minecraft_perks
  password: 'sicheres_passwort!'
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
**Wichtig:** Die Datenbank muss bereits existieren! Das Plugin erstellt nur automatisch die benötigten Tabellen.
{% endhint %}

{% hint style="success" %}
**Tipp:** Nutze ein starkes Passwort für die MySQL-Verbindung!
{% endhint %}

***

## GUI-Konfiguration

### Allgemeine GUI-Einstellungen

```yaml
gui:
  name: '                &6&lPerks'  # Name des Inventars
  lenght: 6                           # Größe in Zeilen (1-6)
```

### Placeholder-Items

Placeholder-Items werden als Hintergrund verwendet:

```yaml
placeholder:
  enable: true                         # Aktiviert/Deaktiviert Placeholder
  BLACK_STAINED_GLASS_PANE: 0-53      # Material und Slots (alle Slots)
```

**Weitere Beispiele:**

```yaml
placeholder:
  enable: true
  GRAY_STAINED_GLASS_PANE: 0-8,45-53  # Nur obere und untere Reihe
  BLACK_STAINED_GLASS_PANE: 9,17,18,26,27,35,36,44  # Nur Rand-Slots
```

### Navigation-Items

```yaml
items:
  prevPage:
    material: PLAYER_HEAD
    skullowner: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZjdhYWNhZDE5M2UyMjI2OTcxZWQ5NTMwMmRiYTQzMzQzOGJlNDY0NGZiYWI1ZWJmODE4MDU0MDYxNjY3ZmJlMiJ9fX0=
    name: '&7«'
    slot: 52
  nextPage:
    material: PLAYER_HEAD
    skullowner: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMTliZjMyOTJlMTI2YTEwNWI1NGViYTcxM2FhMWIxNTJkNTQxYTFkODkzODgyOWM1NjM2NGQxNzhlZDIyYmYifX19
    name: '&7»'
    slot: 53
```

### Status-Indicator Items

Diese Items erscheinen neben dem Perk-Item (im `infoslot`):

```yaml
items:
  enabled:
    material: LIME_DYE
    name: '&aAktiviert'
  disabled:
    material: GRAY_DYE
    name: '&7Deaktiviert'
  blocked:
    material: RED_DYE
    name: '&cNicht freigeschalten'
    lore:
      - '&cFür diesen Perk hast du aktuell keine Rechte'
```

***

## Perks erstellen

### Grundlegende Struktur

{% hint style="success" %}
**Schnellstart:** Kopiere die Vorlage unten und passe sie an deine Bedürfnisse an!
{% endhint %}

```yaml
perks:
  '1':  # Seite 1
    PERK_NAME:
      enable: true                          # Aktiviert/Deaktiviert den Perk
      perkType: PERK_TYPE                   # Der Perk-Typ (siehe PerkTypes.md)
      permission: perks.perk_name           # Erforderliche Permission (leer = keine)
      material: MATERIAL_NAME               # Item-Material
      shortid: 0                            # (Optional) Data-Value für Minecraft < 1.13
      amount: 1                             # Item-Anzahl (Stapelgröße)
      name: '&6Name des Perks'             # Anzeigename
      lore:                                 # Beschreibung (mehrere Zeilen möglich)
        - '&8&m----------'
        - '&7Beschreibung des Perks'
      slot: 10                              # Slot des Perk-Items
      infoslot: 11                          # Slot des Status-Indicators
      blockedworld:                         # Welten, in denen der Perk nicht funktioniert
        - world_nether
        - world_the_end
```

<table><thead><tr><th width="180">Parameter</th><th width="120">Erforderlich</th><th>Beschreibung</th></tr></thead><tbody><tr><td><code>enable</code></td><td>✅ Ja</td><td>Aktiviert/Deaktiviert den Perk</td></tr><tr><td><code>perkType</code></td><td>✅ Ja</td><td>Der Typ des Perks (siehe <a href="broken-reference">PerkTypes.md</a>)</td></tr><tr><td><code>permission</code></td><td>❌ Nein</td><td>Erforderliche Permission (leer = für alle)</td></tr><tr><td><code>material</code></td><td>✅ Ja</td><td>Das Item-Material aus Minecraft</td></tr><tr><td><code>shortid</code></td><td>❌ Nein</td><td>Data-Value für Minecraft &#x3C; 1.13</td></tr><tr><td><code>amount</code></td><td>❌ Nein</td><td>Stackgröße des Items (Standard: 1)</td></tr><tr><td><code>name</code></td><td>✅ Ja</td><td>Anzeigename des Perks</td></tr><tr><td><code>lore</code></td><td>❌ Nein</td><td>Beschreibungstext (mehrere Zeilen)</td></tr><tr><td><code>slot</code></td><td>✅ Ja</td><td>Slot-Position des Perk-Items (0-53)</td></tr><tr><td><code>infoslot</code></td><td>✅ Ja</td><td>Slot für Status-Indicator</td></tr><tr><td><code>blockedworld</code></td><td>❌ Nein</td><td>Liste von Welten wo Perk nicht funktioniert</td></tr></tbody></table>

### Beispiele

{% tabs %}
{% tab title="No Fall Damage" %}
**Einfacher Schutz-Perk**

```yaml
perks:
  '1':
    NO_FALL_DAMAGE:
      enable: true
      perkType: NO_FALL_DAMAGE
      permission: perks.no_fall_damage
      material: NETHERITE_BOOTS
      amount: 1
      name: '&6Kein Fallschaden'
      lore:
        - '&8&m----------'
        - '&7Du erhältst keinen Fallschaden mehr.'
      slot: 10
      infoslot: 11
      blockedworld:
        - world_nether
```

{% endtab %}

{% tab title="Potion Effect" %}
**Dauerhafter Trank-Effekt (Speed II)**

```yaml
perks:
  '1':
    POTION_EFFECT_SPEED_-1_1:
      enable: true
      perkType: POTION_EFFECT;SPEED;-1;1  # Format: EFFECT;NAME;DAUER;STÄRKE
      permission: perks.potion_effect_speed_-1_1
      material: SUGAR
      amount: 1
      name: '&bSchnelligkeit+'
      lore:
        - '&8&m----------'
        - '&7+20% Geschwindigkeit.'
      slot: 23
      infoslot: 24
      blockedworld: []
```

{% hint style="info" %}
**Format:** `POTION_EFFECT;EFFECT_NAME;DURATION;AMPLIFIER`

* DURATION: `-1` = unendlich
* AMPLIFIER: `0` = Level I, `1` = Level II, etc.
  {% endhint %}
  {% endtab %}

{% tab title="Mob-Schutz" %}
**Schutz vor Creepern**

```yaml
perks:
  '1':
    NO_CREEPER_DAMAGE:
      enable: true
      perkType: NO_CREEPER_DAMAGE
      permission: perks.no_creeper_damage
      material: CREEPER_SPAWN_EGG
      amount: 1
      name: '&6Kein Creeper-Schaden'
      lore:
        - '&8&m----------'
        - 'Creeper fügen dir keinen Schaden zu.'
      slot: 19
      infoslot: 20
      blockedworld: []
```

{% hint style="success" %}
Funktioniert für **alle** Minecraft Entity-Typen!

Format: `NO_<ENTITY_TYPE>_DAMAGE`
{% endhint %}
{% endtab %}

{% tab title="Mit HEX-Farben" %}
**Moderner Perk mit Gradient (1.16+)**

```yaml
perks:
  '2':
    CUSTOM_PERK:
      enable: true
      perkType: NO_HUNGER
      permission: perks.custom_perk
      material: GOLDEN_APPLE
      amount: 1
      name: '&#FFD700E&#FFA500p&#FF8C00i&#FF6347c &#FF1493P&#9400D3erk'
      lore:
        - '&8&m━━━━━━━━━━━━━━'
        - '&#FFD700Eine eigene Beschreibung'
        - '&#FFD700mit mehreren Zeilen'
        - ''
        - '&e▶ Status: %perks_status_CUSTOM_PERK%'
      slot: 10
      infoslot: 11
      blockedworld:
        - world_pvp
```

{% endtab %}
{% endtabs %}

### Potion-Effekte im Detail

{% hint style="info" %}
**Format:** `POTION_EFFECT;<EFFECT_NAME>;<DURATION>;<AMPLIFIER>`

* DURATION: `-1` für unendlich, sonst Sekunden
* AMPLIFIER: `0` = Level I, `1` = Level II, `2` = Level III, etc.
  {% endhint %}

<details>

<summary>📜 Alle verfügbaren Potion-Effekte</summary>

**Positive Effekte:**

* `SPEED` - Geschwindigkeit
* `JUMP` - Sprungkraft
* `INCREASE_DAMAGE` - Stärke
* `REGENERATION` - Regeneration
* `DAMAGE_RESISTANCE` - Resistenz
* `FIRE_RESISTANCE` - Feuerresistenz
* `WATER_BREATHING` - Unterwasseratmung
* `INVISIBILITY` - Unsichtbarkeit
* `NIGHT_VISION` - Nachtsicht
* `FAST_DIGGING` - Eile
* `HEALTH_BOOST` - Bonusleben
* `ABSORPTION` - Absorption
* `SATURATION` - Sättigung
* `GLOWING` - Leuchten
* `LUCK` - Glück
* `SLOW_FALLING` - Sanfter Fall
* `CONDUIT_POWER` - Kraft der Meere
* `DOLPHINS_GRACE` - Delfin-Gnade

**Negative Effekte** (für spezielle Zwecke):

* `SLOW` - Langsamkeit
* `SLOW_DIGGING` - Abbaulähmung
* `HARM` - Sofortschaden
* `CONFUSION` - Übelkeit
* `BLINDNESS` - Blindheit
* `HUNGER` - Hunger
* `WEAKNESS` - Schwäche
* `POISON` - Vergiftung
* `WITHER` - Wither

</details>

<details>

<summary>✨ Beispiel-Kombinationen</summary>

```yaml
# Regeneration IV (unendlich)
perkType: POTION_EFFECT;REGENERATION;-1;3

# Jump Boost III (unendlich)
perkType: POTION_EFFECT;JUMP;-1;2

# Stärke II (unendlich)
perkType: POTION_EFFECT;INCREASE_DAMAGE;-1;1

# Feuerresistenz I (unendlich)
perkType: POTION_EFFECT;FIRE_RESISTANCE;-1;0

# Speed V (extreme Geschwindigkeit)
perkType: POTION_EFFECT;SPEED;-1;4

# Night Vision (perfekt für Höhlen)
perkType: POTION_EFFECT;NIGHT_VISION;-1;0
```

</details>

### Mob-Schutz erstellen

```yaml
perks:
  '1':
    NO_CREEPER_DAMAGE:
      enable: true
      perkType: NO_CREEPER_DAMAGE       # Format: NO_<MOBNAME>_DAMAGE
      permission: perks.no_creeper_damage
      material: CREEPER_SPAWN_EGG
      amount: 1
      name: '&6Kein Creeper-Schaden'
      lore:
        - '&8&m----------'
        - 'Creeper fügen dir keinen Schaden zu.'
      slot: 19
      infoslot: 20
      blockedworld: []
```

**Verfügbare Mob-Schutz Perks:**

* `NO_CREEPER_DAMAGE` - Creeper
* `NO_ZOMBIE_DAMAGE` - Zombies
* `NO_SKELETON_DAMAGE` - Skelette
* `NO_SPIDER_DAMAGE` - Spinnen
* `NO_ENDERMAN_DAMAGE` - Enderman
* `NO_BLAZE_DAMAGE` - Lohen
* `NO_GHAST_DAMAGE` - Ghasts
* `NO_SLIME_DAMAGE` - Schleime
* `NO_GUARDIAN_DAMAGE` - Wächter
* `NO_ZOMBIFIED_PIGLIN_DAMAGE` - Zombie-Piglins
* Und viele weitere (alle Minecraft-Entitäten)

***

### Legacy-Support (Minecraft < 1.13)

{% hint style="warning" %}
**Nur für Minecraft 1.8 - 1.12:** Verwende die `shortid`-Option für Data-Values!
{% endhint %}

Für Minecraft-Versionen **unter 1.13** kannst du die `shortid`-Option verwenden, um Data-Values für Items zu setzen.

{% tabs %}
{% tab title="Was ist shortid?" %}
**Data-Values in Legacy-Versionen:**

* In Minecraft < 1.13 hatten Items numerische Data-Values
* Beispiel: `WOOL` + `shortid: 3` = Hellblaue Wolle
* Ab 1.13+ wurden diese durch separate Material-Namen ersetzt (`LIGHT_BLUE_WOOL`)

Die `shortid`-Option wird in Minecraft 1.13+ automatisch ignoriert.
{% endtab %}

{% tab title="Beispiel" %}

```yaml
perks:
  '1':
    LEGACY_WOOL_PERK:
      enable: true
      perkType: NO_FALL_DAMAGE
      permission: perks.legacy_wool
      material: WOOL
      shortid: 3          # 3 = Hellblaue Wolle in 1.8-1.12
      amount: 1
      name: '&bWoll-Perk'
      lore:
        - '&7Funktioniert mit Legacy-Items'
      slot: 10
      infoslot: 11
      blockedworld: []
```

{% endtab %}

{% tab title="Häufige shortids" %}

<table><thead><tr><th width="200">Material</th><th width="100">shortid</th><th>Ergebnis</th></tr></thead><tbody><tr><td><code>WOOL</code></td><td>0-15</td><td>Verschiedene Wollfarben</td></tr><tr><td><code>STAINED_GLASS</code></td><td>0-15</td><td>Verschiedene Glasfarben</td></tr><tr><td><code>STAINED_GLASS_PANE</code></td><td>0-15</td><td>Verschiedene Scheiben</td></tr><tr><td><code>WOOD</code></td><td>0-5</td><td>Verschiedene Holzarten</td></tr><tr><td><code>LOG</code></td><td>0-3</td><td>Verschiedene Baumstämme</td></tr><tr><td><code>INK_SACK</code></td><td>0-15</td><td>Verschiedene Farbstoffe</td></tr><tr><td><code>MONSTER_EGG</code></td><td>Variiert</td><td>Verschiedene Spawn-Eggs</td></tr></tbody></table>
{% endtab %}
{% endtabs %}

***

### Slots und Layout

**Inventar-Größe 6 Zeilen (54 Slots):**

```
 0  1  2  3  4  5  6  7  8
 9 10 11 12 13 14 15 16 17
18 19 20 21 22 23 24 25 26
27 28 29 30 31 32 33 34 35
36 37 38 39 40 41 42 43 44
45 46 47 48 49 50 51 52 53
```

**Empfohlenes Layout mit Info-Slots:**

* Perk-Item: `slot: 10`
* Status-Indicator: `infoslot: 11`

So sind Perk und Status nebeneinander sichtbar.

***

## Erweiterte Einstellungen

### Mehrere Seiten erstellen

Du kannst beliebig viele Seiten hinzufügen:

```yaml
perks:
  '1':
    # 8 Perks auf Seite 1
  '2':
    # 8 Perks auf Seite 2
  '3':
    # 8 Perks auf Seite 3
  # usw...
```

Die Navigation zwischen Seiten erfolgt automatisch über die `prevPage` und `nextPage` Items.

### Weltbasierte Einschränkungen

Perks können pro Welt deaktiviert werden:

```yaml
blockedworld:
  - world          # Hauptwelt
  - world_nether   # Nether
  - world_the_end  # End
  - my_custom_world # Eigene Welt
```

**Wildcard-Unterstützung:**

```yaml
blockedworld:
  - world_pvp_*    # Alle Welten die mit "world_pvp_" beginnen
```

### Permissions ohne Permission

Lass das `permission`-Feld leer, um einen Perk für alle verfügbar zu machen:

```yaml
perks:
  '1':
    FREE_PERK:
      enable: true
      perkType: NO_FALL_DAMAGE
      permission: ''  # Leer = Kein Permission erforderlich
      # ... rest der Config
```

### Custom Head Textures

Für Player-Heads kannst du Custom Textures verwenden:

```yaml
material: PLAYER_HEAD
skullowner: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZjdhYWNhZDE5M2UyMjI2OTcxZWQ5NTMwMmRiYTQzMzQzOGJlNDY0NGZiYWI1ZWJmODE4MDU0MDYxNjY3ZmJlMiJ9fX0=
```

Die Textures kannst du von Seiten wie [Minecraft-Heads.com](https://minecraft-heads.com/) bekommen.

***

## Placeholder-Konfiguration

### Replacement Placeholders

Diese Placeholders werden in der GUI und in Nachrichten ersetzt:

```yaml
replacementplaceholders:
  timer_GARDENER:
    current: '%min%:%sec%'  # Anzeige während Cooldown läuft
    empty: ''               # Anzeige wenn kein Cooldown
  timer_FLY:
    current: '%min%:%sec%'
    empty: ''
  status:
    enabled: '&aAktiviert'
    disabled: '&7Deaktiviert'
    blocked: '&cNicht freigeschalten'
```

**Verwendung in Lore:**

```yaml
lore:
  - '&7Status: %perks_status_NO_FALL_DAMAGE%'
  - '&7Cooldown: %perks_timer_GARDENER%'
```

Siehe auch: [Placeholder.md](https://wiki.dyroxplays.de/perks/broken-reference) für vollständige PlaceholderAPI-Integration.

***

## Beispiel: Kompletter Custom Perk

Hier ist ein vollständiges Beispiel für einen eigenen Perk:

```yaml
perks:
  '1':
    CUSTOM_SUPER_SPEED:
      enable: true
      perkType: POTION_EFFECT;SPEED;-1;4  # Speed V (unendlich)
      permission: perks.vip.superspeed
      material: FEATHER
      amount: 1
      name: '&#00FFFFSuper Speed'
      lore:
        - '&8&m━━━━━━━━━━━━━━'
        - '&7Erhalte permanente Geschwindigkeit V'
        - '&7und werde zum schnellsten Spieler!'
        - ''
        - '&e▶ Status: %perks_status_CUSTOM_SUPER_SPEED%'
        - '&c▶ Nur für VIP+'
      slot: 28
      infoslot: 29
      blockedworld:
        - world_pvp
        - event_world
```

***

## Reload

{% hint style="info" %}
**Nach Änderungen:** Verwende `/perks reload` um die Config ohne Server-Neustart neu zu laden!
{% endhint %}

```bash
/perks reload
```

{% tabs %}
{% tab title="✅ Wird neu geladen" %}

* Alle Perk-Definitionen
* GUI-Layout und Items
* Nachrichten und Texte
* Placeholder-Formate
* Cooldown-Zeiten
* Instant-Smelt Einstellungen
  {% endtab %}

{% tab title="❌ Erfordert Neustart" %}

* MySQL-Verbindung
* Plugin-Hauptkonfiguration
* PlaceholderAPI-Integration

{% hint style="warning" %}
Aktive Perks der Spieler bleiben nach Reload aktiv!
{% endhint %}
{% endtab %}
{% endtabs %}

***

## Troubleshooting

<details>

<summary>🚫 Perk erscheint nicht im GUI</summary>

**Mögliche Ursachen:**

1. `enable: false` gesetzt → Setze auf `true`
2. Syntax-Fehler in der YAML-Datei → Prüfe Einrückungen!
3. Server nicht neu geladen → Verwende `/perks reload`
4. Slot bereits belegt → Prüfe `slot` und `placeholder` Items

**Lösung:**

```yaml
perks:
  '1':
    MEIN_PERK:
      enable: true  # ← Muss true sein!
      # ... rest der Config
```

</details>

<details>

<summary>⚠️ Perk funktioniert nicht</summary>

**Mögliche Ursachen:**

1. **Keine Permission:** Spieler hat nicht `perks.<perkname>`
2. **Welt gesperrt:** Welt ist in `blockedworld` Liste
3. **Falscher PerkType:** Überprüfe `perkType` Schreibweise
4. **Nicht aktiviert:** Spieler hat Perk im GUI nicht aktiviert

**Checkliste:**

* [ ] Permission vergeben?
* [ ] Welt erlaubt?
* [ ] PerkType korrekt?
* [ ] Perk im GUI aktiviert?

</details>

<details>

<summary>🎨 Status-Indicator wird nicht angezeigt</summary>

**Lösung:**

```yaml
MY_PERK:
  slot: 10       # Perk-Item Slot
  infoslot: 11   # Status-Indicator Slot (≠ slot!)
```

{% hint style="danger" %}
**Wichtig:** `infoslot` darf nicht von Placeholder-Items überdeckt werden!

Überprüfe die `placeholder` Konfiguration.
{% endhint %}

</details>

<details>

<summary>📝 YAML-Syntax-Fehler</summary>

**Häufige Fehler:**

* ❌ Tabs statt Leerzeichen verwendet
* ❌ Inkonsistente Einrückung
* ❌ Fehlende Anführungszeichen bei Sonderzeichen
* ❌ Doppelte Keys im selben Abschnitt

**Best Practices:**

* ✅ Verwende **2 Leerzeichen** pro Einrückungsebene
* ✅ Keine Tabs, nur Leerzeichen
* ✅ Teste Config mit [YAML-Validator](https://www.yamllint.com/)
* ✅ Verwende einen Editor mit YAML-Syntax-Highlighting

**Beispiel:**

```yaml
perks:
  '1':                    # 0 Leerzeichen
    PERK_NAME:            # 2 Leerzeichen
      enable: true        # 4 Leerzeichen
      perkType: FLY       # 4 Leerzeichen
```

</details>

***

## Weiterführende Dokumentation

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>📋 PerkTypes</strong></td><td>Alle verfügbaren Perk-Typen mit detaillierten Erklärungen</td><td><a href="broken-reference">Broken link</a></td></tr><tr><td><strong>🔖 Placeholder</strong></td><td>PlaceholderAPI Integration und Scoreboard-Beispiele</td><td><a href="broken-reference">Broken link</a></td></tr><tr><td><strong>📖 Hauptdokumentation</strong></td><td>Zurück zur Übersicht</td><td><a href="broken-reference">Broken link</a></td></tr></tbody></table>

* [Placeholder.md](https://wiki.dyroxplays.de/perks/broken-reference) - PlaceholderAPI Integration