> For the complete documentation index, see [llms.txt](https://lucidious89-tutorials.gitbook.io/deluxe-battle-kit-tutorial/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lucidious89-tutorials.gitbook.io/deluxe-battle-kit-tutorial/deluxe-battle-kit-for-v21.1/example-battles/examples-wild-battles.md).

# Examples: Wild Battles

<mark style="background-color:red;">**Wild Battle Example # 1**</mark>

The example below demonstrates a 1v1 battle against a wild Deoxys. In this battle, the following rules are set:

* <mark style="background-color:green;">"cannotRun"</mark> is used to prevent the playing from fleeing.
* <mark style="background-color:green;">"disablePokeBalls"</mark> is used to prevent the player from manually throwing Poke Balls.
* <mark style="background-color:green;">"terrain"</mark> is used to set permanent Psychic terrain.
* <mark style="background-color:green;">"environ"</mark> is used to set the battle environment to :Space.
* <mark style="background-color:green;">"backdrop"</mark> and <mark style="background-color:green;">"base"</mark> are used to customize the battle backdrop and bases, respectively.
* <mark style="background-color:green;">"alwaysCapture"</mark> is used to ensure a 100% capture rate in this battle.
* <mark style="background-color:green;">"battleBGM"</mark> is used to set custom battle music.
* <mark style="background-color:green;">"battleIntroText"</mark> is used to set custom battle intro text.
* <mark style="background-color:green;">"editWildPokemon"</mark> is used to edit the following attributes of the wild Deoxys:
  * Name is set to "????" so that it may be "revealed" in battle.
  * Obtain location is set to "Outer Space."
  * Flagged as Super Shiny.
  * Given Pokerus.
  * HP Level set to 2, multiplying its natural HP 2x.
  * Given boss immunity to OHKO effects, effects that would force it to flee, and all forms of indirect damage.
* <mark style="background-color:green;">"midbattleScript"</mark> is used to set a script to use for this battle which does the following:
  * "Reveals" Deoxy's real name at the start of the battle.
  * Sets a damage cap for Deoxys so that it will survive with 1 HP regardless of damage taken.
  * At the end of each round, Deoxys will cycle to its next form and recover its HP/Status.
  * Whenever Deoxys takes damage from an attack, it recovers back a little HP.
  * When Deoxy's HP falls to 25% or lower, it stops regenerating HP.
  * When Deoxys reaches the set damage cap (1 HP) after its regeneration has ended, the player will automatically throw a Poke Ball to capture Deoxys. This capture is guaranteed thanks to the <mark style="background-color:green;">"alwaysCapture"</mark> rule.

```ruby
setBattleRule("cannotRun")
setBattleRule("disablePokeBalls")
setBattleRule("terrain", :Psychic)
setBattleRule("environ", :Space)
setBattleRule("backdrop", "elite4")
setBattleRule("base", "distortion")
setBattleRule("alwaysCapture")
setBattleRule("battleBGM", "Battle roaming")
setBattleRule("battleIntroText", "You encountered an alien invader!")
setBattleRule("editWildPokemon", {
  :name        => "????",
  :obtain_text => "Outer Space.",
  :super_shiny => true,
  :pokerus     => true,
  :hp_level    => 2,
  :immunities  => [:OHKO, :ESCAPE, :INDIRECT]
})
setBattleRule("midbattleScript", {
  "RoundStartCommand_1_foe" => {
    "text_A"       => "You used Prof. Pluto's Roto-Dex upgrade to identify the alien species!",
    "playSE"       => "PC access",
    "battlerName"  => "Deoxys",
    "battlerHPCap" => -1,
    "text_B"       => "The alien species was identified as Deoxys!"
  },
  "RoundEnd_foe_repeat" => {
    "playSE"        => "Anim/Sound2",
    "battlerForm"   => [:Cycle, "{1} suddenly mutated!"],
    "playCry"       => :Self,
    "battlerMoves"  => :Reset,
    "ignoreAfter"   => "TargetHPLow_foe",
    "battlerStatus" => [:NONE, true],
    "battlerHP"     => [4, "{1} regenerated some HP!"]
  },
  "TargetTookDamage_foe_repeat" => {
    "ignoreAfter" => "TargetHPLow_foe",
    "text"        => "{1} started to regenerate!",
    "battlerHP"   => [8, "{1} regenerated some HP!"]
  },
  "TargetHPLow_foe" => {
    "text" => "{1} has become too weak to regenerate any more HP!"
  },
  "BattlerReachedHPCap_foe" => {
    "speech"       => [:Opposing, "It's getting weak!\nIt's now or never!", "Go, Poké Ball!"],
    "disableBalls" => false,
    "useItem"      => :POKEBALL
  },
  "AfterCapture" => [0, "Phew...it's finally over.", "The professor would be proud."]
})
WildBattle.start(:DEOXYS, 50)
```

***

<mark style="background-color:red;">**Wild Battle Example # 2**</mark>

The example below demonstrates a double battle where the player and their partner May encounter a wild Latias and Latios. In this battle, the following rules are set:

* <mark style="background-color:green;">"cannotRun"</mark> is used to prevent the playing from fleeing.
* <mark style="background-color:green;">"weather"</mark> is used to set permanent Hail.
* <mark style="background-color:green;">"backdrop"</mark> is used to customize the battle backdrop and bases.
* <mark style="background-color:green;">"editWildPokemon"</mark> is used to edit the following attributes of the wild Latias:
  * Nature is set to Modest.
  * Given Soul Dew to hold.
  * Ability is set to Healer.
  * Given the moves Life Dew, Reflect, Helping Hand, and Psychic.
* <mark style="background-color:green;">"editWildPokemon2"</mark> is used to edit the following attributes of the wild Latios:
  * Nature is set to Adamant.
  * Given Soul Dew to hold.
  * Ability is set to Friend Guard.
  * Given the moves Dragon Dance, Breaking Swipe, Zen Headbutt, and Earthquake.
* <mark style="background-color:green;">"midbattleScript"</mark> is used to set a script to use for this battle which does the following:
  * When either Latios or Latias reach 25% HP or lower, they will call upon the other to heal them.
  * When either Latios or Latias faint, the remaining one will flee, ending the battle.

```ruby
setBattleRule("cannotRun")
setBattleRule("weather", :Hail)
setBattleRule("backdrop", "champion2")
setBattleRule("editWildPokemon", {
  :nature  => :MODEST,
  :item    => :SOULDEW,
  :ability => :HEALER,
  :moves   => [:LIFEDEW, :REFLECT, :HELPINGHAND, :PSYCHIC]
})
setBattleRule("editWildPokemon2", {
  :nature  => :ADAMANT,
  :item    => :SOULDEW,
  :ability => :FRIENDGUARD,
  :moves   => [:DRAGONDANCE, :BREAKINGSWIPE, :ZENHEADBUTT, :EARTHQUAKE]
})
setBattleRule("midbattleScript", {
  "TargetHPLow_foe_repeat" => {
    "text_A"    => "{1} calls out to its partner with a whimpering cry!",
    "playCry"   => :Self,
    "text_B"    => [:Ally, "{1} comes to its partner's aid!"],
    "battlerHP" => [4, "{1} restored a little HP!"]
  },
  "BattlerFainted_foe" => {
    "setBattler" => :Ally,
    "text"       => "{1} looks upset by its partner's defeat...\nIt lost the will to fight!",
    "wildFlee"   => true
  }
})
pbRegisterPartner(:POKEMONTRAINER_May, "May")
WildBattle.start(:LATIAS, 30, :LATIOS, 30)
```