📃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

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

Der Prefix wird vor allen Plugin-Nachrichten angezeigt.

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

HEX-Farben werden automatisch in Minecraft 1.16+ unterstützt!

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

Erstelle beeindruckende Farbverläufe!

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

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

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

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

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

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

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

Dauerhafter Trank-Effekt (Speed II)

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: []

Format: POTION_EFFECT;EFFECT_NAME;DURATION;AMPLIFIER

DURATION: -1 = unendlich
AMPLIFIER: 0 = Level I, 1 = Level II, etc.

Schutz vor Creepern

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: []

Funktioniert für alle Minecraft Entity-Typen!

Format: NO_<ENTITY_TYPE>_DAMAGE

Moderner Perk mit Gradient (1.16+)

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

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.

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.

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: []

Material

shortid

Ergebnis

WOOL

0-15

Verschiedene Wollfarben

STAINED_GLASS

0-15

Verschiedene Glasfarben

STAINED_GLASS_PANE

0-15

Verschiedene Scheiben

WOOD

0-5

Verschiedene Holzarten

LOG

0-3

Verschiedene Baumstämme

INK_SACK

0-15

Verschiedene Farbstoffe

MONSTER_EGG

Variiert

Verschiedene Spawn-Eggs

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

Alle Perk-Definitionen
GUI-Layout und Items
Nachrichten und Texte
Placeholder-Formate
Cooldown-Zeiten
Instant-Smelt Einstellungen

MySQL-Verbindung
Plugin-Hauptkonfiguration
PlaceholderAPI-Integration

Aktive Perks der Spieler bleiben nach Reload aktiv!

Troubleshooting

🚫 Perk erscheint nicht im GUI

Mögliche Ursachen:

enable: false gesetzt → Setze auf true
Syntax-Fehler in der YAML-Datei → Prüfe Einrückungen!
Server nicht neu geladen → Verwende /perks reload
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:

Keine Permission: Spieler hat nicht perks.<perkname>
Welt gesperrt: Welt ist in blockedworld Liste
Falscher PerkType: Überprüfe perkType Schreibweise
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

VorherigeBeschreibung

NächstePerkTypes

Zuletzt aktualisiert vor 6 Monaten

Grundkonfiguration

Prefix

Cooldowns

Fly-Einstellungen

Instant Smelt

Nachrichten

MySQL-Einstellungen

GUI-Konfiguration

Allgemeine GUI-Einstellungen

Placeholder-Items

Navigation-Items

Status-Indicator Items

Perks erstellen

Grundlegende Struktur

Beispiele

Potion-Effekte im Detail

Mob-Schutz erstellen

Legacy-Support (Minecraft < 1.13)

Slots und Layout

Erweiterte Einstellungen

Mehrere Seiten erstellen

Weltbasierte Einschränkungen

Permissions ohne Permission

Custom Head Textures

Placeholder-Konfiguration

Replacement Placeholders

Beispiel: Kompletter Custom Perk

Reload

Troubleshooting

Weiterführende Dokumentation