The move object¶

class poke_env.environment.move.DynamaxMove(parent: poke_env.environment.move.Move)¶

Bases: poke_env.environment.move.Move

BOOSTS_MAP = {<PokemonType.BUG: 1>: {'spa': -1}, <PokemonType.DARK: 2>: {'spd': -1}, <PokemonType.DRAGON: 3>: {'atk': -1}, <PokemonType.GHOST: 9>: {'def': -1}, <PokemonType.NORMAL: 13>: {'spe': -1}}¶

SELF_BOOSTS_MAP = {<PokemonType.FIGHTING: 6>: {'atk': 1}, <PokemonType.FLYING: 8>: {'spe': 1}, <PokemonType.GROUND: 11>: {'spd': 1}, <PokemonType.POISON: 14>: {'spa': 1}, <PokemonType.STEEL: 17>: {'def': 1}}¶

TERRAIN_MAP = {<PokemonType.ELECTRIC: 4>: <Field.ELECTRIC_TERRAIN: 2>, <PokemonType.FAIRY: 5>: <Field.MISTY_TERRAIN: 7>, <PokemonType.GRASS: 10>: <Field.GRASSY_TERRAIN: 3>, <PokemonType.PSYCHIC: 15>: <Field.PSYCHIC_TERRAIN: 10>}¶

WEATHER_MAP = {<PokemonType.FIRE: 7>: <Weather.SUNNYDAY: 8>, <PokemonType.ICE: 12>: <Weather.HAIL: 4>, <PokemonType.ROCK: 16>: <Weather.SANDSTORM: 7>, <PokemonType.WATER: 18>: <Weather.RAINDANCE: 6>}¶

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

crit_ratio¶

Returns:	The move’s crit ratio. If the move is guaranteed to crit, returns 6.
Return type:

damage¶

Returns:	The move’s fix damages. Can be an int or ‘level’ for moves such as Seismic Toss.
Return type:	Union[int, str]

defensive_category¶

Returns:	Move’s defender category.
Return type:	MoveCategory

expected_hits¶

Returns:	Expected number of hits, between 1 and 5. Equal to n_hits if n_hits is constant.
Return type:	float

force_switch¶

Returns:	Whether this move forces switches.
Return type:	bool

heal¶

Returns:	Proportion of the user’s HP recovered.
Return type:	float

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

n_hit¶

Returns:	How many hits this move lands. Tuple of the form (min, max).
Return type:	Tuple

priority¶

Returns:	Move priority.
Return type:	int

recoil¶

Returns:	Proportion of the move’s damage inflicted as recoil.
Return type:	float

self_boost¶

Returns:	Boosts applied to the move’s user.
Return type:	Dict[str, int]

status¶

Returns:	The status inflicted by the move.
Return type:	Optional[Status]

terrain¶

Returns:	Terrain started by the move.
Return type:	Optional[Field]

weather¶

Returns:	Weather started by the move.
Return type:	Optional[Weather]

class poke_env.environment.move.EmptyMove(move_id)¶: Bases: poke_env.environment.move.Move

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

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

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

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

class poke_env.environment.move.Gen8Move(move: str = '', move_id: Optional[str] = None)¶: 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

dynamaxed¶

Returns:	The dynamaxed version of the move.
Return type:	DynamaxMove

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[Field]

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