Skip to content

PokeBattle Command

Agustín San Román edited this page May 10, 2025 · 2 revisions

The pokebattle <Pokemon> VS <Pokemon> command simulates a 1 vs 1 battle between 2 pokemon.

It displays the status of the battle using an HTML box in the room.

The moves, stats, item, ability and other properties of the pokemon are chosen randomly, unless specified.

The engine is very simplified:

  • Only damage, no status moves or secondary effects
  • If a pokemon does not have any moves that deal some damage, it will use Struggle

Specify pokemon properties

You can specify a property of a pokemon that you do not want to be random by using the syntax:

pokebattle <Pokemon>@[Properties] VS <Pokemon>@[Properties]

The properties are a list of pairs, separated with commas. Each pair has a key and a value, separated by an equal sign:

pokebattle <Pokemon>@item=Item,ability=Ability,Moves=Move1/Move2/Move3/Move4 VS <Pokemon>@item=Item,ability=Ability,Moves=Move1/Move2/Move3/Move4 

These are the properties you can set:

  • name - A custom name for the Pokemon
  • gender - Can be M (male), F (female) or N (no gender)
  • level - The level (from 1 to 9999)
  • shiny - Can be yes or no
  • nature - The nature
  • evs - The EVs, separated by bars (/)
  • ivs - The IVs, separated by bars (/)
  • item - The held item
  • ability - The ability
  • hp - Start with a custom HP percent (1 - 100)
  • happiness - The happiness stat
  • moves - The list of moves, separated by bars (/)

Example:

.pokebattle Pikachu-Starter@name=Sparky,shiny,gender=M,item=eviolite,moves=Fissure/IronTail/ZippyZap/ExtremeSpeed,ability=Multiscale,ivs=31/31/31/31/31/31,evs=252hp/252atk,nature=Adamant VS Eevee-Starter@name=Eva,shiny,gender=F,item=eviolite,moves=SparklySwirl/Fissure/SizzlySlide/ExtremeSpeed,ability=Multiscale,ivs=31/31/31/31/31/31,evs=252hp/252atk,nature=Adamant

Clone this wiki locally