> For the complete documentation index, see [llms.txt](https://wiki.dyroxplays.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.dyroxplays.de/perks/konfiguration.md).

# 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="/pages/a4114191b4b2fc528a5251436005af31da39862e">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](broken://pages/208c15217ca72deb31bea892d3e60e92e67b7285) 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="/pages/a4114191b4b2fc528a5251436005af31da39862e">/pages/a4114191b4b2fc528a5251436005af31da39862e</a></td></tr><tr><td><strong>🔖 Placeholder</strong></td><td>PlaceholderAPI Integration und Scoreboard-Beispiele</td><td><a href="/pages/208c15217ca72deb31bea892d3e60e92e67b7285">/pages/208c15217ca72deb31bea892d3e60e92e67b7285</a></td></tr><tr><td><strong>📖 Hauptdokumentation</strong></td><td>Zurück zur Übersicht</td><td><a href="/pages/6d98e9da67e7da6cd24c93190d65c16c53ce0835">/pages/6d98e9da67e7da6cd24c93190d65c16c53ce0835</a></td></tr></tbody></table>

* [Placeholder.md](broken://pages/208c15217ca72deb31bea892d3e60e92e67b7285) - PlaceholderAPI Integration


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.dyroxplays.de/perks/konfiguration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.