Raid: Mid-Battle Scripting

Section 7.C.8

This plugin adds various new keys to be used by the Deluxe Battle Kit's mid-battle scripting functionality.

---

Trigger Keys

These are keys which trigger at various points of a raid battle, or when cheer commands are used.

• "BeforeCheer" Triggers before a trainer uses a cheer.

• "AfterCheer" Triggers after a trainer successfully used a cheer.

• "FailedCheer" Triggers after a trainer's cheer failed.

Trigger Extensions: You may extend these triggers with a cheer ID or species ID to specify that they should only trigger when a specific cheer was selected, or when the turn of a specific battler's species is used for the selected cheer. For example, "BeforeCheer_Healing" would trigger only when the "Heal up!" cheer was selected, where "AfterCheer_PIKACHU" would only trigger after a cheer was used on a Pikachu's turn.

• "CheerLevel" Triggers whenever a trainer's cheer level increases.

Trigger Extensions: You may extend this trigger with a number to specify that this should trigger only when a trainer's cheer level increases to a certain level. For example, "CheerLevel_3" would only trigger when a trainer's cheer level reaches level 3.

• "RaidShieldStart" Triggers whenever the raid Pokemon summons a raid shield.

• "RaidShieldDamaged" Triggers whenever the raid Pokemon's raid shield takes damage without breaking.

• "RaidShieldBroken" Triggers whenever the raid Pokemon's raid shield is broken.

Trigger Extensions: Since these keys can only ever trigger for the opponent, these are not compatible with "user" extensions, such as "_player" or "_foe".

---

Command Keys

These are keys which trigger certain actions related to raid battles, such as forcing a trainer to use a cheer, or changing certain raid elements such raid shields and counters.

"setCheerLv" ⇒ Integer

Changes a trainer's cheer level to a desired value. This is set as an integer ranging from 0-3. If this is set on the same turn that a trainer has selected to use a cheer (but prior to that cheer being used), the effects of their selected cheer will reflect their new cheer level.

"useCheer" ⇒ Symbol

Forces a battler's turn to be used by their trainer to use a particular cheer instead. This will override whatever the normally selected commands for that battler's turn would have otherwise been. This won't work if the battler has already moved on the turn this has been triggered, or before any commands have been selected.

This is entered as a particular cheer ID. For example, setting this to :Offense will register the "Go all-out!" cheer to be used.

If you enter an ID for a cheer that is not usable in this cheer mode, then the cheer for the current mode that shares the same command index will be used instead. For example, both the :MaxRaid and :TeraRaid cheers share the same cheer menu index (3), but are only usable in cheer modes 3 and 4, respectively. This means that if you try to set this command to :TeraRaid while in cheer mode 3 (a Max Raid battle), the trainer will not try to use the "Let's Terastallize!" cheer, but will instead try to use the "Let's Dynamax!" cheer.

"raidCounter" ⇒ Array

Changes the current value of one of the raid counters. This is set as an array, where the first value is either symbols :turn_count or :ko_count, depending on which counter you're attempting to change. The second value must be a positive or negative integer, depending on whether you want to add or subtract from the values of these respective counters.

"raidAction" ⇒ Symbol

Forces a raid Pokemon to perform a special raid action. This must be entered as one of the following symbols:

• :reset_drops Forces the raid Pokemon to unleash a wave of energy that negates any of its own stat drops, as well as curing any status conditions it may have.

• :reset_boosts Forces the raid Pokemon to unleash a wave of energy that suppresses the Abilities and negates any stat boosts for the Pokemon on your side of the field.

• :drain_cheer Forces the raid Pokemon to unleash a wave of energy that reduces the cheer level of all trainers by one.

Forcing one of these extra actions in this way will not consume the raid Pokemon's natural "once-per-battle" usage of these mechanics. So, they may still naturally use these at the appropriate times regardless of how many times you force them to occur through this manner.

"raidShield" ⇒ Integer

This can be used to give an opposing Pokemon a raid shield, or to alter the state of an existing one. Note that this can be done on any opponent, not just Raid Pokemon. So normal wild Pokemon or opposing trainer's Pokemon may be compatible with this.

When set to a positive number:

• Opponent doesn't have a shield: Grants a Raid shield with a number of bars equal to the inputted amount.

• Opponent already has a shield: Increases the amount of bars the shield has by the inputted amount.

When set to a negative number:

• Opponent doesn't have a shield: Nothing happens.

• Opponent already has a shield: Reduces the amount of bars the shield has by the inputted amount.