📃Konfiguration

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

Tipp: Nach Änderungen an der Config kannst du /perks reload verwenden, um die Änderungen ohne Server-Neustart zu laden.

Grundkonfiguration

config.yml example

# ##// 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

Prefix

Standard

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

Der Prefix wird vor allen Plugin-Nachrichten angezeigt.

Mit HEX-Farben (1.16+)

Mit Gradient

Cooldowns

GARDENER_COOLDOWN_MS: 15000  # 15 Sekunden in Millisekunden

Hinweis: Die Zeit wird in Millisekunden angegeben.

15000 ms = 15 Sekunden

Fly-Einstellungen

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

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

Format: URSPRUNG-ERGEBNIS

📦 Weitere Instant Smelt Beispiele

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

Nachrichten

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

---

MySQL-Einstellungen

Lokaler Server

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

Externer Server

Mit Custom Port

Wichtig: Die Datenbank muss bereits existieren! Das Plugin erstellt nur automatisch die benötigten Tabellen.

Tipp: Nutze ein starkes Passwort für die MySQL-Verbindung!

---

GUI-Konfiguration

Allgemeine GUI-Einstellungen

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

Placeholder-Items

Placeholder-Items werden als Hintergrund verwendet:

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

Weitere Beispiele:

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

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):

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

Schnellstart: Kopiere die Vorlage unten und passe sie an deine Bedürfnisse an!

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

Parameter	Erforderlich	Beschreibung
enable	✅ Ja	Aktiviert/Deaktiviert den Perk
perkType	✅ Ja	Der Typ des Perks (siehe PerkTypes.md)
permission	❌ Nein	Erforderliche Permission (leer = für alle)
material	✅ Ja	Das Item-Material aus Minecraft
shortid	❌ Nein	Data-Value für Minecraft < 1.13
amount	❌ Nein	Stackgröße des Items (Standard: 1)
name	✅ Ja	Anzeigename des Perks
lore	❌ Nein	Beschreibungstext (mehrere Zeilen)
slot	✅ Ja	Slot-Position des Perk-Items (0-53)
infoslot	✅ Ja	Slot für Status-Indicator
blockedworld	❌ Nein	Liste von Welten wo Perk nicht funktioniert

Beispiele

No Fall Damage

Einfacher Schutz-Perk

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

Potion Effect

Mob-Schutz

Mit HEX-Farben

Potion-Effekte im Detail

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.

📜 Alle verfügbaren Potion-Effekte

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

✨ Beispiel-Kombinationen

# 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

Mob-Schutz erstellen

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)

Nur für Minecraft 1.8 - 1.12: Verwende die shortid-Option für Data-Values!

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

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.

Beispiel

Häufige shortids

---

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:

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:

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

Wildcard-Unterstützung:

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:

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:

material: PLAYER_HEAD
skullowner: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZjdhYWNhZDE5M2UyMjI2OTcxZWQ5NTMwMmRiYTQzMzQzOGJlNDY0NGZiYWI1ZWJmODE4MDU0MDYxNjY3ZmJlMiJ9fX0=

Die Textures kannst du von Seiten wie Minecraft-Heads.com bekommen.

---

Placeholder-Konfiguration

Replacement Placeholders

Diese Placeholders werden in der GUI und in Nachrichten ersetzt:

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:

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

Siehe auch: Placeholder.md für vollständige PlaceholderAPI-Integration.

---

Beispiel: Kompletter Custom Perk

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

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

Nach Änderungen: Verwende /perks reload um die Config ohne Server-Neustart neu zu laden!

/perks reload

✅ Wird neu geladen

• Alle Perk-Definitionen

• GUI-Layout und Items

• Nachrichten und Texte

• Placeholder-Formate

• Cooldown-Zeiten

• Instant-Smelt Einstellungen

❌ Erfordert Neustart

---

Troubleshooting

🚫 Perk erscheint nicht im GUI

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:

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

⚠️ Perk funktioniert nicht

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?

🎨 Status-Indicator wird nicht angezeigt

Lösung:

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

Wichtig: infoslot darf nicht von Placeholder-Items überdeckt werden!

Überprüfe die placeholder Konfiguration.

📝 YAML-Syntax-Fehler

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

• ✅ Verwende einen Editor mit YAML-Syntax-Highlighting

Beispiel:

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

---

Weiterführende Dokumentation

📋 PerkTypes

Alle verfügbaren Perk-Typen mit detaillierten Erklärungen

🔖 Placeholder

PlaceholderAPI Integration und Scoreboard-Beispiele

📖 Hauptdokumentation

Zurück zur Übersicht

• Placeholder.md - PlaceholderAPI Integration