Raids & Eggs¶
Track raid bosses and raid eggs by level, pokemon, team, and more.
Filter syntax
Filters use key:value form — e.g. level:5, d:1000, move:psystrike. Legacy level5 / d1000 are still accepted. Teams are bare words (valor, red) — there is no team: prefix. See Pokemon Tracking — Filter Syntax for the full convention.
Multi-word keywords
The bot splits commands on spaces, so keywords that contain a space must be typed with underscores (or wrapped in double quotes): mega_legendary, shadow_legendary, ultra_beast, rsvp_only, no_rsvp. Typing mega legendary with a space is read as two separate words.
Raid Tracking¶
Track specific raid bosses:
Track by Level¶
!raid level:1 # Tier 1 raids
!raid level:3 # Tier 3 raids
!raid level:1-5 # Tiers 1 to 5 (one rule per level)
!raid legendary # Level 5
!raid mega # Level 6 (mega raids)
!raid mega_legendary # Level 7
!raid ultra_beast # Level 8
!raid elite # Level 9
!raid primal # Level 10
!raid shadow # All shadow levels (11-15)
!raid shadow_legendary # Level 15 only
!raid everything # All raid levels
Only one level filter is read per command — !raid legendary mega or !raid level:1 level:3 rejects the second word. Use a range (level:1-5), separate commands, or the | separator to add several in one message:
| Level | Name keyword |
|---|---|
| 1–4 | level:1 … level:4 |
| 5 | legendary |
| 6 | mega |
| 7 | mega_legendary |
| 8 | ultra_beast |
| 9 | elite |
| 10 | primal |
| 11–14 | level:11 … level:14 (shadow 1–4 star) |
| 15 | shadow_legendary |
| 11–15 | shadow (all shadow levels) |
No type or generation tracking for raids
Raid rules are either by boss or by level. Pokemon type names (dragon, fire) and gen: are not raid filters: in 5.3+ !raid dragon or !raid everything gen:1 is rejected with "Unrecognized: …" and nothing is saved. (Older builds silently ignored them on a level rule, so !raid everything dragon tracked every raid.) Name the bosses you want instead.
Track by Form or Costume¶
form: narrows a named boss to one form; costume: narrows by costume (name or ID, costume:0 = no costume):
An unknown form or costume name is rejected with an error rather than silently tracking every form. Use !info <pokemon> forms / !info <pokemon> costumes to see valid names.
Track by Team¶
Filter to raids at gyms controlled by a specific team. Teams are bare words:
Team names: instinct/yellow, valor/red, mystic/blue, harmony/gray.
Track EX-Eligible Raids¶
Track a Specific Gym¶
gym: pins the rule to one gym, by gym ID or by name. Multi-word names must be kept together — use underscores, or wrap the whole option in double quotes:
If the name matches several gyms the bot lists them (up to 10) with their IDs so you can re-run with the exact ID. Gym lookup needs the scanner database to be configured.
Track by Move¶
A move name the bot doesn't recognise is rejected with "Unknown move: …" (5.3+). Older builds treated it as "any move" and tracked the boss regardless. Use !info moves to check move names.
Track with Distance / Areas¶
See Areas & Locations for location: and area: rules.
RSVP Updates¶
Egg Tracking¶
Track raid eggs before they hatch:
Egg Options¶
Eggs support the same level names, team, gym, distance, area, EX, RSVP, clean/edit and template options as raids (but not pokemon, form:, costume: or move:):
All Raid/Egg Options¶
| Option | Description | Example |
|---|---|---|
<pokemon> |
Raid boss (raids only); + suffix adds evolutions |
mewtwo |
level:<n> / level:<n>-<m> |
Raid tier level or range | level:5 |
legendary / mega / mega_legendary / ultra_beast / elite / primal / shadow / shadow_legendary |
Level names (see table above) | legendary |
form:<name> |
Boss form (raids only) | form:origin |
costume:<name\|id> |
Boss costume; costume:0 = no costume (raids only) |
costume:0 |
move:<name> |
Specific move (raids only) | move:psystrike |
instinct / valor / mystic / harmony (or yellow / red / blue / gray) |
Gym team filter | valor |
ex |
EX-eligible gyms only | ex |
gym:<id\|name> |
Specific gym (underscores or quotes for multi-word names) | gym:hilltop_gym |
d:<n> |
Distance in metres | d:1000 |
location:<name> |
Distance from a named location (requires d:) |
location:Home |
area:<name>[,<name>] |
Restrict to specific areas | area:downtown |
rsvp |
First alert plus RSVP change updates | rsvp |
rsvp_only |
Only alert while RSVPs exist | rsvp_only |
no_rsvp |
First alert only (default) | no_rsvp |
template:<n> |
Alert template | template:2 |
clean |
Auto-delete when raid ends | clean |
edit |
Single message, edited in place as the raid updates | edit |
everything |
All levels | everything |
remove |
Remove tracking | remove |
Legacy no-colon forms (level5, d1000) still work.
Removing Tracks¶
!raid remove mewtwo # Stop tracking Mewtwo raids (all forms)
!raid remove pikachu costume:0 # Only the un-costumed Pikachu rule
!raid remove level:5 # Stop tracking level 5 raids
!raid remove everything # Remove all raid tracking
!raid remove id:12 # Remove one raid rule by ID (see !tracked)
!egg remove level:5 # Stop tracking level 5 eggs
!egg remove everything # Remove all egg tracking
!untrack raid id:12 # Same as !raid remove id:12
form: is not accepted on remove — removal is species-wide, so !raid remove giratina form:origin is rejected rather than deleting every Giratina rule. To remove a single form's rule, use its ID from !tracked (!raid remove id:12).
Note
Plain !untrack id:12 removes a pokemon rule. For raid and egg rules use !raid remove id:12 / !egg remove id:12, or !untrack raid id:12 / !untrack egg id:12.