The move object

class poke_env.environment.move.EmptyMove(move_id)

Bases: poke_env.environment.move.Move

class poke_env.environment.move.Move(move: str = '', move_id: Optional[str] = None)

Bases: object

accuracy
Returns:The move’s accuracy (0 to 1 scale).
Return type:float
base_power
Returns:The move’s base power.
Return type:int
boosts
Returns:Boosts conferred to the target by using the move.
Return type:Optional[Dict[str, float]]
breaks_protect
Returns:Whether the move breaks proect-like defenses.
Return type:bool
can_z_move
Returns:Wheter there exist a z-move version of this move.
Return type:bool
category
Returns:The move category.
Return type:MoveCategory
crit_ratio
Returns:The move’s crit ratio. If the move is guaranteed to crit, returns 6.
Return type:
current_pp
Returns:Remaining PP.
Return type:int
damage
Returns:The move’s fix damages. Can be an int or ‘level’ for moves such as Seismic Toss.
Return type:Union[int, str]
deduced_target
Returns:Move deduced target, based on Move.target and showdown’s request messages.
Return type:str, optional
defensive_category
Returns:Move’s defender category.
Return type:MoveCategory
drain
Returns:Ratio of HP of inflicted damages, between 0 and 1.
Return type:float
entry

Should not be used directly.

Returns:The data entry corresponding to the move
Return type:dict
expected_hits
Returns:Expected number of hits, between 1 and 5. Equal to n_hits if n_hits is constant.
Return type:float
flags

This property is not well defined, and may be missing some information. If you need more information on some flag, please open an issue in the project.

Returns:Flags associated with this move. These can come from the data or be custom.
Return type:Set[str]
force_switch
Returns:Whether this move forces switches.
Return type:bool
heal
Returns:Proportion of the user’s HP recovered.
Return type:float
id
Returns:Move id.
Return type:str
ignore_ability
Returns:Whether the move ignore its target’s ability.
Return type:bool
ignore_defensive
Returns:Whether the opponent’s stat boosts are ignored.
Return type:bool
ignore_evasion
Returns:Wheter the opponent’s evasion is ignored.
Return type:bool
ignore_immunity
Returns:Whether the opponent’s immunity is ignored, or a list of ignored immunities.
Return type:bool or set of Types
is_empty
Returns:Whether the move is an empty move.
Return type:bool
static is_id_z(id_) → bool
static is_max_move(id_) → bool
is_protect_counter
Returns:Wheter this move increments a mon’s protect counter.
Return type:int
is_protect_move
Returns:Wheter this move is a protect-like move.
Return type:int
is_side_protect_move
Returns:Wheter this move is a side-protect move.
Return type:int
is_z
Returns:Whether the move is a z move.
Return type:bool
max_pp
Returns:The move’s max pp.
Return type:int
n_hit
Returns:How many hits this move lands. Tuple of the form (min, max).
Return type:Tuple
no_pp_boosts
Returns:Whether the move uses PPs.
Return type:bool
non_ghost_target
Returns:True for curse.
Return type:bool
priority
Returns:Move priority.
Return type:int
pseudo_weather
Returns:Pseudo-weather activated by this move.
Return type:str
recoil
Returns:Proportion of the move’s damage inflicted as recoil.
Return type:float
request_target
Returns:Target information sent by showdown in a request message, if any.
Return type:str, optional
retrieve_id

Retrieve the id of a move based on its full name.

Parameters:move_name (str) – The string to convert into a move id.
Returns:The corresponding move id.
Return type:str
secondary
Returns:Secondary effects. At this point, the precise content of this property is not too clear.
Return type:Optional[Dict]
self_boost
Returns:Boosts applied to the move’s user.
Return type:Dict[str, int]
self_destruct
Returns:Move’s self destruct consequences.
Return type:Optional[str]
self_switch
Returns:What kind of self swtich this move implies for the user.
Return type:Optional[str]
should_be_stored
side_condition
Returns:Side condition inflicted by the move.
Return type:Optional[str]
sleep_usable
Returns:Whether the move can be user by a sleeping pokemon.
Return type:bool
slot_condition
Returns:Which slot condition is started by this move.
Return type:Optional[str]
stalling_move
Returns:Showdown classification of the move as a stalling move.
Return type:bool
status
Returns:The status inflicted by the move.
Return type:Optional[Status]
steals_boosts
Returns:Whether the move steals its target’s boosts.
Return type:bool
target
Returns:Move target. Possible targets (copied from PS codebase): * adjacentAlly - Only relevant to Doubles or Triples, the move only
targets an ally of the user.
  • adjacentAllyOrSelf - The move can target the user or its ally.
  • adjacentFoe - The move can target a foe, but not (in Triples)
    a distant foe.
  • all - The move targets the field or all Pokémon at once.
  • allAdjacent - The move is a spread move that also hits the user’s ally.
  • allAdjacentFoes - The move is a spread move.
  • allies - The move affects all active Pokémon on the user’s team.
  • allySide - The move adds a side condition on the user’s side.
  • allyTeam - The move affects all unfainted Pokémon on the user’s team.
  • any - The move can hit any other active Pokémon, not just those adjacent.
  • foeSide - The move adds a side condition on the foe’s side.
  • normal - The move can hit one adjacent Pokémon of your choice.
  • randomNormal - The move targets an adjacent foe at random.
  • scripted - The move targets the foe that damaged the user.
  • self - The move affects the user of the move.
Return type:str
terrain
Returns:Terrain started by the move.
Return type:Optional[str]
thaws_target
Returns:Whether the move thaws its target.
Return type:bool
type
Returns:Move type.
Return type:PokemonType
use() → None
use_target_offensive
Returns:Whether the move uses the target’s offensive statistics.
Return type:bool
volatile_status
Returns:Volatile status inflicted by the move.
Return type:Optional[str]
weather
Returns:Weather started by the move.
Return type:Optional[Weather]
z_move_boost
Returns:Boosts associated with the z-move version of this move.
Return type:Dict[str, int]
z_move_effect
Returns:Effects associated with the z-move version of this move.
Return type:Optional[str]
z_move_power
Returns:Base power of the z-move version of this move.
Return type:int