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

# Conditional Spawning

located in config/titans/conditions.yml\ <br>

```
conditions:
  - id: defeat_5_any
    type: DEFEAT
    target: ANY
    amount: 5
    chance: 100.0
    bosses:
      - boss: example_togedemaru
        chance: 100.0

  - id: capture_1_legendary
    type: CAPTURE
    target: LEGENDARY
    amount: 1
    chance: 100.0
    bosses:
      - boss: example_giratina
        chance: 100.0
```

#### Settings Explained

**id**\
A unique identifier for this condition. Used internally for tracking progress.

**type**\
Determines what kind of player event triggers the condition.\
Available options:

* `DEFEAT` → triggers when the player defeats a Pokémon in battle
* `CAPTURE` → triggers when the player catches a Pokémon
* `KILL` → triggers when the player kills a Pokémon (non-battle defeat)

**target**\
Specifies what kind of Pokémon counts toward the condition:

* `ANY` → any Pokémon
* `SPECIES` → specific Pokémon (e.g., `pikachu`)
* `TYPE` → Pokémon of a certain type (e.g., `FIRE`, `ELECTRIC`)
* `LEGENDARY` → any legendary Pokémon
* `BOSS` → any Titan boss

**type\_name** *(only for TYPE targets)*\
Specifies which Pokémon type to track (e.g., `FIRE`, `WATER`, `ELECTRIC`).

**species** *(only for SPECIES targets)*\
Specifies the exact Pokémon species name to track (e.g., `pikachu`, `giratina`).

**amount**\
How many times the condition must be fulfilled before it triggers.

**chance**\
The percentage chance (0–100) for the boss spawn to occur once the condition is met.\
For example, `50.0` = 50% chance to spawn a boss each time the condition is completed.

**bosses**\
A list of bosses that can spawn once the condition is satisfied.\
Each boss has its own individual spawn chance.


---

# 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://titans.gitbook.io/titans/conditional-spawning.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.