Rules: Capturing Pokemon

Section 2.F

These are rules related to capturing wild Pokemon.

"alwaysCapture"

This rule allows you to adjust the capture chance of any Poke Ball used in this battle so that they always succeed, regardless of normal capture chances.

This is entered as setBattleRule("alwaysCapture")

"neverCapture"

This rule allows you to adjust the capture chance of any Poke Ball used in this battle so that they always fail, regardless of normal capture chances. This rule will even cause Master Balls to fail.

This is entered as setBattleRule("neverCapture")

"tutorialCapture"

This rule makes it so that this battle is considered a tutorial battle, which means that any Pokemon captured in this battle are not kept by the player, nor are they recorded in the Pokedex.

This is entered as setBattleRule("tutorialCapture")

"raidStyleCapture"

This rule emulates how capturing raid Pokemon works. While this rule is active, wild Pokemon will not faint when their HP reaches zero. Instead, you will be prompted to throw a ball to capture them. If you choose not to, or if the Poke Ball fails to capture them, they will flee to end the battle. This is entered as setBattleRule("raidStyleCapture", true), but you may further customize this if you wish by entering a hash instead of true as the second argument. In this hash, you can customize how you want this raid-style capture to behave by setting one or more of these keys:

• :capture_chance This replaces the natural capture chance of the selected Poke Ball with one that you manually input here. For example, if you set this to 25, then any thrown Poke Ball during this capture sequence will have a 25% capture chance, regardless of what the normal capture chance would be. Master Balls ignore this setting. If not set, then the normal capture rate is used.

  Example: setBattleRule("raidStyleCapture", { :capture_chance => 25 }) WildBattle.start(:ABRA, 20)

• :flee_msg This allows you to set a custom message that should display if the wild Pokemon isn't captured by the player, and instead flees. You can use {1} to refer to the name of the wild Pokemon. If not set, the default message ("The wild ___ fled") will be displayed. Example: setBattleRule("raidStyleCapture", { :capture_chance => 25, :flee_msg => "{1} quickly escaped in the blink of an eye!" }) WildBattle.start(:ABRA, 20)

• :capture_bgm This sets up custom music that should begin to play when the player is prompted to capture the wild Pokemon. If no BGM file is entered here, the normal battle music will continue to play as it usually would. Example: setBattleRule("raidStyleCapture", { :capture_chance => 25, :capture_bgm => "Raid capture music", :flee_msg => "{1} quickly escaped in the blink of an eye!" }) WildBattle.start(:ABRA, 20)