pyvgc 0.0.1__py3-none-any.whl

pyvgc/__init__.py

@@ -0,0 +1,45 @@
+"""Public API for the pyvgc package."""
+
+from .battle_logic import (
+    BattleLogic,
+    CARTRIDGE_CHAMPIONS_RELEASE_2026,
+    SIMULATOR_CHAMPIONS_RELEASE_2026,
+    get_battle_logic,
+)
+from .damage import calculate_damage, damage_rolls
+from .items import Item, get_item
+from .moves import (
+    Move,
+    get_move,
+    moves_for_pokemon,
+    pokemon_for_move,
+)
+from .pokemon import Pokemon
+from .regulations import load_regulation
+from .utils import (
+    pokemon_with_ability,
+    pokemon_with_single_ability,
+    regulation_description,
+    signature_moves,
+)
+
+__all__ = [
+    "BattleLogic",
+    "CARTRIDGE_CHAMPIONS_RELEASE_2026",
+    "SIMULATOR_CHAMPIONS_RELEASE_2026",
+    "calculate_damage",
+    "damage_rolls",
+    "get_battle_logic",
+    "get_item",
+    "get_move",
+    "Item",
+    "Move",
+    "moves_for_pokemon",
+    "Pokemon",
+    "pokemon_with_ability",
+    "pokemon_with_single_ability",
+    "pokemon_for_move",
+    "regulation_description",
+    "load_regulation",
+    "signature_moves",
+]

pyvgc/battle_logic.py

@@ -0,0 +1,135 @@
+"""Named battle-rule configurations used by regulations."""
+
+from __future__ import annotations
+
+import csv
+from dataclasses import dataclass, field, replace
+from fractions import Fraction
+from importlib import resources
+from types import MappingProxyType
+from typing import TYPE_CHECKING, Mapping, Optional
+
+from .constants import (
+    BASE_HP_INCREASE,
+    BASE_STAT_INCREASE,
+    CRITICAL_MULTIPLIER,
+    DAMAGE_DIVISOR,
+    DAMAGE_LEVEL_DIVISOR,
+    LEVEL_DOUBLES,
+    MAX_TOTAL_TRAINING,
+    MAX_TRAINING_PER_STAT,
+    MAX_STAT_STAGE,
+    MIN_STAT_STAGE,
+    RANDOM_PERCENTAGES,
+    STAB_MULTIPLIER,
+    STAT_STAGE_MULTIPLIERS,
+    TYPES,
+)
+
+if TYPE_CHECKING:
+    from .damage import DamageRolls
+    from .pokemon import Pokemon
+
+
+@dataclass(frozen=True)
+class BattleLogic:
+    """Immutable rules and constants for one game-logic version."""
+
+    name: str
+    level: int = LEVEL_DOUBLES
+    base_hp_increase: int = BASE_HP_INCREASE
+    base_stat_increase: int = BASE_STAT_INCREASE
+    max_training_per_stat: int = MAX_TRAINING_PER_STAT
+    max_total_training: int = MAX_TOTAL_TRAINING
+    min_stat_stage: int = MIN_STAT_STAGE
+    max_stat_stage: int = MAX_STAT_STAGE
+    stat_stage_multipliers: Mapping[int, tuple[int, int]] = field(
+        default_factory=lambda: MappingProxyType(dict(STAT_STAGE_MULTIPLIERS))
+    )
+    damage_level_divisor: int = DAMAGE_LEVEL_DIVISOR
+    damage_divisor: int = DAMAGE_DIVISOR
+    random_percentages: range = RANDOM_PERCENTAGES
+    stab_multiplier: Fraction = STAB_MULTIPLIER
+    critical_multiplier: Fraction = CRITICAL_MULTIPLIER
+    type_chart: Optional[Mapping[str, Mapping[str, Fraction]]] = None
+
+    def with_type_chart(
+        self, type_chart: Mapping[str, Mapping[str, Fraction]]
+    ) -> "BattleLogic":
+        """Return this logic with an immutable type chart."""
+        immutable_chart = MappingProxyType({
+            attack: MappingProxyType(dict(defending))
+            for attack, defending in type_chart.items()
+        })
+        return replace(self, type_chart=immutable_chart)
+
+    def calculate_damage(
+        self,
+        attacker: "Pokemon",
+        defender: "Pokemon",
+        power: int,
+        move_type: str,
+        *,
+        special: bool = False,
+        percentage: bool = True,
+    ) -> "DamageRolls":
+        """Calculate damage using this battle logic and two Pokémon.
+
+        Both Pokémon must use this exact logic instance. This makes the
+        selected rule set explicit at the calculation call site.
+        """
+        from .damage import calculate_damage
+
+        if attacker.battle_logic is not self or defender.battle_logic is not self:
+            raise ValueError(
+                "attacker and defender must use this battle logic"
+            )
+        return calculate_damage(
+            attacker,
+            defender,
+            power,
+            move_type,
+            special=special,
+            percentage=percentage,
+        )
+
+
+def _load_type_chart() -> Mapping[str, Mapping[str, Fraction]]:
+    """Load the initial packaged type chart used by current battle logic."""
+    path = resources.files("pyvgc.data").joinpath("initial_type_chart.csv")
+    with path.open(newline="", encoding="utf-8") as file:
+        return MappingProxyType({
+            row["AttackingType"]: MappingProxyType({
+                defending: Fraction(row[defending]) for defending in TYPES
+            })
+            for row in csv.DictReader(file)
+        })
+
+
+CARTRIDGE_CHAMPIONS_RELEASE_2026 = BattleLogic(
+    name="Cartridge-Champions-Release-2026",
+    type_chart=_load_type_chart(),
+)
+
+SIMULATOR_CHAMPIONS_RELEASE_2026 = replace(
+    CARTRIDGE_CHAMPIONS_RELEASE_2026,
+    name="Simulator-Champions-Release-2026",
+)
+
+BATTLE_LOGICS = MappingProxyType(
+    {
+        "Cartridge-Champions-Release-2026": CARTRIDGE_CHAMPIONS_RELEASE_2026,
+        "Simulator-Champions-Release-2026": SIMULATOR_CHAMPIONS_RELEASE_2026,
+    }
+)
+
+
+def get_battle_logic(name: str) -> BattleLogic:
+    """Return a registered battle logic by case-insensitive name."""
+    if not isinstance(name, str) or not name.strip():
+        raise ValueError("battle logic name must be a non-empty string")
+    key = name.strip().casefold()
+    for logic_name, logic in BATTLE_LOGICS.items():
+        if logic_name.casefold() == key:
+            return logic
+    raise KeyError(f"Unknown battle logic: {name!r}")

pyvgc/constants.py

@@ -0,0 +1,53 @@
+"""Shared constants and packaged data paths for pyvgc."""
+
+from fractions import Fraction
+
+LEVEL_DOUBLES = 50
+
+BASE_HP_INCREASE = 75
+BASE_STAT_INCREASE = 20
+
+MAX_TRAINING_PER_STAT = 32
+MAX_TOTAL_TRAINING = 66
+MIN_STAT_STAGE = -6
+MAX_STAT_STAGE = 6
+
+STAT_STAGE_MULTIPLIERS = {
+    stage: (2 + stage, 2) if stage >= 0 else (2, 2 - stage)
+    for stage in range(MIN_STAT_STAGE, MAX_STAT_STAGE + 1)
+}
+DAMAGE_LEVEL_DIVISOR = 5
+DAMAGE_DIVISOR = 50
+
+RANDOM_PERCENTAGES = range(85, 101)
+STAB_MULTIPLIER = Fraction(3, 2)
+CRITICAL_MULTIPLIER = Fraction(3, 2)
+STAT_NAMES = (
+    "hp", "attack", "defense", "special_attack", "special_defense", "speed"
+)
+TYPES = frozenset((
+    "Normal", "Fire", "Water", "Electric", "Grass", "Ice", "Fighting",
+    "Poison", "Ground", "Flying", "Psychic", "Bug", "Rock", "Ghost",
+    "Dragon", "Dark", "Steel", "Fairy",
+))
+
+ALWAYS_HIT_VALUE = "always-hit"
+
+NATURES = {
+    "Hardy": ("attack", "attack"), "Lonely": ("attack", "defense"),
+    "Brave": ("attack", "speed"), "Adamant": ("attack", "special_attack"),
+    "Naughty": ("attack", "special_defense"),
+    "Bold": ("defense", "attack"), "Docile": ("defense", "defense"),
+    "Impish": ("defense", "special_attack"), "Lax": ("defense", "special_defense"),
+    "Relaxed": ("defense", "speed"),
+    "Modest": ("special_attack", "attack"), "Mild": ("special_attack", "defense"),
+    "Bashful": ("special_attack", "special_attack"),
+    "Rash": ("special_attack", "special_defense"), "Quiet": ("special_attack", "speed"),
+    "Calm": ("special_defense", "attack"), "Gentle": ("special_defense", "defense"),
+    "Careful": ("special_defense", "special_attack"),
+    "Quirky": ("special_defense", "special_defense"),
+    "Sassy": ("special_defense", "speed"),
+    "Timid": ("speed", "attack"), "Hasty": ("speed", "defense"),
+    "Jolly": ("speed", "special_attack"), "Naive": ("speed", "special_defense"),
+    "Serious": ("speed", "speed"),
+}

pyvgc/damage.py

@@ -0,0 +1,183 @@
+"""Pokémon Champions damage calculation for level-50 Pokémon."""
+
+from __future__ import annotations
+
+from fractions import Fraction
+from typing import TYPE_CHECKING, Iterable, TypedDict
+
+from .battle_logic import BattleLogic, CARTRIDGE_CHAMPIONS_RELEASE_2026
+from .constants import TYPES
+
+if TYPE_CHECKING:
+    from .pokemon import Pokemon
+
+
+class DamageRolls(TypedDict, total=False):
+    """Mapping returned by damage calculations."""
+
+    normal: list[int]
+    critical: list[int]
+    normal_percentage: list[float]
+    critical_percentage: list[float]
+
+
+def _normalize_type(type_name: str) -> str:
+    """Validate and canonicalize one Pokémon type name."""
+    if not isinstance(type_name, str):
+        raise ValueError(f"type names must be strings, got {type(type_name).__name__}")
+    normalized = type_name.strip().title()
+    if normalized not in TYPES:
+        raise ValueError(f"unknown Pokémon type: {type_name!r}")
+    return normalized
+
+
+def _type_multiplier_for_types(
+    move_type: str, defender_types: tuple[str, ...], logic: BattleLogic
+) -> Fraction:
+    """Return effectiveness for already-normalized defender types."""
+    if logic.type_chart is None:
+        raise ValueError(f"battle logic {logic.name!r} has no type chart")
+    multiplier = Fraction(1)
+    for defender_type in defender_types:
+        multiplier *= logic.type_chart[move_type][defender_type]
+    return multiplier
+
+
+def _type_multiplier(
+    move_type: str, defender_types: Iterable[str], logic: BattleLogic
+) -> Fraction:
+    """Normalize types and return their combined effectiveness multiplier."""
+    normalized_move = _normalize_type(move_type)
+    normalized_defenders = tuple(
+        _normalize_type(defender_type) for defender_type in defender_types
+    )
+    return _type_multiplier_for_types(
+        normalized_move, normalized_defenders, logic
+    )
+
+
+def damage_rolls(
+    power: int,
+    attack: int,
+    defense: int,
+    move_type: str,
+    attacker_types: Iterable[str],
+    defender_types: Iterable[str],
+    *,
+    logic: BattleLogic = CARTRIDGE_CHAMPIONS_RELEASE_2026,
+) -> DamageRolls:
+    """Return all 16 normal and 16 critical damage rolls.
+
+    ``attack`` and ``defense`` are the already-calculated battle stats.
+    Damage is floored at every formula step, as in the games. Critical hits
+    use the selected logic's critical multiplier and ignore the relevant stat
+    stages.
+    """
+    if not all(
+        type(value) is int and value > 0
+        for value in (power, attack, defense)
+    ):
+        raise ValueError("power, attack, and defense must be positive integers")
+    move_type = _normalize_type(move_type)
+    attacker_types = tuple(
+        _normalize_type(type_name) for type_name in attacker_types
+    )
+    defender_types = tuple(
+        _normalize_type(type_name) for type_name in defender_types
+    )
+    if not attacker_types or not defender_types:
+        raise ValueError("attacker_types and defender_types must not be empty")
+    if len(attacker_types) > 2 or len(defender_types) > 2:
+        raise ValueError("a Pokémon can have at most two types")
+    stab = logic.stab_multiplier if move_type in attacker_types else Fraction(1)
+    effectiveness = _type_multiplier(move_type, defender_types, logic)
+
+    # (((((2L/5)+2) * Power * A / D) / 50) + 2), with integer floors.
+    base = (
+        (
+            (2 * logic.level // logic.damage_level_divisor + 2)
+            * power
+            * attack
+            // defense
+        )
+        // logic.damage_divisor
+    ) + 2
+
+    def rolls(critical: bool) -> list[int]:
+        """Calculate all 16 random outcomes for one hit category."""
+        result: list[int] = []
+        critical_damage = int(base * logic.critical_multiplier) if critical else base
+        for random_percent in logic.random_percentages:
+            fixed = critical_damage * random_percent // 100
+            fixed = int(fixed * stab)
+            fixed = int(fixed * effectiveness)
+            result.append(fixed)
+        return result
+
+    return {"normal": rolls(False), "critical": rolls(True)}
+
+
+def calculate_damage(
+    attacker: "Pokemon",
+    defender: "Pokemon",
+    power: int,
+    move_type: str,
+    *,
+    special: bool = False,
+    percentage: bool = True,
+) -> DamageRolls:
+    """Calculate damage rolls using two Pokémon and their current battle state.
+
+    The Pokémon models provide state only. This function owns the damage
+    calculation, including critical-hit stat-stage handling and percentages.
+    """
+    from .pokemon import Pokemon
+
+    if not isinstance(attacker, Pokemon) or not isinstance(defender, Pokemon):
+        raise TypeError("attacker and defender must be Pokemon instances")
+    if attacker.battle_logic != defender.battle_logic:
+        raise ValueError("attacker and defender must use the same battle logic")
+
+    attack_stat = "special_attack" if special else "attack"
+    defense_stat = "special_defense" if special else "defense"
+    attack = getattr(attacker, attack_stat)
+    defense = getattr(defender, defense_stat)
+    rolls = damage_rolls(
+        power,
+        attack,
+        defense,
+        move_type,
+        attacker.types,
+        defender.types,
+        logic=attacker.battle_logic,
+    )
+    critical_attack = (
+        attacker._pre_stage_stats[attack_stat]
+        if attacker._stat_stages.get(attack_stat, 0) < 0
+        else attack
+    )
+    critical_defense = (
+        defender._pre_stage_stats[defense_stat]
+        if defender._stat_stages.get(defense_stat, 0) > 0
+        else defense
+    )
+    if critical_attack != attack or critical_defense != defense:
+        rolls["critical"] = damage_rolls(
+            power,
+            critical_attack,
+            critical_defense,
+            move_type,
+            attacker.types,
+            defender.types,
+            logic=attacker.battle_logic,
+        )["critical"]
+    if percentage:
+        rolls["normal_percentage"] = [
+            round(damage / defender.hp * 100, 2)
+            for damage in rolls["normal"]
+        ]
+        rolls["critical_percentage"] = [
+            round(damage / defender.hp * 100, 2)
+            for damage in rolls["critical"]
+        ]
+    return rolls

pyvgc/data/__init__.py

@@ -0,0 +1 @@
+"""Bundled data files for pyvgc."""

pyvgc/data/battle_items.csv

@@ -0,0 +1,167 @@
+ItemName,ReleasedInRegulation,Description
+Abomasite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Absolite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Absolite Z,M-C,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Aerodactylite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Aggronite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Air Balloon,M-C,"This item, when attached to a Pokémon, causes it to be immune from Ground-type attacks and entry hazards."
+Alakazite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Altarianite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Ampharosite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Aspear Berry,M-A,Cures the holder of freeze.
+Audinite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Babiri Berry,M-A,Weakens one super-effective Steel-type attack against the holder.
+Banettite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Barbaracite,M-B,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Baxcalibrite,M-C,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Beedrillite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Big Root,M-B,Boosts HP restored by draining and recovery moves by 30%.
+Binding Band,M-C,"This item, when attached to a Pokémon, increases damage caused by moves that constrict the opponent."
+Black Belt,M-A,"When this item is held, any Fighting-type move used by the holder has its power increased by 20%."
+Black Glasses,M-A,"When this item is held, any Dark-type move used by the holder has its power increased by 20%."
+Blastoisinite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Blazikenite,M-B,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Bright Powder,M-A,This hold item raises the holder's evasion by 10%.
+Cameruptite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Chandelurite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Charcoal,M-A,"When this item is held, any Fire-type move used by the holder has its power increased by 20%."
+Charizardite X,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Charizardite Y,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Charti Berry,M-A,Weakens one super-effective Rock-type attack against the holder.
+Cheri Berry,M-A,Cures the holder of paralysis.
+Chesnaughtite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Chesto Berry,M-A,Cures the holder of sleep.
+Chilan Berry,M-A,Weakens one super-effective Normal-type attack against the holder.
+Chimechite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Choice Scarf,M-A,"When this item is being held, the user's Speed is increased by 50%, but the Pokémon is limited to using the first attack it uses until it is withdrawn from battle."
+Chople Berry,M-A,Weakens one super-effective Fighting-type attack against the holder.
+Clefablite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Coba Berry,M-A,Weakens one super-effective Flying-type attack against the holder.
+Colbur Berry,M-A,Weakens one super-effective Dark-type attack against the holder.
+Crabominite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Damp Rock,M-B,"When this item is held by a Pokémon, if the holder uses the move Rain Dance, the weather effect lasts eight turns as opposed to five."
+Delphoxite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Dragalgite,M-B,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Dragon Fang,M-A,"When this item is held, any Dragon-type move used by the holder has its power increased by 20%."
+Dragoninite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Drampanite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Eelektrossite,M-B,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Eject Button,M-C,"This item, when attached to a Pokémon, allows the holder to escape from battle should they get hit by an attack that makes physical contact."
+Electric Seed,M-C,This item will boost the user's Defense by 1 stage when Electric Terrain is activated.
+Emboarite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Excadrite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Expert Belt,M-B,"When this item is held, if the holder uses an attack on the opponent which is Super Effective, its power is increased by 20%."
+Fairy Feather,M-A,This item increases damage inflicted by Fairy-type moves by 20%.
+Falinksite,M-B,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Feraligite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Floettite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Focus Band,M-A,Gives the holder a 10% chance to survive an attack that would knock it out with 1 HP.
+Focus Sash,M-A,"Prevents a full-HP holder from being knocked out by one attack, leaving it at 1 HP; consumed after use."
+Froslassite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Galladite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Garchompite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Garchompite Z,M-C,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Gardevoirite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Gengarite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Glalitite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Glimmoranite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Golisopite,M-C,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Golurkite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Grassy Seed,M-C,This item will boost the user's Defense by 1 stage when Grassy Terrain is activated.
+Greninjite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Gyaradosite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Haban Berry,M-A,Weakens one super-effective Dragon-type attack against the holder.
+Hard Stone,M-A,"When this item is held, any Rock-type move used by the holder has its power increased by 20%."
+Hawluchanite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Heat Rock,M-B,"When this item is held by a Pokémon, if the holder uses the move Sunny Day, the weather effect lasts eight turns as opposed to five."
+Heracronite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Houndoominite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Icy Rock,M-B,"When this item is held by a Pokémon, if the holder uses the move Hail, the weather effect lasts eight turns as opposed to five."
+Iron Ball,M-B,"When this item is held by a Pokémon, the holder's Speed is reduced by 50%. If the holder is of the Flying-type or it has the ability; Levitate, it becomes susceptable to Ground-type moves."
+Kangaskhanite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Kasib Berry,M-A,Weakens one super-effective Ghost-type attack against the holder.
+Kebia Berry,M-A,Weakens one super-effective Poison-type attack against the holder.
+King's Rock,M-A,"When this item is held by a Pokémon, the likelihood of the opponent flinching from a damaging attack by this Pokémon is increased by 10 %."
+Leek,M-C,"When this item is held by Farfetch'd, the holder's Critical Hit ratio is raised by 2 stages. In Pokémon Sword & Shield, this item's name was changed from Stick to Leek."
+Leftovers,M-A,"When this item is held, at the end of every turn, the holder regains 1/16th of their maximum HP."
+Leppa Berry,M-A,Restores 10 PP to a move when the holder runs out of PP for it.
+Life Orb,M-B,"When this item is held by a Pokémon, the damage from the moves used by the holder is increased by 30%. The holder loses 10% of their maximum HP each turn."
+Light Ball,M-A,Doubles the Attack and Special Attack of Pikachu.
+Light Clay,M-B,"When this item is held by a Pokémon, if the holder uses the attacks Reflect or Light Screen, the effects of those attacks last eight turns as opposed to five."
+Lopunnite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Lucarionite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Lucarionite Z,M-C,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Lum Berry,M-A,Cures the holder of any major status condition or confusion.
+Magnet,M-A,"When this item is held, any Electric-type move used by the holder has its power increased by 20%."
+Malamarite,M-B,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Manectite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Mawilite,M-B,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Medichamite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Meganiumite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Mental Herb,M-A,"Cures infatuation and certain move-prevention effects once, then is consumed."
+Meowsticite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Metagrossite,M-B,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Metal Coat,M-A,Boosts Steel-type moves by 20%.
+Metronome,M-B,"Boosts the power of a move used consecutively, up to a maximum bonus."
+Miracle Seed,M-A,"When this item is held, any Grass-type move used by the holder has its power increased by 20%."
+Misty Seed,M-C,This item will boost the user's Special Defense by 1 stage when Misty Terrain is activated.
+Muscle Band,M-B,"When this item is held, the holder's Physical attacks are increased in power by 10%."
+Mystic Water,M-A,"When this item is held, any Water-type move used by the holder has its power increased by 20%."
+Never-Melt Ice,M-A,Boosts the power of Ice-type moves.
+Normal Gem,M-C,Boosts the power of the holder’s Normal-type move once by 30%; consumed after use.
+Occa Berry,M-A,Weakens one super-effective Fire-type attack against the holder.
+Oran Berry,M-A,Restores 10 HP when the holder has low HP.
+Passho Berry,M-A,Weakens one super-effective Water-type attack against the holder.
+Payapa Berry,M-A,Weakens one super-effective Psychic-type attack against the holder.
+Pecha Berry,M-A,Cures the holder of poison.
+Persim Berry,M-A,Cures the holder of confusion.
+Pidgeotite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Pinsirite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Poison Barb,M-A,"When this item is held, any Poison-type move used by the holder has its power increased by 20%."
+Psychic Seed,M-C,This item will boost the user's Special Defense by 1 stage when Psychic Terrain is activated.
+Pyroarite,M-B,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Quick Claw,M-A,"When this item is held, the user has a 18.75% (Gen 3 & 4), or 20% (Gen 5 & beyond) chance of attacking first if the moves all Pokémon use are within the same Speed Priority level."
+Raichunite X,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Raichunite Y,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Rawst Berry,M-A,Cures the holder of burn.
+Red Card,M-C,"This item, when attached to a Pokémon, causes any Pokémon that makes physical contact to be removed from battle."
+Rindo Berry,M-A,Weakens one super-effective Grass-type attack against the holder.
+Rocky Helmet,M-C,"This item, when attached to a Pokémon, causes the attacker to receive recoil of 1/6th of maximum Hit Points should they make Physical Contact."
+Roseli Berry,M-A,Weakens one super-effective Fairy-type attack against the holder.
+Sablenite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Salamencite,M-C,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Sceptilite,M-B,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Scizorite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Scolipite,M-B,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Scope Lens,M-A,"When held by a Pokémon, the Pokémon's Critical Hit ratio is raised by 1."
+Scovillainite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Scraftinite,M-B,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Sharp Beak,M-A,"When this item is held, any Flying-type move used by the holder has its power increased by 20%."
+Sharpedonite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Shed Shell,M-B,"When this item is held by a Pokémon, if the trainer tries to switch the holder with another Pokémon, the switch is not affected by any moves or abilities which would prvent it leaving."
+Shell Bell,M-A,"When this item is held, the holder recovers 1/8th of the damage it inflicts on its opponents."
+Shuca Berry,M-A,Weakens one super-effective Ground-type attack against the holder.
+Silk Scarf,M-A,Boosts Normal-type moves by 20%.
+Silver Powder,M-A,"When this item is held, any Bug-type move used by the holder has its power increased by 20%."
+Sitrus Berry,M-A,Restores 25% of the holder’s maximum HP when its HP is low.
+Skarmorite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Slowbronite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Smooth Rock,M-B,"When this item is held by a Pokémon, if the holder uses the move Sandstorm, the weather effect lasts eight turns as opposed to five."
+Soft Sand,M-A,"When this item is held, any Ground-type move used by the holder has its power increased by 20%."
+Spell Tag,M-A,"When this item is held, any Ghost-type move used by the holder has its power increased by 20%."
+Staraptite,M-B,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Starminite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Steelixite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Swampertite,M-B,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Tanga Berry,M-A,Weakens one super-effective Bug-type attack against the holder.
+Terrain Extender,M-C,Extends terrain created by the holder’s move or ability by three turns.
+Twisted Spoon,M-A,"When this item is held, any Psychic-type move used by the holder has its power increased by 20%."
+Tyranitarite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Venusaurite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Victreebelite,M-A,"This item, when held, allows for the Pokémon to Mega Evolve in battle."
+Wacan Berry,M-A,Weakens one super-effective Electric-type attack against the holder.
+White Herb,M-A,"At the end of using a move, the holder's stats have been lowered, the White Herb restores the stat to normal. The White Herb disappears after use."
+Wide Lens,M-B,"When this item is held by a Pokémon, the moves used by the Pokémon have their accuracy increased by 10% of their accuracy value."
+Wise Glasses,M-B,"When this item is held, the holder's Special attacks are increased in power by 10%."
+Yache Berry,M-A,Weakens one super-effective Ice-type attack against the holder.
+Zoom Lens,M-B,"When this item is held by a Pokémon, if the holder moves last, its accuracy is increased by 20%."