# PerkTypes

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

{% hint style="info" %}
**Kompatibilität:** Alle Perk-Typen funktionieren mit Minecraft **1.8.8 bis zur neuesten Version** (1.21+).
{% endhint %}

## Übersicht aller Standard-Perks

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

{% hint style="success" %}
**Dynamische Perks:** Mob-Schutz und Potion-Effekte können für **jeden** Mob-Typ bzw. Effekt individuell erstellt werden!
{% endhint %}

***

## Gameplay-Perks

### NO\_FALL\_DAMAGE

Spieler erleiden **keinen Fallschaden** mehr.

```yaml
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.

```yaml
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**.

```yaml
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:**

```yaml
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.

```yaml
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.

```yaml
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.

```yaml
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:**

{% code title="" expandable="true" %}

```
// Some code
```

{% endcode %}

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

{% code title="Blockiert SHULKER\_BOX & COBBLESTONE" expandable="true" %}

```
droptoinvBlacklist:
- "SHULKER_BOX"
- "COBBLESTONE"
```

{% endcode %}

***

## XP-Perks

### KEEP\_XP

**Erfahrungspunkte** bleiben beim Tod erhalten.

```yaml
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**.

```yaml
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**.

```yaml
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.).

```yaml
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**.

```yaml
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).

```yaml
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).

```yaml
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

```yaml
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)

```yaml
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)

```yaml
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)

```yaml
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)

```yaml
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)

```yaml
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 `;`:

```yaml
# 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.

```yaml
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.

```yaml
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

```yaml
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:**

```yaml
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:

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

**Beispiele für neue Mobs (1.19+):**

```yaml
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:**

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

**2. PerkListener.java:**

```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

{% stepper %}
{% step %}

### 1. Namenskonvention

Verwende konsistente Namen für deine Perks:

```yaml
# Gut
NO_FALL_DAMAGE:
  perkType: NO_FALL_DAMAGE

# Vermeiden
myNoFallPerk:
  perkType: NO_FALL_DAMAGE
```

{% endstep %}

{% step %}

### 2. Permission-Struktur

```yaml
permission: perks.<kategorie>.<perk>

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

{% endstep %}

{% step %}

### 3. Welteinschränkungen

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

```yaml
blockedworld:
  - world_pvp
  - world_event
  - arena
```

{% endstep %}

{% step %}

### 4. Page-Organisation

Organisiere Perks thematisch:

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

{% endstep %}
{% endstepper %}

***

**Weitere Informationen:**

* [Beschreibung.md](https://wiki.dyroxplays.de/perks/broken-reference) - Plugin-Übersicht
* [Konfiguration.md](https://wiki.dyroxplays.de/perks/broken-reference) - Detaillierte Config-Anleitung
* [Placeholder.md](https://wiki.dyroxplays.de/perks/broken-reference) - PlaceholderAPI Integration