Quests Types
Quest Types and Progress Triggers
Every quest's behavior comes from its type field, which must be one of the 15 keys below (exact spelling, from QuestType.java). Progress is checked once at the end of every match.
targetAmount is how much progress completes the quest. Most types add +1 progress per qualifying match; the exceptions are called out below.
Quest Trigger Table
type |
typeFilter |
What it does at end of match |
|---|---|---|
PLAY_MATCHES |
— | +1 for every completed match (ranked or casual, win or lose). |
WIN_MATCHES |
— | +1 when the player won. |
WIN_RANKED |
format keyword | +1 when the player won a ranked match whose ladder ID matches the filter. |
PLAY_RANKED |
format keyword | +1 when the player completed a ranked match matching the filter (win or lose). |
PLAY_CASUAL |
— | +1 when the match was in a casual queue. |
WIN_STREAK |
— | +1 on a win. On a loss, progress resets to 0. |
USE_TYPE |
elemental type (fire, ghost, …) |
+1 if at least one Pokémon the player brought had that type. Filter is required — no filter, no progress. |
WIN_WITH_ALIVE |
— | +1 when the player won. (Currently identical to WIN_MATCHES — it does not check how many Pokémon survived.) |
WIN_FAST |
— | +1 if the player won and the match ended in targetAmount turns or fewer. Here targetAmount is the turn limit, so this quest completes in a single fast win. |
PLAY_LONG |
— | +1 if the match lasted at least targetAmount turns (or ran past 20 turns). |
WIN_BY_FORFEIT |
— | +1 when the player won because the opponent forfeited / disconnected. |
PLAY_NO_FORFEIT |
— | +1 when the match finished with nobody forfeiting. |
PLAY_MONOTYPE |
— | +1 if the player's team had 2 or fewer distinct types total across all its Pokémon. |
KNOCKOUT_TOTAL |
— | +3 on a win, +1 on a loss — a rough "aggression" score, always adds something. |
MASTER_MONOTYPE |
elemental type | Not a per-match counter. It syncs the quest's progress up to the player's lifetime monotype-win count for that type from their stats profile. Filter is required. |
How the format filter works (WIN_RANKED / PLAY_RANKED)
The filter is a plain substring check, case-insensitive, against the ladder ID that was played.
typeFilter: "doubles"→ matchesdoubles_ranked,doubles_50_casual,tourney_duplas? → no (that ID istourney_duplas, which does not contain "doubles"). It matches any ladder ID that literally containsdoubles.typeFilter: nullor""→ matches every format.
So filter on the actual ID fragments your ladders use (singles, doubles, triples, monotype, ranked, _50_, …).
Notes
WIN_FAST'stargetAmountis a turn cap, not a repeat count — the quest is done the first time the player wins within that many turns. Pair it with a permanent quest if you want it repeatable-feeling, or accept it as a one-and-done.MASTER_MONOTYPEprogress can jump by more than 1 at once (it catches up to the profile total), and it never goes down.- Quest
typekeys are case-sensitive and must matchQuestType.javaexactly — a typo makes the whole quest fail to load.