> For the complete documentation index, see [llms.txt](https://unbox-1.gitbook.io/unbox/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://unbox-1.gitbook.io/unbox/configuration.md).

# Configuration

Each pack is a standalone YAML document that defines the item’s name, lore, which Minecraft item represents it, how many Pokemon to award, whether to broadcast, what animation to play, and any console commands to run when opened. The `pokemon:` section is a **weighted table**: every entry has a `chance` value. When a player opens a booster, the mod rolls from that table `pokemon-amount` times. If an entry is selected, the mod builds a Pokemon from that entry’s constraints: forms/palettes (if any are added), a rolled **level** between `min..max`, a **nature** chosen according to the entry’s `natures` weights, and **IV/EV** values rolled within the per-stat min/max ranges (with EV totals auto-scaled to respect Pixelmon’s 510 cap).\
\
Creating a new pack is as simple as copying an existing `.yml`, changing the header fields, and editing the `pokemon:` list. Add or remove entries, tweak each entry’s `chance`, define level ranges, add `natures` maps, and tune IV/EV min/max ranges per stat to fit your theme. You can optionally set `palette` and `form` as a map of weights (e.g., `{ base: 90, shiny: 10 }`) or leave them empty to allow any default appearance.\
\
Place all pack files in `config/unbox/packs/`. On server start (or after `/unbox reloadpacks`), the mod loads every `.yml` file in that folder. To give a booster, run `/unbox givepack <player> <packId> <count>` where `<packId>` is the filename **without** `.yml` (example would be `bug`). Players right-click the booster item to open it the mod cancels block placement for that item, plays the configured animation, and awards the rolled Pokémon to the player’s party (or PC if the party is full). You can review raw entry weights and calculated appearance odds in-game via your `/unbox` helper commands.\
\
For broadcasting you can use {player} as the placeholder that will be replaced by the players name and {pokemon} which will be replaced by the pokemon(s) the player wins

```
name: "&#34D399:#FDE047 Bug Booster" # Display name shown on the booster item; supports hex (&#RRGGBB) gradients and legacy & codes via ColorTranslator.
lore: "ADE80:#FCD34D Nature’s industrious luck." # Single-line lore (tooltip) for the booster item; also supports gradients/codes.
item: "minecraft:carrot_on_a_stick" # The Minecraft item used as the booster (what players hold/right-click).
pokemon-amount: 3 # How many Pokémon are rolled and granted when this booster is opened.
broadcast: true # If true, send a serverwide message when a player opens this booster.
broadcast-message: "&a{player} &7opened a &aBug Booster&7 and pulled &a{pokemon}&7!" # Broadcast template; {player} and {pokemon} placeholders are replaced at payout.
animation: "giftribbon" # Animation key to play during opening; must match a registered animation id.
permission: "none" # Optional permission string required to open this pack; "none" disables the check.
on-open-commands: [] # Optional server console commands to run on open; supports {player}. Empty list here.

pokemon: # Start of the weighted Pokémon entry list for this pack.
  - id: 0 # Unique entry id within this file (used for debugging and commands).
    pokemon: "Caterpie" # Species name (Pixelmon species id / display name).
    chance: 14 # Weight of this entry when rolling (relative to other entries in this pack).
    palette: {} # Optional weighted palettes empty map = no forced palette.
    form: [] # Optional weighted forms empty list = no forced form.
    level: # Optional level range to roll for the awarded Pokémon.
      min: 5 # Minimum level (inclusive) for this entry.
      max: 18 # Maximum level (inclusive) for this entry.
    natures: # Optional weighted natures for this entry keys are nature names, values are weights.
      Serious: 20 # Nature weight higher means more likely when this entry is rolled.
      Hardy: 20 # Nature weight ties distribute evenly relative to other weights in this map.
      Docile: 20 # Nature weight.
      Bashful: 20 # Nature weight.
      Quirky: 20 # Nature weight.
    iv-hp-min: 18 # Minimum HP IV (0–31) RewardBuilder clamps if out of bounds.
    iv-hp-max: 31 # Maximum HP IV (0–31).
    iv-attack-min: 18 # Minimum Attack IV (0–31).
    iv-attack-max: 31 # Maximum Attack IV (0–31).
    iv-defense-min: 18 # Minimum Defense IV (0–31).
    iv-defense-max: 31 # Maximum Defense IV (0–31).
    iv-spattack-min: 18 # Minimum Special Attack IV (0–31).
    iv-spattack-max: 31 # Maximum Special Attack IV (0–31).
    iv-spdefense-min: 18 # Minimum Special Defense IV (0–31).
    iv-spdefense-max: 31 # Maximum Special Defense IV (0–31).
    iv-speed-min: 18 # Minimum Speed IV (0–31).
    iv-speed-max: 31 # Maximum Speed IV (0–31).
    ev-hp-min: 0 # Minimum HP EV (0–252) total EVs across stats capped to 510 during payout.
    ev-hp-max: 140 # Maximum HP EV (0–252).
    ev-attack-min: 0 # Minimum Attack EV (0–252).
    ev-attack-max: 140 # Maximum Attack EV (0–252).
    ev-defense-min: 0 # Minimum Defense EV (0–252).
    ev-defense-max: 140 # Maximum Defense EV (0–252).
    ev-spattack-min: 0 # Minimum Special Attack EV (0–252).
    ev-spattack-max: 140 # Maximum Special Attack EV (0–252).
    ev-spdefense-min: 80 # Minimum Special Defense EV (0–252).
    ev-spdefense-max: 160 # Maximum Special Defense EV (0–252).
    ev-speed-min: 80 # Minimum Speed EV (0–252).
    ev-speed-max: 160 # Maximum Speed EV (0–252).
  - id: 1 # Entry id 1.
    pokemon: "Weedle" # Species.
    chance: 14 # Weight for this entry.
    palette: {} # No palette bias.
    form: [] # No form bias.
    level: # Level range for Weedle.
      min: 5 # Level floor.
      max: 18 # Level ceiling.
    natures: # Weighted nature pool for Weedle.
      Serious: 20 # Nature weight.
      Hardy: 20 # Nature weight.
      Docile: 20 # Nature weight.
      Bashful: 20 # Nature weight.
      Quirky: 20 # Nature weight.
    iv-hp-min: 18 # Min HP IV.
    iv-hp-max: 31 # Max HP IV.
    iv-attack-min: 18 # Min Atk IV.
    iv-attack-max: 31 # Max Atk IV.
    iv-defense-min: 18 # Min Def IV.
    iv-defense-max: 31 # Max Def IV.
    iv-spattack-min: 18 # Min SpA IV.
    iv-spattack-max: 31 # Max SpA IV.
    iv-spdefense-min: 18 # Min SpD IV.
    iv-spdefense-max: 31 # Max SpD IV.
    iv-speed-min: 18 # Min Spe IV.
    iv-speed-max: 31 # Max Spe IV.
    ev-hp-min: 0 # Min HP EV.
    ev-hp-max: 140 # Max HP EV.
    ev-attack-min: 0 # Min Atk EV.
    ev-attack-max: 140 # Max Atk EV.
    ev-defense-min: 0 # Min Def EV.
    ev-defense-max: 140 # Max Def EV.
    ev-spattack-min: 0 # Min SpA EV.
    ev-spattack-max: 140 # Max SpA EV.
    ev-spdefense-min: 80 # Min SpD EV.
    ev-spdefense-max: 160 # Max SpD EV.
    ev-speed-min: 80 # Min Spe EV.
    ev-speed-max: 160 # Max Spe EV.
  - id: 2 # Entry id 2.
    pokemon: "Paras" # Species.
    chance: 9 # Weight for this entry.
    palette: {} # No palette bias.
    form: [] # No form bias.
    level: # Level range for Paras.
      min: 5 # Min level.
      max: 20 # Max level.
    natures: # Offensive-leaning nature pool.
      Adamant: 40 # Favored nature weight.
      Jolly: 30 # Favored nature weight.
      Brave: 10 # Minor option.
      Naughty: 10 # Minor option.
      Lonely: 10 # Minor option.
    iv-hp-min: 18 # Min HP IV.
    iv-hp-max: 31 # Max HP IV.
    iv-attack-min: 18 # Min Atk IV.
    iv-attack-max: 31 # Max Atk IV.
    iv-defense-min: 18 # Min Def IV.
    iv-defense-max: 31 # Max Def IV.
    iv-spattack-min: 18 # Min SpA IV.
    iv-spattack-max: 31 # Max SpA IV.
    iv-spdefense-min: 18 # Min SpD IV.
    iv-spdefense-max: 31 # Max SpD IV.
    iv-speed-min: 18 # Min Spe IV.
    iv-speed-max: 31 # Max Spe IV.
    ev-hp-min: 0 # Min HP EV.
    ev-hp-max: 140 # Max HP EV.
    ev-attack-min: 80 # Min Atk EV (offense bias).
    ev-attack-max: 160 # Max Atk EV.
    ev-defense-min: 0 # Min Def EV.
    ev-defense-max: 140 # Max Def EV.
    ev-spattack-min: 0 # Min SpA EV.
    ev-spattack-max: 140 # Max SpA EV.
    ev-spdefense-min: 80 # Min SpD EV.
    ev-spdefense-max: 160 # Max SpD EV.
    ev-speed-min: 0 # Min Spe EV.
    ev-speed-max: 140 # Max Spe EV.
  - id: 3 # Entry id 3.
    pokemon: "Venonat" # Species.
    chance: 8 # Weight for this entry.
    palette: {} # No palette bias.
    form: [] # No form bias.
    level: # Level range for Venonat.
      min: 8 # Min level.
      max: 22 # Max level.
    natures: # Special-attack leaning natures.
      Modest: 40 # Favored nature weight.
      Timid: 30 # Favored nature weight.
      Quiet: 10 # Minor option.
      Mild: 10 # Minor option.
      Rash: 10 # Minor option.
    iv-hp-min: 18 # Min HP IV.
    iv-hp-max: 31 # Max HP IV.
    iv-attack-min: 18 # Min Atk IV.
    iv-attack-max: 31 # Max Atk IV.
    iv-defense-min: 18 # Min Def IV.
    iv-defense-max: 31 # Max Def IV.
    iv-spattack-min: 18 # Min SpA IV.
    iv-spattack-max: 31 # Max SpA IV.
    iv-spdefense-min: 18 # Min SpD IV.
    iv-spdefense-max: 31 # Max SpD IV.
    iv-speed-min: 18 # Min Spe IV.
    iv-speed-max: 31 # Max Spe IV.
    ev-hp-min: 0 # Min HP EV.
    ev-hp-max: 140 # Max HP EV.
    ev-attack-min: 0 # Min Atk EV.
    ev-attack-max: 140 # Max Atk EV.
    ev-defense-min: 0 # Min Def EV.
    ev-defense-max: 140 # Max Def EV.
    ev-spattack-min: 80 # Min SpA EV (special bias).
    ev-spattack-max: 160 # Max SpA EV.
    ev-spdefense-min: 80 # Min SpD EV (bulk bias).
    ev-spdefense-max: 160 # Max SpD EV.
    ev-speed-min: 0 # Min Spe EV.
    ev-speed-max: 140 # Max Spe EV.
  - id: 4 # Entry id 4.
    pokemon: "Scyther" # Species.
    chance: 4 # Weight for this (rarer) entry.
    palette: {} # No palette bias.
    form: [] # No form bias.
    level: # Level range for Scyther.
      min: 20 # Min level.
      max: 36 # Max level.
    natures: # Speed/Attack leaning natures.
      Jolly: 45 # Favored nature weight.
      Adamant: 25 # Favored nature weight.
      Hasty: 15 # Minor option.
      Naive: 15 # Minor option.
    iv-hp-min: 18 # Min HP IV.
    iv-hp-max: 31 # Max HP IV.
    iv-attack-min: 22 # Min Atk IV (raised floor to favor offense).
    iv-attack-max: 31 # Max Atk IV.
    iv-defense-min: 18 # Min Def IV.
    iv-defense-max: 31 # Max Def IV.
    iv-spattack-min: 18 # Min SpA IV.
    iv-spattack-max: 31 # Max SpA IV.
    iv-spdefense-min: 18 # Min SpD IV.
    iv-spdefense-max: 31 # Max SpD IV.
    iv-speed-min: 20 # Min Spe IV (raised floor to favor speed).
    iv-speed-max: 31 # Max Spe IV.
    ev-hp-min: 0 # Min HP EV.
    ev-hp-max: 140 # Max HP EV.
    ev-attack-min: 120 # Min Atk EV (strong offense bias).
    ev-attack-max: 220 # Max Atk EV.
    ev-defense-min: 0 # Min Def EV.
    ev-defense-max: 140 # Max Def EV.
    ev-spattack-min: 0 # Min SpA EV.
    ev-spattack-max: 140 # Max SpA EV.
    ev-spdefense-min: 0 # Min SpD EV.
    ev-spdefense-max: 140 # Max SpD EV.
    ev-speed-min: 100 # Min Spe EV (speed bias).
    ev-speed-max: 200 # Max Spe EV.
  - id: 5 # Entry id 5.
    pokemon: "Shuckle" # Species.
    chance: 2 # Weight for this rare, tanky entry.
    palette: {} # No palette bias.
    form: [] # No form bias.
    level: # Level range for Shuckle.
      min: 20 # Min level.
      max: 36 # Max level.
    natures: # Defensive nature pool.
      Impish: 30 # Favored nature weight.
      Bold: 30 # Favored nature weight.
      Careful: 20 # Minor option.
      Calm: 20 # Minor option.
    iv-hp-min: 18 # Min HP IV.
    iv-hp-max: 31 # Max HP IV.
    iv-attack-min: 18 # Min Atk IV.
    iv-attack-max: 31 # Max Atk IV.
    iv-defense-min: 18 # Min Def IV.
    iv-defense-max: 31 # Max Def IV.
    iv-spattack-min: 18 # Min SpA IV.
    iv-spattack-max: 31 # Max SpA IV.
    iv-spdefense-min: 22 # Min SpD IV (raised floor to favor bulk).
    iv-spdefense-max: 31 # Max SpD IV.
    iv-speed-min: 18 # Min Spe IV.
    iv-speed-max: 31 # Max Spe IV.
    ev-hp-min: 80 # Min HP EV (bulk bias).
    ev-hp-max: 160 # Max HP EV.
    ev-attack-min: 0 # Min Atk EV.
    ev-attack-max: 140 # Max Atk EV.
    ev-defense-min: 0 # Min Def EV.
    ev-defense-max: 140 # Max Def EV.
    ev-spattack-min: 0 # Min SpA EV.
    ev-spattack-max: 140 # Max SpA EV.
    ev-spdefense-min: 120 # Min SpD EV (heavy bulk).
    ev-spdefense-max: 220 # Max SpD EV.
    ev-speed-min: 0 # Min Spe EV.
    ev-speed-max: 140 # Max Spe EV.
  - id: 6 # Entry id 6.
    pokemon: "Wurmple" # Species.
    chance: 10 # Weight for this entry.
    palette: {} # No palette bias.
    form: [] # No form bias.
    level: # Level range for Wurmple.
      min: 5 # Min level.
      max: 18 # Max level.
    natures: # Neutral nature pool.
      Serious: 20 # Nature weight.
      Hardy: 20 # Nature weight.
      Docile: 20 # Nature weight.
      Bashful: 20 # Nature weight.
      Quirky: 20 # Nature weight.
    iv-hp-min: 18 # Min HP IV.
    iv-hp-max: 31 # Max HP IV.
    iv-attack-min: 18 # Min Atk IV.
    iv-attack-max: 31 # Max Atk IV.
    iv-defense-min: 18 # Min Def IV.
    iv-defense-max: 31 # Max Def IV.
    iv-spattack-min: 18 # Min SpA IV.
    iv-spattack-max: 31 # Max SpA IV.
    iv-spdefense-min: 18 # Min SpD IV.
    iv-spdefense-max: 31 # Max SpD IV.
    iv-speed-min: 18 # Min Spe IV.
    iv-speed-max: 31 # Max Spe IV.
    ev-hp-min: 0 # Min HP EV.
    ev-hp-max: 140 # Max HP EV.
    ev-attack-min: 60 # Min Atk EV (balanced lite).
    ev-attack-max: 120 # Max Atk EV.
    ev-defense-min: 0 # Min Def EV.
    ev-defense-max: 140 # Max Def EV.
    ev-spattack-min: 60 # Min SpA EV (balanced lite).
    ev-spattack-max: 120 # Max SpA EV.
    ev-spdefense-min: 0 # Min SpD EV.
    ev-spdefense-max: 140 # Max SpD EV.
    ev-speed-min: 60 # Min Spe EV (balanced lite).
    ev-speed-max: 120 # Max Spe EV.
  - id: 7 # Entry id 7.
    pokemon: "Nincada" # Species.
    chance: 8 # Weight for this entry.
    palette: {} # No palette bias.
    form: [] # No form bias.
    level: # Level range for Nincada.
      min: 6 # Min level.
      max: 20 # Max level.
    natures: # Defensive/utility natures.
      Impish: 30 # Favored nature weight.
      Bold: 30 # Favored nature weight.
      Careful: 20 # Minor option.
      Calm: 20 # Minor option.
    iv-hp-min: 18 # Min HP IV.
    iv-hp-max: 31 # Max HP IV.
    iv-attack-min: 18 # Min Atk IV.
    iv-attack-max: 31 # Max Atk IV.
    iv-defense-min: 18 # Min Def IV.
    iv-defense-max: 31 # Max Def IV.
    iv-spattack-min: 18 # Min SpA IV.
    iv-spattack-max: 31 # Max SpA IV.
    iv-spdefense-min: 20 # Min SpD IV (slight bulk bias).
    iv-spdefense-max: 31 # Max SpD IV.
    iv-speed-min: 18 # Min Spe IV.
    iv-speed-max: 31 # Max Spe IV.
    ev-hp-min: 0 # Min HP EV.
    ev-hp-max: 140 # Max HP EV.
    ev-attack-min: 0 # Min Atk EV.
    ev-attack-max: 140 # Max Atk EV.
    ev-defense-min: 0 # Min Def EV.
    ev-defense-max: 140 # Max Def EV.
    ev-spattack-min: 0 # Min SpA EV.
    ev-spattack-max: 140 # Max SpA EV.
    ev-spdefense-min: 100 # Min SpD EV (bulk).
    ev-spdefense-max: 200 # Max SpD EV.
    ev-speed-min: 80 # Min Spe EV (utility speed).
    ev-speed-max: 160 # Max Spe EV.
  - id: 8 # Entry id 8.
    pokemon: "Surskit" # Species.
    chance: 7.5 # Weight for this entry.
    palette: {} # No palette bias.
    form: [] # No form bias.
    level: # Level range for Surskit.
      min: 6 # Min level.
      max: 20 # Max level.
    natures: # Fast special attacker natures.
      Timid: 45 # Favored nature weight.
      Modest: 25 # Favored nature weight.
      Hasty: 15 # Minor option.
      Naive: 15 # Minor option.
    iv-hp-min: 18 # Min HP IV.
    iv-hp-max: 31 # Max HP IV.
    iv-attack-min: 18 # Min Atk IV.
    iv-attack-max: 31 # Max Atk IV.
    iv-defense-min: 18 # Min Def IV.
    iv-defense-max: 31 # Max Def IV.
    iv-spattack-min: 18 # Min SpA IV.
    iv-spattack-max: 31 # Max SpA IV.
    iv-spdefense-min: 18 # Min SpD IV.
    iv-spdefense-max: 31 # Max SpD IV.
    iv-speed-min: 20 # Min Spe IV (speed bias).
    iv-speed-max: 31 # Max Spe IV.
    ev-hp-min: 0 # Min HP EV.
    ev-hp-max: 140 # Max HP EV.
    ev-attack-min: 0 # Min Atk EV.
    ev-attack-max: 140 # Max Atk EV.
    ev-defense-min: 0 # Min Def EV.
    ev-defense-max: 140 # Max Def EV.
    ev-spattack-min: 80 # Min SpA EV (special bias).
    ev-spattack-max: 160 # Max SpA EV.
    ev-spdefense-min: 0 # Min SpD EV.
    ev-spdefense-max: 140 # Max SpD EV.
    ev-speed-min: 100 # Min Spe EV (fast bias).
    ev-speed-max: 200 # Max Spe EV.
  - id: 9 # Entry id 9.
    pokemon: "Joltik" # Species.
    chance: 6 # Weight for this entry.
    palette: {} # No palette bias.
    form: [] # No form bias.
    level: # Level range for Joltik.
      min: 10 # Min level.
      max: 24 # Max level.
    natures: # Fast special attacker natures.
      Timid: 45 # Favored nature weight.
      Modest: 25 # Favored nature weight.
      Hasty: 15 # Minor option.
      Naive: 15 # Minor option.
    iv-hp-min: 18 # Min HP IV.
    iv-hp-max: 31 # Max HP IV.
    iv-attack-min: 18 # Min Atk IV.
    iv-attack-max: 31 # Max Atk IV.
    iv-defense-min: 18 # Min Def IV.
    iv-defense-max: 31 # Max Def IV.
    iv-spattack-min: 20 # Min SpA IV (raised floor).
    iv-spattack-max: 31 # Max SpA IV.
    iv-spdefense-min: 18 # Min SpD IV.
    iv-spdefense-max: 31 # Max SpD IV.
    iv-speed-min: 20 # Min Spe IV (raised floor).
    iv-speed-max: 31 # Max Spe IV.
    ev-hp-min: 0 # Min HP EV.
    ev-hp-max: 140 # Max HP EV.
    ev-attack-min: 0 # Min Atk EV.
    ev-attack-max: 140 # Max Atk EV.
    ev-defense-min: 0 # Min Def EV.
    ev-defense-max: 140 # Max Def EV.
    ev-spattack-min: 100 # Min SpA EV (strong special bias).
    ev-spattack-max: 200 # Max SpA EV.
    ev-spdefense-min: 0 # Min SpD EV.
    ev-spdefense-max: 140 # Max SpD EV.
    ev-speed-min: 100 # Min Spe EV (fast bias).
    ev-speed-max: 200 # Max Spe EV.
  - id: 10 # Entry id 10 (legendary/mythic tier).
    pokemon: "Genesect" # Species.
    chance: 0.2 # Very low weight to keep it rare.
    palette: {} # No palette bias.
    form: [] # No form bias.
    level: # High-level range for Genesect.
      min: 70 # Min level.
      max: 80 # Max level.
    natures: # Mixed but biased toward speed/special/physical.
      Timid: 25 # Nature weight.
      Modest: 20 # Nature weight.
      Jolly: 20 # Nature weight.
      Adamant: 15 # Nature weight.
      Calm: 10 # Nature weight.
      Bold: 10 # Nature weight.
    iv-hp-min: 28 # Raised IV floor for legendary quality.
    iv-hp-max: 31 # Max HP IV.
    iv-attack-min: 28 # Raised Atk IV floor.
    iv-attack-max: 31 # Max Atk IV.
    iv-defense-min: 28 # Raised Def IV floor.
    iv-defense-max: 31 # Max Def IV.
    iv-spattack-min: 28 # Raised SpA IV floor.
    iv-spattack-max: 31 # Max SpA IV.
    iv-spdefense-min: 28 # Raised SpD IV floor.
    iv-spdefense-max: 31 # Max SpD IV.
    iv-speed-min: 28 # Raised Spe IV floor.
    iv-speed-max: 31 # Max Spe IV.
    ev-hp-min: 120 # Balanced EV spread minimums for legends.
    ev-hp-max: 200 # Balanced EV spread maximums.
    ev-attack-min: 80 # Min Atk EV.
    ev-attack-max: 160 # Max Atk EV.
    ev-defense-min: 80 # Min Def EV.
    ev-defense-max: 160 # Max Def EV.
    ev-spattack-min: 80 # Min SpA EV.
    ev-spattack-max: 160 # Max SpA EV.
    ev-spdefense-min: 80 # Min SpD EV.
    ev-spdefense-max: 160 # Max SpD EV.
    ev-speed-min: 80 # Min Spe EV.
    ev-speed-max: 160 # Max Spe EV.

```


---

# 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, and the optional `goal` query parameter:

```
GET https://unbox-1.gitbook.io/unbox/configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.