Skip to content

Scripting [Pre 0.10.0]

necro50n3 edited this page Apr 2, 2026 · 1 revision

Scripts

When creating a raid boss, you can define scripts, which are actions that the raid boss will do at a certain point in the battle, making the boss fight even harder.

Adding Scripts

Scripts are defined using a map which defines the trigger and then an action or list of actions.

{
  "trigger1": "ACTION1",
  "trigger2": ["ACTION2", "ACTION3"]
}

Triggers

Scripts can be triggered with the following keys:

  • "turn:X": The action is triggered on turn X.
  • "hp:0.X": The action is triggered when the boss reaches X0% HP.
  • "after:X": The action is triggered once after X seconds.
  • "repeat:X": The action is triggered every X seconds.
  • "faint:X": The action is triggered when a player faints, up to X times (or set to -1 for no limit).

Actions

  • RESET_BOSS: Resets any stat drops from the raid boss.
  • RESET_PLAYER: Resets any stat boosts from players.
  • BOSS_STAT_X: Raises the raid boss's STAT by X stages. Only supports 1 or 2 stages.
    • STAT: ATK / DEF / SPA / SPD / SPE / ACC / EVA
    • X: Any number between -6 and 6
  • PLAYER_STAT_X: Same as BOSS_STAT_X except it lowers the players' STAT by X stages.
  • SET_X: Sets the weather for 5 turns.
    • X: RAIN / SANDSTORM / SNOW / SUN
  • SET_X_TERRAIN: Sets the terrain for 5 turns.
    • X: ELECTRIC / GRASSY / MISTY / PSYCHIC
  • USE_MOVE_M_X: Forces the raid boss to use a specific move.
    • M: The specific move as one word, i.e. "SWORDSDANCE".
    • X: The target of the move. Set as 1 for the player or 2 for the raid boss itself.
  • SHIELD_UP: Gives the boss a special shield which increases its Def and SpD by 50% and makes it immune to status effects.
  • SHIELD_DOWN: Breaks the boss's shield.
  • TIMER_X: Sets a raid timer that will fail the raid when it reaches zero.
    • X: The time (in seconds) the timer should last for.
  • REDUCE_TIMER_0.X: Reduce the raid timer.
    • X: The proportion of the max timer to reduce by.
  • HEAL_0.X: Heal the raid boss.
    • X: The proportion of the raid boss's max hp to be healed.
  • CATCH_RATE_M_X: Modify the catch rate of the raid boss for a specific player.
    • M: ADD / MULTIPLY
    • X: Adds the percentage if M is ADD or multiplies if M is MULTIPLY

Clone this wiki locally