> For the complete documentation index, see [llms.txt](https://wiki.dyroxplays.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.dyroxplays.de/perks/perktypes.md). # 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
Perk-TypKurzbeschreibungPermission (Beispiel)
NO_FALL_DAMAGEKein Fallschadenperks.no_fall_damage
NO_HUNGERHunger sinkt nicht mehrperks.no_hunger
FLYFlug-Modus im Survivalperks.fly
KEEP_INVInventar beim Tod behaltenperks.keep_inv
KEEP_HOTBARHotbar beim Tod behaltenperks.keep_hotbar
KEEP_XPXP beim Tod behaltenperks.keep_xp
DOUBLE_XPDoppelte Erfahrungspunkte (2x)perks.double_xp
QUAD_XPVierfache Erfahrungspunkte (4x)perks.quad_xp
DROP_TO_INVDrops direkt ins Inventarperks.drop_to_inv
NO_EXPLOSIONKein Explosionsschadenperks.no_explosion
NO_LAVAKein Lavaschadenperks.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_1Pflanzen wachsen beim Sneaken (1x1)perks.gardener_1
GARDENER_2Pflanzen wachsen beim Sneaken (3x3)perks.gardener_2
POTION_EFFECTDauerhafter Trank-Effekt (konfigurierbar)perks.potion_effect_*
NO_MOB_DAMAGESchutz vor spezifischen Mobs (dynamisch)perks.no_<mob>_damage
{% 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__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__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;;; ``` **Parameter:** * `` - Name des Potion-Effekts (siehe Liste unten) * `` - Dauer in Sekunden (`-1` für unendlich) * `` - 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___ ``` *** ## 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__DAMAGE: enable: true perkType: NO__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__DAMAGE (alle Minecraft Entity-Types) ``` ### Spezielle Formate ``` POTION_EFFECT;;; ``` *** ## 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.. # 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](broken://pages/bdc328c1a6001c9c58cf99f192ea914b0988952f) - Plugin-Übersicht * [Konfiguration.md](broken://pages/1469ece7c982f482365606634f6ea8ce984e36f6) - Detaillierte Config-Anleitung * [Placeholder.md](broken://pages/22763eb38a692adadaa437640dd876b399322d50) - PlaceholderAPI Integration --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wiki.dyroxplays.de/perks/perktypes.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.