🍀PerkTypes

Diese Dokumentation listet alle verfügbaren Perk-Typen auf, die du in der config.yml verwenden kannst.

Kompatibilität: Alle Perk-Typen funktionieren mit Minecraft 1.8.8 bis zur neuesten Version (1.21+).

Übersicht aller Standard-Perks

Perk-Typ	Kurzbeschreibung	Permission (Beispiel)
NO_FALL_DAMAGE	Kein Fallschaden	perks.no_fall_damage
NO_HUNGER	Hunger sinkt nicht mehr	perks.no_hunger
FLY	Flug-Modus im Survival	perks.fly
KEEP_INV	Inventar beim Tod behalten	perks.keep_inv
KEEP_HOTBAR	Hotbar beim Tod behalten	perks.keep_hotbar
KEEP_XP	XP beim Tod behalten	perks.keep_xp
DOUBLE_XP	Doppelte Erfahrungspunkte (2x)	perks.double_xp
QUAD_XP	Vierfache Erfahrungspunkte (4x)	perks.quad_xp
DROP_TO_INV	Drops direkt ins Inventar	perks.drop_to_inv
NO_EXPLOSION	Kein Explosionsschaden	perks.no_explosion
NO_LAVA	Kein Lavaschaden	perks.no_lava
EXTRA_HEARTS_5	+5 zusätzliche Herzen (+10 HP)	perks.extra_hearts_5
EXTRA_HEARTS_10	+10 zusätzliche Herzen (+20 HP)	perks.extra_hearts_10
GARDENER_1	Pflanzen wachsen beim Sneaken (1x1)	perks.gardener_1
GARDENER_2	Pflanzen wachsen beim Sneaken (3x3)	perks.gardener_2
POTION_EFFECT	Dauerhafter Trank-Effekt (konfigurierbar)	perks.potion_effect_*
NO_MOB_DAMAGE	Schutz vor spezifischen Mobs (dynamisch)	perks.no_<mob>_damage

Dynamische Perks: Mob-Schutz und Potion-Effekte können für jeden Mob-Typ bzw. Effekt individuell erstellt werden!

---

Gameplay-Perks

NO_FALL_DAMAGE

Spieler erleiden keinen Fallschaden mehr.

MY_NO_FALL_PERK:
  enable: true
  perkType: NO_FALL_DAMAGE
  permission: perks.no_fall_damage
  material: NETHERITE_BOOTS
  name: '&6Kein Fallschaden'
  lore:
    - '&7Du erhältst keinen Fallschaden mehr.'
  slot: 10
  infoslot: 11
  blockedworld: []

Events: EntityDamageEvent mit Cause FALL

---

NO_HUNGER

Die Hunger-Anzeige des Spielers sinkt nicht mehr.

MY_NO_HUNGER_PERK:
  enable: true
  perkType: NO_HUNGER
  permission: perks.no_hunger
  material: COOKED_BEEF
  name: '&6Kein Hunger'
  lore:
    - '&7Deine Hunger-Anzeige sinkt nicht mehr.'
  slot: 19
  infoslot: 20
  blockedworld: []

Funktionsweise: Hunger-Wert wird konstant auf Maximum gehalten

---

FLY

Ermöglicht dem Spieler das Fliegen im Survival-Modus.

MY_FLY_PERK:
  enable: true
  perkType: FLY
  permission: perks.fly
  material: FEATHER
  name: '&6Fly'
  lore:
    - '&7Flug-Modus im Survival'
  slot: 28
  infoslot: 29
  blockedworld:
    - world_nether

Features:

• Automatische Aktivierung

• PlotSquared-Integration (nur auf eigenem Plot)

• Konfigurierbare Warnzeit vor Deaktivierung

• Timer-Placeholder verfügbar

Konfiguration:

fly:
  sec: 5  # Warnzeit in Sekunden
  message: '&cDu kannst nur noch &e%sec% Sekunden &cfliegen'
  blockedworld:
    - world_nether

Placeholder:

• %perks_timer_FLY% - Verbleibende Zeit

---

Inventar-Perks

KEEP_INV

Das gesamte Inventar bleibt beim Tod erhalten.

MY_KEEP_INV_PERK:
  enable: true
  perkType: KEEP_INV
  permission: perks.keep_inv
  material: ENDER_CHEST
  name: '&6KeepInventory'
  lore:
    - '&7Inventar ist beim Tod sicher.'
  slot: 14
  infoslot: 15
  blockedworld: []

Events: PlayerDeathEvent

---

KEEP_HOTBAR

Nur die Hotbar (Slots 0-8) bleibt beim Tod erhalten.

MY_KEEP_HOTBAR_PERK:
  enable: true
  perkType: KEEP_HOTBAR
  permission: perks.keep_hotbar
  material: CHEST
  name: '&6KeepHotbar'
  lore:
    - '&7Hotbar ist beim Tod sicher.'
  slot: 37
  infoslot: 38
  blockedworld: []

Events: PlayerDeathEvent, PlayerRespawnEvent

---

DROP_TO_INV

Abgebaute Blöcke landen direkt im Inventar statt zu droppen.

MY_DROP_TO_INV_PERK:
  enable: true
  perkType: DROP_TO_INV
  permission: perks.drop_to_inv
  material: HOPPER
  name: '&6DropToInv'
  lore:
    - '&7Abgebaute Blöcke landen'
    - '&7direkt in deinem Inventar.'
  slot: 32
  infoslot: 33
  blockedworld: []

Events: BlockBreakEvent

Features:

// Some code

• Drops werden automatisch zum Inventar hinzugefügt

• Funktioniert nicht, wenn Inventar voll ist

Blacklist für DROP_TO_INV

Bestimmte Items können blockiert werden, welche nicht bei DROP_TO_INV getriggert werden sollen, adde dafür in die config.yml beispielsweise:

Blockiert SHULKER_BOX & COBBLESTONE

droptoinvBlacklist:
- "SHULKER_BOX"
- "COBBLESTONE"

---

XP-Perks

KEEP_XP

Erfahrungspunkte bleiben beim Tod erhalten.

MY_KEEP_XP_PERK:
  enable: true
  perkType: KEEP_XP
  permission: perks.keep_xp
  material: EXPERIENCE_BOTTLE
  name: '&6KeepXP'
  lore:
    - '&7XP sind beim Tod sicher.'
  slot: 23
  infoslot: 24
  blockedworld: []

Events: PlayerDeathEvent

---

DOUBLE_XP

Spieler erhalten doppelte Erfahrungspunkte.

MY_DOUBLE_XP_PERK:
  enable: true
  perkType: DOUBLE_XP
  permission: perks.double_xp
  material: EXPERIENCE_BOTTLE
  amount: 2
  name: '&aDoppelte XP'
  lore:
    - '&7Doppelte Menge an XP.'
  slot: 19
  infoslot: 20
  blockedworld: []

Events: PlayerExpChangeEvent

Multiplikator: 2x

---

QUAD_XP

Spieler erhalten vierfache Erfahrungspunkte.

MY_QUAD_XP_PERK:
  enable: true
  perkType: QUAD_XP
  permission: perks.quad_xp
  material: EXPERIENCE_BOTTLE
  amount: 4
  name: '&aVierfach XP'
  lore:
    - '&7Vierfache Menge an XP.'
  slot: 28
  infoslot: 29
  blockedworld: []

Events: PlayerExpChangeEvent

Multiplikator: 4x

Hinweis: QUAD_XP und DOUBLE_XP können nicht gleichzeitig aktiv sein. QUAD_XP hat Vorrang.

---

Schutz-Perks

NO_EXPLOSION

Spieler erleiden keinen Explosionsschaden (Creeper, TNT, etc.).

MY_NO_EXPLOSION_PERK:
  enable: true
  perkType: NO_EXPLOSION
  permission: perks.no_explosion
  material: TNT
  name: '&6Kein Explosionsschaden'
  lore:
    - '&7Du erleidest keinen Explosionsschaden.'
  slot: 10
  infoslot: 11
  blockedworld: []

Events: EntityDamageEvent mit Cause BLOCK_EXPLOSION oder ENTITY_EXPLOSION

---

NO_LAVA

Spieler erleiden keinen Lavaschaden.

MY_NO_LAVA_PERK:
  enable: true
  perkType: NO_LAVA
  permission: perks.no_lava
  material: LAVA_BUCKET
  name: '&6Kein Lavaschaden'
  lore:
    - '&7Du erleidest keinen Schaden durch Lava.'
  slot: 19
  infoslot: 20
  blockedworld: []

Events: EntityDamageEvent mit Cause LAVA

---

EXTRA_HEARTS_5

Spieler erhalten 5 zusätzliche Herzen (+10 HP).

MY_EXTRA_HEARTS_5_PERK:
  enable: true
  perkType: EXTRA_HEARTS_5
  permission: perks.extra_hearts_5
  material: REDSTONE
  amount: 5
  name: '&c5 Extra-Herzen'
  lore:
    - '&7Du erhältst 5 zusätzliche Herzen.'
  slot: 41
  infoslot: 42
  blockedworld: []

Funktionsweise:

• Basis-Leben: 20 HP (10 Herzen)

• Mit Perk: 30 HP (15 Herzen)

• Bei Deaktivierung: Zurück auf 20 HP

---

EXTRA_HEARTS_10

Spieler erhalten 10 zusätzliche Herzen (+20 HP).

MY_EXTRA_HEARTS_10_PERK:
  enable: true
  perkType: EXTRA_HEARTS_10
  permission: perks.extra_hearts_10
  material: NETHER_STAR
  amount: 10
  name: '&c10 Extra-Herzen'
  lore:
    - '&7Du erhältst 10 zusätzliche Herzen.'
  slot: 10
  infoslot: 11
  blockedworld: []

Funktionsweise:

• Basis-Leben: 20 HP (10 Herzen)

• Mit Perk: 40 HP (20 Herzen)

Hinweis: EXTRA_HEARTS_10 und EXTRA_HEARTS_5 können nicht gleichzeitig aktiv sein.

---

Mob-Schutz-Perks

Mob-Schutz-Perks schützen vor Schaden durch spezifische Mob-Typen.

Format

NO_<MOBNAME>_DAMAGE

Verfügbare Mob-Schutz-Perks

Perk-Typ	Beschreibung	Entity-Type
NO_CREEPER_DAMAGE	Kein Creeper-Schaden	CREEPER
NO_ZOMBIE_DAMAGE	Kein Zombie-Schaden	ZOMBIE
NO_SKELETON_DAMAGE	Kein Skelett-Schaden	SKELETON
NO_SPIDER_DAMAGE	Kein Spinnen-Schaden	SPIDER
NO_ENDERMAN_DAMAGE	Kein Enderman-Schaden	ENDERMAN
NO_BLAZE_DAMAGE	Kein Lohen-Schaden	BLAZE
NO_GHAST_DAMAGE	Kein Ghast-Schaden	GHAST
NO_SLIME_DAMAGE	Kein Schleim-Schaden	SLIME
NO_GUARDIAN_DAMAGE	Kein Wächter-Schaden	GUARDIAN
NO_ZOMBIFIED_PIGLIN_DAMAGE	Kein Pigman-Schaden	ZOMBIFIED_PIGLIN

Beispiel: Creeper-Schutz

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

Funktionsweise

Das Plugin erkennt automatisch alle Mob-Typen mit dem Format NO_<MOBNAME>_DAMAGE.

Events: EntityDamageByEntityEvent

Alle Minecraft Entity-Typen

Du kannst für jeden Entity-Type einen Schutz-Perk erstellen:

NO_WITHER_DAMAGE
NO_ENDER_DRAGON_DAMAGE
NO_PHANTOM_DAMAGE
NO_DROWNED_DAMAGE
NO_HUSK_DAMAGE
NO_STRAY_DAMAGE
NO_WITCH_DAMAGE
NO_PILLAGER_DAMAGE
NO_RAVAGER_DAMAGE
NO_VEX_DAMAGE
NO_VINDICATOR_DAMAGE
NO_EVOKER_DAMAGE
NO_PIGLIN_DAMAGE
NO_HOGLIN_DAMAGE
NO_ZOGLIN_DAMAGE
NO_WARDEN_DAMAGE

---

Potion-Effect-Perks

Potion-Effect-Perks geben Spielern dauerhafte Trank-Effekte.

Format

perkType: POTION_EFFECT;<EFFECT>;<DURATION>;<AMPLIFIER>

Parameter:

• <EFFECT> - Name des Potion-Effekts (siehe Liste unten)

• <DURATION> - Dauer in Sekunden (-1 für unendlich)

• <AMPLIFIER> - Stärke des Effekts (0 = Level I, 1 = Level II, etc.)

Verfügbare Potion-Effekte

Effect-Name	Beschreibung	Minecraft-Name
SPEED	Geschwindigkeit	Speed
SLOW	Langsamkeit	Slowness
FAST_DIGGING	Eile	Haste
SLOW_DIGGING	Abbaulähmung	Mining Fatigue
INCREASE_DAMAGE	Stärke	Strength
HEAL	Sofortige Heilung	Instant Health
HARM	Sofortschaden	Instant Damage
JUMP	Sprungkraft	Jump Boost
CONFUSION	Übelkeit	Nausea
REGENERATION	Regeneration	Regeneration
DAMAGE_RESISTANCE	Resistenz	Resistance
FIRE_RESISTANCE	Feuerresistenz	Fire Resistance
WATER_BREATHING	Unterwasseratmung	Water Breathing
INVISIBILITY	Unsichtbarkeit	Invisibility
BLINDNESS	Blindheit	Blindness
NIGHT_VISION	Nachtsicht	Night Vision
HUNGER	Hunger	Hunger
WEAKNESS	Schwäche	Weakness
POISON	Vergiftung	Poison
WITHER	Wither	Wither
HEALTH_BOOST	Bonusleben	Health Boost
ABSORPTION	Absorption	Absorption
SATURATION	Sättigung	Saturation
GLOWING	Leuchten	Glowing
LEVITATION	Schwebekraft	Levitation
LUCK	Glück	Luck
UNLUCK	Pech	Bad Luck
SLOW_FALLING	Sanfter Fall	Slow Falling
CONDUIT_POWER	Kraft der Meere	Conduit Power
DOLPHINS_GRACE	Delfin-Gnade	Dolphin's Grace
BAD_OMEN	Übles Omen	Bad Omen
HERO_OF_THE_VILLAGE	Held des Dorfes	Hero of the Village

Beispiele

Speed II (Unendlich)

POTION_EFFECT_SPEED_-1_1:
  enable: true
  perkType: POTION_EFFECT;SPEED;-1;1
  permission: perks.potion_effect_speed_-1_1
  material: SUGAR
  name: '&bSchnelligkeit+'
  lore:
    - '&7Dauerhafte Geschwindigkeit II'
  slot: 23
  infoslot: 24
  blockedworld: []

Regeneration IV (Unendlich)

POTION_EFFECT_REGENERATION_-1_3:
  enable: true
  perkType: POTION_EFFECT;REGENERATION;-1;3
  permission: perks.potion_effect_regeneration_-1_3
  material: ENCHANTED_GOLDEN_APPLE
  name: '&dRegeneration+2'
  lore:
    - '&7Regeneration 4 Effekt.'
  slot: 14
  infoslot: 15
  blockedworld: []

Strength I (Unendlich)

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
  name: '&cStärke+'
  lore:
    - '&7Erhöhter Angriffsschaden.'
  slot: 37
  infoslot: 38
  blockedworld: []

Jump Boost V (Unendlich)

POTION_EFFECT_JUMP_-1_4:
  enable: true
  perkType: POTION_EFFECT;JUMP;-1;4
  permission: perks.potion_effect_jump_-1_4
  material: RABBIT_FOOT
  name: '&eSuper Jump'
  lore:
    - '&7Springe extrem hoch!'
  slot: 32
  infoslot: 33
  blockedworld: []

Night Vision (Unendlich)

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
  name: '&fNachtsicht+'
  lore:
    - '&7Nachtsicht-Effekt.'
  slot: 41
  infoslot: 42
  blockedworld: []

Levelsystem

Amplifier-Werte:

Amplifier	Level	Beispiel
0	I	Speed I
1	II	Speed II
2	III	Speed III
3	IV	Speed IV
4	V	Speed V
5	VI	Speed VI
...	...	...
255	Maximum	Speed 256

Config-Key Format

Wichtig: Der Config-Key (Name des Perks) muss Unterstriche _ verwenden statt Semikolons ;:

# Config-Key mit Unterstrichen
POTION_EFFECT_SPEED_-1_1:
  # perkType mit Semikolons
  perkType: POTION_EFFECT;SPEED;-1;1

Namenskonvention:

POTION_EFFECT_<EFFEKT>_<DAUER>_<STÄRKE>

---

Gärtner-Perks

Gärtner-Perks lassen Pflanzen schneller wachsen, wenn der Spieler sneakt.

GARDENER_1

Pflanzen im 1x1 Radius wachsen beim Sneaken.

GARDENER_1:
  enable: true
  perkType: GARDENER_1
  permission: perks.gardener_1
  material: WHEAT_SEEDS
  name: '&2Gärtner'
  lore:
    - '&7Pflanzen wachsen schneller (Sneaken).'
  slot: 37
  infoslot: 38
  blockedworld: []

Radius: 1x1 (nur der Block unter dem Spieler)

---

GARDENER_2

Pflanzen im 3x3 Radius wachsen beim Sneaken.

GARDENER_2:
  enable: true
  perkType: GARDENER_2
  permission: perks.gardener_2
  material: PUMPKIN_SEEDS
  name: '&2Gärtner+'
  lore:
    - '&73x3 Pflanzen wachsen schneller (Sneaken).'
  slot: 14
  infoslot: 15
  blockedworld: []

Radius: 3x3 (9 Blöcke um den Spieler herum)

Funktionsweise

• Spieler sneakt auf/über einer Pflanze

• Plugin prüft Radius und lässt Pflanzen wachsen

• Cooldown verhindert Spam

Unterstützte Pflanzen:

• Weizen (Wheat)

• Karotten (Carrots)

• Kartoffeln (Potatoes)

• Rote Beete (Beetroot)

• Kürbisse (Pumpkin)

• Melonen (Melon)

• Kakteen (Cactus)

• Zuckerrohr (Sugar Cane)

• Netherwart

• Süßbeeren (Sweet Berries)

Cooldown

GARDENER_COOLDOWN_MS: 15000  # 15 Sekunden

Placeholder:

• %perks_timer_GARDENER% - Verbleibende Cooldown-Zeit

Events: PlayerToggleSneakEvent

---

Sonstige Perks

INSTANT_SMELT

Hinweis: Dieser Perk-Typ wird derzeit nicht als direkter perkType verwendet, sondern über eine separate Config-Sektion konfiguriert.

Erze und andere Blöcke werden automatisch geschmolzen abgebaut.

Konfiguration:

instantsmel:
  - SAND-GLASS
  - COBBLESTONE-STONE
  - IRON_ORE-IRON_INGOT
  - GOLD_ORE-GOLD_INGOT
  - ANCIENT_DEBRIS-NETHERITE_SCRAP

Format: URSPRUNG-ERGEBNIS

Events: BlockBreakEvent

---

BREAK_SPAWNER

Hinweis: Dieser Perk-Typ ist im Code vorbereitet, aber nicht als PerkType-Enum definiert.

Erlaubt das Aufheben von Spawnern.

Implementierung: Custom PerkType erforderlich

---

Eigene PerkTypes erstellen

Das Plugin unterstützt dynamische Mob-Schutz-Perks. Andere Perk-Typen müssen im Code erweitert werden.

Dynamische Mob-Schutz-Perks

Du kannst jeden Entity-Type als Mob-Schutz-Perk verwenden:

NO_<ENTITY_TYPE>_DAMAGE:
  enable: true
  perkType: NO_<ENTITY_TYPE>_DAMAGE
  # ... rest der Config

Beispiele für neue Mobs (1.19+):

NO_WARDEN_DAMAGE:
  enable: true
  perkType: NO_WARDEN_DAMAGE
  permission: perks.no_warden_damage
  material: SCULK_SENSOR
  name: '&6Kein Warden-Schaden'
  lore:
    - '&7Der Warden kann dir nichts anhaben.'
  slot: 10
  infoslot: 11
  blockedworld: []

Code-Erweiterungen

Neue Perk-Typen müssen im Code hinzugefügt werden:

1. PerkType.java:

public enum PerkType {
    // ... bestehende Typen
    MY_CUSTOM_PERK;
}

2. PerkListener.java:

// Event-Listener für den Custom-Perk hinzufügen
@EventHandler
public void onMyCustomEvent(MyEvent e) {
    Player p = e.getPlayer();
    if (PerkPlayer.hasEnabled(p, "MY_CUSTOM_PERK") 
        && !isBlocked(p, "MY_CUSTOM_PERK")) {
        // Perk-Logik hier
    }
}

---

Zusammenfassung aller PerkTypes

Standard-Enum-Typen

NO_FALL_DAMAGE
NO_HUNGER
FLY
KEEP_INV
KEEP_HOTBAR
KEEP_XP
DOUBLE_XP
QUAD_XP
DROP_TO_INV
NO_EXPLOSION
NO_LAVA
EXTRA_HEARTS_5
EXTRA_HEARTS_10
GARDENER_1
GARDENER_2
POTION_EFFECT (mit Parametern)
NO_MOB_DAMAGE (dynamisch für alle Mobs)

Dynamische Typen

NO_<ENTITY_TYPE>_DAMAGE (alle Minecraft Entity-Types)

Spezielle Formate

POTION_EFFECT;<EFFECT>;<DURATION>;<AMPLIFIER>

---

Best Practices

1

1. Namenskonvention

Verwende konsistente Namen für deine Perks:

# Gut
NO_FALL_DAMAGE:
  perkType: NO_FALL_DAMAGE

# Vermeiden
myNoFallPerk:
  perkType: NO_FALL_DAMAGE

2

2. Permission-Struktur

permission: perks.<kategorie>.<perk>

# Beispiele:
permission: perks.protection.no_fall_damage
permission: perks.effects.speed_2
permission: perks.vip.extra_hearts_10

3

3. Welteinschränkungen

Nutze blockedworld für PvP- oder Event-Welten:

blockedworld:
  - world_pvp
  - world_event
  - arena

4

4. Page-Organisation

Organisiere Perks thematisch:

perks:
  '1':  # Schutz-Perks
    NO_FALL_DAMAGE: ...
    NO_EXPLOSION: ...
  '2':  # Trank-Effekte
    POTION_EFFECT_SPEED_-1_1: ...
  '3':  # XP & Inventar
    DOUBLE_XP: ...
    KEEP_INV: ...

---

Weitere Informationen:

• Beschreibung.md - Plugin-Übersicht

• Konfiguration.md - Detaillierte Config-Anleitung

• Placeholder.md - PlaceholderAPI Integration