Battle Properties

You can set various properties of a battle when you call it to start, for both wild Pokémon battles and also trainer battles. The properties are listed below.

Types of Battle Properties

norun

norun

Cannot run from battle. This is default true of trainer battles so you only need to specify for wild battles.

nocatch

nocatch

Cannot catch the opposing Pokémon. This is default true of trainer battles so you only need to specify for wild battles.

nomoney

nomoney

No money earned from battle. This is default true of wild battles so you only need to specify for trainer battles.

noexp

noexp

No Pokémon experience gained during the battle.

noseen

noseen

Opposing Pokémon are not counted as seen in the Pokedex.

noitems

noitems

Cannot use items from the bag widget during battle, such as Poke Balls or Potions.

double

double

Changes battle format to a double battle.

triple

triple

Changes battle format to a triple battle.

hiddenlevel

hiddenlevel

Levels of the opposing Pokémon are hidden. Appear as ???.

fixedlevel

fixedlevel level

Forces all Pokémon in battle to the specified level. Uses their true stats (IVs, EVs) but calculates the actual stat value (attack, etc) based on the new set level. This works identically to fixed level battles such as the Battle Tower in the mainline games.

scene

scene id

Sets the battle scene (background image) to the one specified. Only necessary for wild battles, as trainer battles have a scene property set in advance.

theme

theme url

Sets the music playing during battle. Currently hosting on Dropbox is supported only. The format is db: for host, then a modified URL which cuts out the https://www.dropbox.com/ part. theme db:s/fo7smcp2luvrikc/BattleTowerSWSHRemix.mp3 — Sets the theme according to this Dropbox shared URL.

Examples

Example 1: Wild Pokémon Boss This first example is a boss battle against a wild Pokémon. You cannot run or catch it, and the level is hidden. The Pokémon’s name is also set to hide its species.

msg(Groouuugoooough!!)&!cry=517,3,2&battle=517,3,2;level 80;name ???;scene 51;hiddenlevel;nomoney;nocatch;norun

Example 2: Battle Tower This example is from the HUB Battle Tower. The dialogue in the msg() block and the trainer battle ID are both controlled by a list. The variable var[noblackout]=1 is set so that the player will not teleport away if they lose the battle.

Similar to the mainline games’ Battle Tower, this battle gives no exp or money, but instead I manually give the player BP if they win (not shown). Items are not allowed, and all participating Pokémon are set to level 50 for the duration of the battle.

msg(%list[trainers][n].speech%)&var[noblackout]=1&mapvar[battle]=3&battle=%list[trainers][n].battleid%;noexp;nomoney;noseen;noitems;fixedlevel 50;theme db:s/fo7smcp2luvrikc/BattleTowerSWSHRemix.mp3