Conditions (also called filters) specify which Pokémon count toward quest completion. All conditions stack—a Pokémon must match all specified conditions to increment quest progress.

When multiple conditions are set, they combine with AND logic:

{
    action: "catch"
    amount: 1L
    pokemon: "pikachu"
    shiny: true
    min_level: 25
}

This quest requires catching a Pokémon that is:

• A Pikachu AND
• Shiny AND
• Level 25 or higher

These conditions are available in all versions of Cobblemon.

Example:

action: "catch, defeat"

Multiple actions are separated by commas. The quest increments if any of the listed actions occur.

Example:

amount: 10L

Format: <namespace>:<pokemon> (namespace defaults to cobblemon if omitted)

Examples:

# Single Pokémon
pokemon: "pikachu"

# Multiple Pokémon
pokemon: "pikachu, raichu, pichu"

# With namespace
pokemon: "cobblemon:charizard"

# Any Pokémon (leave empty)
pokemon: ""

Examples:

# Galarian form
form: "galarian"

# Alolan form
form: "alolan"

# Hisuian form
form: "hisuian"

# Multiple forms
form: "galarian, alolan"

# Custom aspects
form: "custom_aspect"

Special Cases:

• For defeat_player and defeat_npc, this field contains player/NPC names (case-sensitive)
• See Getting Started - Custom Aspects for custom aspect usage

Values: male, female, genderless

Examples:

# Only male
gender: "male"

# Male or female
gender: "male, female"

# Genderless Pokémon
gender: "genderless"

Values: normal, fire, water, grass, electric, ice, fighting, poison, ground, flying, psychic, bug, rock, ghost, dragon, dark, steel, fairy

Examples:

# Single type
pokemon_type: "fire"

# Multiple types
pokemon_type: "fire, dragon"

# Any dual-type with Water
pokemon_type: "water"

Note: A Pokémon matches if it has any of the specified types (OR logic).

Examples:

# Must be shiny
shiny: true

# Must NOT be shiny (or any)
shiny: false

Examples:

# Level 50 or higher
min_level: 50
max_level: 0

# Level 30-40 (inclusive)
min_level: 30
max_level: 40

# Exactly level 25
min_level: 25
max_level: 25

# Any level
min_level: 0
max_level: 0

Values: kanto, johto, hoenn, sinnoh, unova, kalos, alola, galar, hisui, paldea

Examples:

# Kanto Pokémon only
region: "kanto"

# Gen 1 or Gen 2
region: "kanto, johto"

# Custom region (requires manual editing)
region: "my_custom_region"

Format: <namespace>:<biome>

Examples:

# Vanilla biomes
biome: "minecraft:plains"

# Multiple biomes
biome: "minecraft:plains, minecraft:forest"

# Cobblemon biomes
biome: "cobblemon:volcanic"

# Custom mod biomes
biome: "custom_mod:biome"

Common Values:

• minecraft:overworld
• minecraft:the_nether
• minecraft:the_end

Examples:

# Nether only
dimension: "minecraft:the_nether"

# Nether or End
dimension: "minecraft:the_nether, minecraft:the_end"

# Custom dimension
dimension: "custom_mod:dimension"

Range: time_min <= time < time_max

Common Time Values:

• 0 - Sunrise (6:00 AM)
• 6000 - Noon (12:00 PM)
• 12000 - Sunset (6:00 PM)
• 18000 - Midnight (12:00 AM)
• 24000 - End of day cycle

Examples:

# Daytime only (6 AM - 6 PM)
time_min: 0L
time_max: 12000L

# Nighttime only (6 PM - 6 AM)
time_min: 12000L
time_max: 24000L

# Any time
time_min: 0L
time_max: 24000L

Common Values: poke_ball, great_ball, ultra_ball, master_ball, safari_ball, level_ball, lure_ball, moon_ball, friend_ball, love_ball, heavy_ball, fast_ball, sport_ball, premier_ball, repeat_ball, timer_ball, nest_ball, net_ball, dive_ball, luxury_ball, heal_ball, quick_ball, dusk_ball, cherish_ball, park_ball, dream_ball, beast_ball

Examples:

# Must be caught with Master Ball
poke_ball_used: "master_ball"

# Any Ultra Ball or Master Ball
poke_ball_used: "ultra_ball, master_ball"

# Apricorn balls
poke_ball_used: "level_ball, lure_ball, moon_ball"

Note: This condition also applies to trade and evolve actions, checking the ball the Pokémon is currently in.

Values: seen, caught

Examples:

# Must be registered as caught
dex_progress: "caught"

# Only needs to be seen
dex_progress: "seen"

Used With: register and have_registered actions

These conditions require Cobblemon 1.7.0 or later.

Values: normal, fire, water, grass, electric, ice, fighting, poison, ground, flying, psychic, bug, rock, ghost, dragon, dark, steel, fairy, stellar

Examples:

# Fire Tera type
tera_type: "fire"

# Fire or Dragon
tera_type: "fire, dragon"

Used With: terastallize action

Values: mega, mega-x, mega-y, primal

Examples:

# Any Mega Evolution
mega_form: "mega"

# Mega Charizard X specifically
pokemon: "charizard"
mega_form: "mega-x"

# Primal forms (Groudon/Kyogre)
mega_form: "primal"

Used With: mega_evolve action

Type-based Z-Crystals: normalium-z, firium-z, waterium-z, grassium-z, electrium-z, icium-z, fightinium-z, poisonium-z, groundium-z, flyinium-z, psychium-z, buginium-z, rockium-z, ghostium-z, dragonium-z, darkinium-z, steelium-z, fairium-z

Pokémon-specific Z-Crystals: aloraichium-z, decidium-z, eevium-z, incinium-z, kommonium-z, lunalium-z, lycanium-z, marshadium-z, mewnium-z, mimikium-z, pikanium-z, pikashunium-z, primarium-z, snorlium-z, solganium-z, tapunium-z, ultranecrozium-z

Examples:

# Fire-type Z-Move
z_crystal: "firium-z"

# Pikachu's exclusive Z-Move
z_crystal: "pikanium-z"

# Partner Cap Pikachu's Z-Move
pokemon: "pikachu"
form: "partner-cap"
z_crystal: "pikashunium-z"

Used With: use_z_move action

Values: dynamax, gigantamax

Examples:

# Regular Dynamax
dynamax_type: "dynamax"

# Gigantamax only
dynamax_type: "gigantamax"

Used With: dynamax, gigantamax actions (requires Mega Showdown mod)

{
    action: "catch"
    amount: 1L
    pokemon: "bulbasaur, charmander, squirtle"
    shiny: true
    dimension: "minecraft:overworld"
    time_min: 0L
    time_max: 12000L
    type: "cobblemon_tasks:cobblemon_task"
}

{
    action: "defeat"
    amount: 10L
    pokemon_type: "dragon"
    min_level: 50
    max_level: 0
    type: "cobblemon_tasks:cobblemon_task"
}

{
    action: "hatch_egg"
    amount: 1L
    pokemon: "pichu, cleffa, igglybuff, togepi, tyrogue, smoochum, elekid, magby"
    shiny: true
    type: "cobblemon_tasks:cobblemon_task"
}

{
    action: "catch"
    amount: 5L
    form: "alolan"
    poke_ball_used: "luxury_ball"
    type: "cobblemon_tasks:cobblemon_task"
}

{
    action: "mega_evolve"
    amount: 1L
    pokemon: "charizard"
    mega_form: "mega-x"
    type: "cobblemon_tasks:cobblemon_task"
}

• Empty field - No restriction (matches all)
• Specified field - Must match one of the listed values

For list fields (pokemon, types, forms, etc.), a Pokémon matches if it has any of the specified values:

pokemon: "pikachu, raichu"

Matches if the Pokémon is Pikachu OR Raichu.

When combining multiple list conditions, the Pokémon must match at least one value from each list:

pokemon: "pikachu, raichu"
pokemon_type: "electric"

Matches Electric-type Pokémon that are either Pikachu or Raichu.

• If min_level = 0 and max_level = 0, any level is accepted
• If both are set to the same non-zero value, the Pokémon must be exactly that level
• Otherwise, the Pokémon's level must be between min_level and max_level (inclusive)

• Actions - What actions trigger quest progress
• Examples - Complex quest examples combining conditions
• Getting Started - Basic setup and installation
• Action Picker - UI for configuring conditions in v1.2.0+