> 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/invader-configs.md). # Invader Configs Invader Configurations Below you can see the advanced way to create Invaders and how each setting works. Invaders are high-stakes world bosses that bring server-wide consequences if ignored. Invader configs are stored in config/titans/invaders/ and use a structure similar to standard bosses but with many more advanced features. ## Divine Invader Configuration Guide This page explains the main configuration options used for **Divine Invader** bosses in the Titans mod. Divine Invaders are powerful server-wide boss events that can punish the entire server if they are not defeated, or reward the server with a temporary blessing if players win. *** ### Core Punishment Settings | Option | Description | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `thresholdPercent` | The HP percentage threshold used when the boss despawns. If the boss despawns and its HP is above this percentage, the server-wide punishment triggers. | | `durationMinutes` | How long the punishment or blessing lasts, measured in minutes. | | `activePunishments` | A list of punishments that activate when the server fails to defeat the boss. | #### Available Punishments | Punishment | Effect | | ----------------------- | ------------------------------------------------- | | `LOWERED_SELL_PRICES` | Reduces sell prices during the punishment period. | | `NO_SHINY_SPAWNS` | Prevents shiny Pokémon from spawning. | | `NO_LEGENDARY_SPAWNS` | Prevents legendary Pokémon from spawning. | | `INCREASED_SHOP_PRICES` | Increases prices in shops. | | `REDUCED_EXP_GAIN` | Reduces EXP gained by players. | | `NO_MOUNT_FLYING` | Prevents players from flying on mounts. | | `GLOBAL_AGGRESSION` | Makes wild Pokémon more aggressive. | | `TRADE_TAX` | Applies a tax to currency trades between players. | *** ### Multiplier Settings These settings control how strongly punishments or blessings affect the server. | Option | Description | | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | `sellPriceMultiplier` | Multiplier applied to sell prices. | | `expMultiplier` | Multiplier applied to EXP gain. | | `legendarySpawnMultiplier` | Multiplier applied to legendary spawn rates. | | `shinySpawnMultiplier` | Multiplier applied to shiny spawn rates. | | `shopPriceMultiplier` | Multiplier applied to shop prices. | | `catchRateMultiplier` | Multiplier applied to catch rates. | | `globalAggressionMultiplier` | Multiplier for how aggressive wild Pokémon become. For example, `5.0` means wild Pokémon are 5x more likely to initiate battle. | | `tradeTaxPercent` | Percentage tax taken from currency trades between players. | *** ### Defense Rewards `defenseRewards` controls the server-wide **Blessing** given if the Invader is defeated. These rewards can temporarily boost the entire server. | Option | Description | | ------------------------- | ------------------------------------------------------ | | `enabled` | Whether defense rewards are active for this boss. | | `expMultiplier` | Boosts EXP gain while the blessing is active. | | `shinySpawnMultiplier` | Boosts shiny spawn rates while the blessing is active. | | `hiddenAbilityMultiplier` | Boosts Hidden Ability chances. | | `evGainMultiplier` | Boosts EV gains. | *** ### Minions `minions` are reinforcement waves summoned by the boss during battle. Each minion wave can trigger when the boss reaches a certain HP percentage. | Option | Description | | -------------------- | ----------------------------------------------------- | | `hpThresholdPercent` | The boss HP percentage that triggers the minion wave. | | `species` | The Pokémon species summoned as minions. | | `count` | Number of minions spawned. | | `level` | Level of the summoned minions. | | `statsMultiplier` | Multiplier applied to the minions' stats. | | `palette` | Optional palette used by the minions. | | `form` | Optional form used by the minions. | *** ### Hazards `hazards` are area-of-effect debuffs emitted by the boss during the fight. | Option | Description | | ----------------- | ----------------------------------------- | | `type` | The hazard type. | | `radius` | How far the hazard reaches from the boss. | | `intervalSeconds` | How often the hazard pulses. | #### Available Hazard Types | Hazard | Effect | | --------------- | ------------------------------------------------------ | | `GRAVITY_WELL` | Prevents jumping and flying within the hazard radius. | | `ABYSSAL_PULSE` | Applies status effects to players or Pokémon in range. | *** ### Phases `phases` allow the boss to transform during battle. A phase can change the boss's form, palette, moves, stats, and announcement message. | Option | Description | | -------------------- | -------------------------------------------- | | `hpThresholdPercent` | The HP percentage that triggers this phase. | | `newForm` | Changes the boss's form. | | `newPalette` | Changes the boss's palette. | | `newMoves` | Replaces or updates the boss's move set. | | `statMultiplier` | Buffs the boss's stats during the new phase. | | `announcement` | Message broadcast when the phase activates. | *** ### Pylons `pylons` are protective structures, usually represented by End Crystals, that reduce incoming damage to the boss. | Option | Description | | ------------------------- | -------------------------------------------------------------------------------------------------------------- | | `enabled` | Whether pylons are active for this boss. | | `count` | Number of pylons spawned around the boss. | | `damageReductionPerPylon` | Percentage of damage reduced for each active pylon. For example, `0.2` means each pylon reduces damage by 20%. | *** ### Panic / Heat System `panic` controls the server-wide **Heat** system. Heat increases when players fail to defeat Invaders and can make future bosses stronger. | Option | Description | | ----------------------- | ------------------------------------------------------------------------------ | | `heatIncreaseOnFailure` | How much the global panic level increases if the boss is not defeated. | | `heatDecreaseOnSuccess` | How much the global panic level decreases when the boss is defeated. | | `scalesWithHeat` | If `true`, this boss becomes stronger based on the current global panic level. | *** ### Atmosphere `atmosphere` controls environmental changes while the boss is active. | Option | Description | | -------------- | -------------------------------------------------------------------------------------------- | | `weather` | Changes the weather while the boss is active. Available options: `RAIN`, `THUNDER`, `CLEAR`. | | `time` | Changes the time while the boss is active. Available options: `DAY`, `NIGHT`, `MIDNIGHT`. | | `spawnSound` | Sound played when the boss spawns. | | `victorySound` | Sound played when the boss is defeated. | | `failureSound` | Sound played when the boss despawns or players fail. | *** ## Example Configuration ```json { "name": "Divine Invader Rayquaza", "species": "rayquaza", "palette": "shiny", "bossStats": { "hp": 250000, "growth": 600, "level": 300, "moves": [ "Dragon Ascent", "V-create", "Draco Meteor", "Dragon Dance" ] }, "punishment": { "enabled": true, "thresholdPercent": 5, "durationMinutes": 120, "activePunishments": [ "NO_MOUNT_FLYING", "REDUCED_EXP_GAIN", "GLOBAL_AGGRESSION" ], "expMultiplier": 0.25, "globalAggressionMultiplier": 5.0 }, "defenseRewards": { "enabled": true, "expMultiplier": 5.0, "shinySpawnMultiplier": 10.0 }, "minions": [ { "hpThresholdPercent": 75, "species": "Bagon", "count": 5, "level": 100, "statsMultiplier": 2.0 } ], "hazards": [ { "type": "GRAVITY_WELL", "intervalSeconds": 45, "radius": 60.0 } ], "phases": [ { "hpThresholdPercent": 50, "newForm": "mega", "statMultiplier": 1.5, "announcement": "&d&lRayquaza has Mega Evolved!" } ], "pylons": { "enabled": true, "count": 4, "damageReductionPerPylon": 0.2 }, "panic": { "heatIncreaseOnFailure": 40, "heatDecreaseOnSuccess": 20 } } ``` --- # 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/invader-configs.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.