> 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/boss-configurations.md).
# Boss Configurations
Once you run the mod a few examples will generate below is one of them and the most basic example as well as what the settings are and what they do
* **`name`**: The display name of the boss. Used in broadcasts, menus, and titles.
* **`maxPlayer`**: Maximum number of players that can join the fight. Extra players will be locked out once this number is reached.
* **`bossDespawn`**: Time (in minutes) before the boss automatically despawns if not defeated.
* **`form`**: Pixelmon form to use (e.g., “none”, “alola”, “galar”). Controls the variant of the species. (Custom forms of servers with datapacks work with this)
* **`palette`**: Determines the color scheme/skin of the boss (e.g., “shiny”, “normal”). (Custom palettes of servers with datapacks work with this)
* **`species`**: The Pixelmon species ID (e.g., `"togedemaru"`). Defines which Pokémon is used as the Titan.
* **`teleportable`**: Whether players can teleport to the boss using commands.
* **`teleportPos`**: The coordinates (`x`, `y`, `z`) and rotation (`yaw`, `pitch`) where players will be teleported if teleportation is enabled.
* **`playerJoinCooldown`**: The cooldown (in seconds) before the same player can re-join after leaving or being removed.
* **`maxJoinDistance`**: The maximum distance (in blocks) a player can be from the boss arena to join the fight.
* **`growth`**: Pixelmon growth size. Controls model scale.
* **`level`**: The level of the boss Pokémon.
* **`hp`**: Titan’s total shadow HP (custom health engine). This can go above Minecraft’s 1024 cap.
* **`attack` / `defence` / `specialAttack` / `specialDefence` / `speed`**: Base stat overrides for the Titan’s battle performance.
* **`ability`**: Ability assigned to the boss (e.g., `"Lightning Rod"`).
* **`shieldNumber`**: Number of shields that can appear during the fight.
* **`shieldRandom`**: If `true`, shield phases are randomized from the defined list.
* **`shields`**: A list of shield configurations:
* **`hpThreshold`**: % of HP when the shield activates.
* **`type`**: Elemental type of the shield (e.g., ELECTRIC, STEEL).
* **`multiplier`**: Damage reduction multiplier (e.g., `0.25` = 75% reduced damage).
* **`breakable`**: Whether the shield can be destroyed by dealing extra damage.
* **`shieldHp`** *(optional)*: Extra HP the shield must take before breaking (if breakable = true).
* **`moves`**: The boss’s custom moveset. Overrides normal level-up moves.
* **`kickOnDynamax`**: If `true`, players attempting to Dynamax during this fight will be kicked (only applies to Titan bosses).
Each reward has a **`condition`**, optional parameters, and a list of possible reward sets (with probabilities).
* **`LAST_HIT`**: Rewards the player who dealt the final blow.
* **`FIRST_HIT`**: Rewards the player who first hit the boss.
* **`TOP_DAMAGE`**: Rewards top X players by damage. `"rank": "1-3"` means the top 3.
* **`PARTICIPATION`**: Rewards all players who joined the fight.
* **`MIN_DAMAGE`**: Rewards players who dealt at least `threshold` damage.
* **`RANDOM_LUCK`**: A chance-based reward roll; probability is % chance to win.
Each reward entry has:
* **`probability`**: Chance (0–100) that the reward triggers.
* **`commands`**: List of commands executed by console, where `%player%` is replaced with the player’s name.
* **`banHeldItems`**: List of held items players cannot use in the fight.
* **`banAbilities`**: List of abilities that are disabled in the fight.
* **`banMoves`**: List of moves that cannot be used by player Pokémon against the boss.
* **`banPokemons`**: List of Pokémon species that cannot be used in the fight.
{
"name": "Togedemaru",
"maxPlayer": 30,
"bossDespawn": 30,
"form": "none",
"palette": "shiny",
"species": "togedemaru",
"teleportable": true,
"teleportPos": { "x": 246, "y": 63, "z": -1193, "yaw": 0, "pitch": 0 },
"playerJoinCooldown": 30,
"maxJoinDistance": 80,
"bossStats": {
"growth": 118,
"level": 101,
"hp": 6000,
"attack": 90,
"defence": 150,
"speed": 1,
"specialAttack": 120,
"specialDefence": 100,
"ability": "Lightning Rod",
"shieldNumber": 1,
"shieldRandom": true,
"shields": [
{ "hpThreshold": 75, "type": "ELECTRIC", "multiplier": 0.25, "breakable": false },
{ "hpThreshold": 30, "type": "STEEL", "multiplier": 0.10, "breakable": true, "shieldHp": 1000 }
],
"moves": [ "Spiky Shield", "Electric Terrain", "Discharge", "Thunder Shock", "Super Fang" ]
},
"kickOnDynamax": false,
"bossDefeatCommands": [ "msg @a boss defeated" ],
"rewardList": [
{
"condition": "LAST_HIT",
"rewards": [
{
"probability": 100.0,
"commands": [
"minecraft:give %player% pixelmon:xl_exp_candy 2",
"eco give %player% 5000"
]
}
]
},
{
"condition": "FIRST_HIT",
"rewards": [
{
"probability": 100.0,
"commands": [
"minecraft:give %player% pixelmon:rare_candy 1",
"eco give %player% 1000"
]
}
]
},
{
"condition": "TOP_DAMAGE",
"rank": "1-3",
"rewards": [
{
"probability": 100.0,
"commands": [
"minecraft:give %player% pixelmon:xl_exp_candy 3",
"eco give %player% 10000"
]
}
]
},
{
"condition": "PARTICIPATION",
"rewards": [
{
"probability": 100.0,
"commands": [
"minecraft:give %player% pixelmon:medium_exp_candy 1"
]
}
]
},
{
"condition": "MIN_DAMAGE",
"threshold": 1000,
"rewards": [
{
"probability": 100.0,
"commands": [
"eco give %player% 2500"
]
}
]
},
{
"condition": "RANDOM_LUCK",
"rewards": [
{
"probability": 10.0,
"commands": [
"pcrates givekey LegendaryCrate %player% 1"
]
}
]
}
],
"banHeldItems": [ "rocky_helmet" ],
"banAbilities": [ "Imposter", "Aftermath" ],
"banMoves": [ "Endeavor", "Pain Split", "Perish Song", "Infestation", "Nature's Madness", "Super Fang", "Sheer Cold", "Leech Seed", "Whirlpool", "Horn Drill", "Power Swap", "Guard Swap", "Spiky Shield", "Imprison", "Destiny Bond", "Poison Gas", "Roar", "Whirlwind", "Spore", "Stun Spore", "Toxic", "Yawn" ],
"banPokemons": [ "Rayquaza" ]
}
---
# 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/boss-configurations.md?ask=&goal=
```
`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.