> 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/combat-mechanics.md). # Combat Mechanics ```` # Strategic Rules and Field Effects This page covers the advanced combat modifiers that can be applied to any **Titan** or **Invader**. These settings allow admins to create tactical boss fights that require more than just raw damage to win. --- # Strategy Rules **Strategy Rules** are battle restrictions that force players to adapt their teams before fighting a Titan or Invader. This system is useful for creating **Stadium Mode** style battles where team size, level, and Pokémon type restrictions matter. --- ## Strategy Rule Options | Option | Description | |---|---| | `maxPokemon` | Limits the number of Pokémon a player can bring into the fight. For example, `3` means the player can only use 3 Pokémon instead of a full team of 6. | | `maxLevel` | Automatically scales the player's Pokémon down to this level if they exceed it. | | `allowLegendaries` | If set to `false`, players cannot use legendary Pokémon against this boss. | --- ## Example Strategy Rules ```json "strategyRules": { "maxPokemon": 3, "maxLevel": 100, "allowLegendaries": false } ```` ### Example Breakdown | Setting | Value | Result | | ------------------ | ------- | ------------------------------------------------ | | `maxPokemon` | `3` | Players can only bring 3 Pokémon into the fight. | | `maxLevel` | `100` | Pokémon above level 100 are scaled down. | | `allowLegendaries` | `false` | Legendary Pokémon are banned from the battle. | {% hint style="warning" %}\ Strategy Rules are a powerful way to prevent players from brute-forcing bosses with oversized teams or overpowered legendary Pokémon.\ {% endhint %} *** ## Field Effects **Field Effects** are permanent battle modifiers that last for the entire boss fight. These effects can change weather, terrain, move interactions, and battle rules. *** ### Field Effect Options | Option | Description | | ------------ | --------------------------------------------------------------------------------------------------------------------------- | | `weather` | Forces a specific battle weather effect. | | `terrain` | Forces a specific battle terrain effect. | | `gravity` | If set to `true`, flying-type immunities are disabled and Ground-type moves can hit targets that would normally avoid them. | | `trickRoom` | Activates Trick Room for the duration of the fight. | | `magicRoom` | Activates Magic Room for the duration of the fight. | | `wonderRoom` | Activates Wonder Room for the duration of the fight. | *** ### Weather Options Common weather values include: | Weather | Effect | | ----------- | ----------------------------------------------------------------- | | `SUN` | Forces sunny weather. | | `RAIN` | Forces rain. | | `SANDSTORM` | Forces sandstorm. | | `HAIL` | Forces hail. | | `SNOW` | Forces snow, if supported by the server version or battle system. | | `CLEAR` | Clears active weather. | *** ### Terrain Options Common terrain values include: | Terrain | Effect | | ---------- | ------------------------ | | `ELECTRIC` | Forces Electric Terrain. | | `GRASSY` | Forces Grassy Terrain. | | `MISTY` | Forces Misty Terrain. | | `PSYCHIC` | Forces Psychic Terrain. | *** ### Room Effects | Room Effect | Description | | ------------ | ------------------------------------------------------------------ | | `trickRoom` | Reverses normal speed order, causing slower Pokémon to move first. | | `magicRoom` | Suppresses the effects of held items during battle. | | `wonderRoom` | Swaps Defense and Special Defense stats during battle. | *** ### Example Field Effects ``` "fieldEffects": { "weather": "RAIN", "terrain": "ELECTRIC", "gravity": true } ``` ### Example Breakdown | Setting | Value | Result | | --------- | ---------- | -------------------------------------------------------------------------- | | `weather` | `RAIN` | The battle is fought in rain. | | `terrain` | `ELECTRIC` | Electric Terrain is active. | | `gravity` | `true` | Flying immunities are disabled and Ground-type moves can hit more targets. | {% hint style="info" %}\ Field Effects are best used to make certain bosses feel unique. For example, a Kyogre Invader may force `RAIN`, while a cosmic Titan may activate `GRAVITY` or `TRICK_ROOM`.\ {% endhint %} *** ## World Corruption **World Corruption** creates a dangerous zone around the boss in the overworld. This makes the boss feel like it is affecting the world around it, not just the battle system. *** ### Corruption Options | Option | Description | | -------------- | ---------------------------------------------------------------- | | `enabled` | Whether the corruption zone is active. | | `radius` | Size of the corruption field around the boss. | | `particleType` | The Minecraft particle ID displayed inside the corruption field. | | `effectType` | Potion effect applied to players who enter the corruption zone. | *** ### Example Corruption ``` "corruption": { "enabled": true, "radius": 50.0, "particleType": "minecraft:ash", "effectType": "minecraft:slowness" } ``` ### Example Breakdown | Setting | Value | Result | | -------------- | -------------------- | -------------------------------------------------- | | `enabled` | `true` | The corruption zone is active. | | `radius` | `50.0` | The zone covers a 50-block radius around the boss. | | `particleType` | `minecraft:ash` | Ash particles appear in the corruption field. | | `effectType` | `minecraft:slowness` | Players inside the zone are slowed. | {% hint style="warning" %}\ Corruption effects can make the area around a boss dangerous even before the battle begins.\ {% endhint %} *** ## Cinematics **Cinematics** control custom audio and title cues for major boss lifecycle events. These are used to make Titans and Invaders feel more dramatic when they spawn or are defeated. *** ### Cinematic Options | Option | Description | | ------------ | --------------------------------------------- | | `enabled` | Whether cinematic effects are active. | | `introSound` | Sound played when the boss spawns. | | `introTitle` | Screen title shown when the boss spawns. | | `outroSound` | Sound played when the boss is defeated. | | `outroTitle` | Screen title shown when the boss is defeated. | *** ### Example Cinematics ``` "cinematics": { "enabled": true, "introSound": "minecraft:entity.ender_dragon.growl", "introTitle": "&c&lTHE TITAN AWAKENS" } ``` ### Example Breakdown | Setting | Value | Result | | ------------ | ------------------------------------- | -------------------------------------------------------- | | `enabled` | `true` | Cinematics are active. | | `introSound` | `minecraft:entity.ender_dragon.growl` | The Ender Dragon growl sound plays when the boss spawns. | | `introTitle` | `&c&lTHE TITAN AWAKENS` | A red bold title appears on players' screens. | *** ## Full Example Config ``` { "strategyRules": { "maxPokemon": 3, "maxLevel": 100, "allowLegendaries": false }, "fieldEffects": { "weather": "RAIN", "terrain": "ELECTRIC", "gravity": true }, "corruption": { "enabled": true, "radius": 50.0, "particleType": "minecraft:ash", "effectType": "minecraft:slowness" }, "cinematics": { "enabled": true, "introSound": "minecraft:entity.ender_dragon.growl", "introTitle": "&c&lTHE TITAN AWAKENS" } } ``` *** ## Full Example Breakdown This configuration creates a tactical Titan or Invader fight with strict team rules, permanent battlefield effects, an overworld corruption zone, and a dramatic spawn cinematic. *** ### Battle Restrictions | Rule | Value | Effect | | ------------------- | ------- | ---------------------------------------- | | Maximum Pokémon | `3` | Players may only bring 3 Pokémon. | | Maximum Level | `100` | Pokémon above level 100 are scaled down. | | Legendaries Allowed | `false` | Legendary Pokémon cannot be used. | *** ### Battle Field | Field Effect | Value | Effect | | ------------ | ---------- | ------------------------------- | | Weather | `RAIN` | The fight takes place in rain. | | Terrain | `ELECTRIC` | Electric Terrain is active. | | Gravity | `true` | Flying immunities are disabled. | *** ### Overworld Effects | Feature | Value | Effect | | ----------------- | -------------------- | ----------------------------------------- | | Corruption Radius | `50.0` | The boss corrupts a 50-block area. | | Particle | `minecraft:ash` | Ash particles appear around the boss. | | Player Effect | `minecraft:slowness` | Players inside the zone receive Slowness. | *** ### Spawn Cinematic When the boss appears: ``` &c&lTHE TITAN AWAKENS ``` The server also plays: ``` minecraft:entity.ender_dragon.growl ``` *** ## Recommended Usage Use these systems to create boss fights with unique identities. | Boss Style | Recommended Settings | | ------------------------ | ------------------------------------------------------------ | | Arena Challenge | Use `maxPokemon`, `maxLevel`, and `allowLegendaries`. | | Weather Boss | Use forced `weather`, such as `RAIN`, `SUN`, or `SANDSTORM`. | | Terrain Boss | Use forced `terrain`, such as `ELECTRIC` or `MISTY`. | | Gravity Boss | Enable `gravity` to remove flying immunities. | | Corrupted Overworld Boss | Enable `corruption` with particles and potion effects. | | Cinematic Boss | Enable `cinematics` with custom sounds and titles. | *** ## Quick Summary | System | Purpose | | --------------- | ----------------------------------------------------------------- | | `strategyRules` | Restricts player teams and battle eligibility. | | `fieldEffects` | Forces weather, terrain, gravity, and room effects during combat. | | `corruption` | Creates a dangerous overworld zone around the boss. | | `cinematics` | Adds custom sounds and titles when the boss spawns or dies. | --- # 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/combat-mechanics.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.