Commands
Every command Pokéname supports, grouped by what it does. All commands shown with the default prefix -. Slash command equivalents (/command) work identically wherever a command is marked hybrid — which is most of them.
Categories: General · Server configuration · Shiny hunting · Collection · Quest pings · Starboard · Global Starboard · Leaderboards · Auctions · Steal warnings · Auto-Lock · Backgrounds & shop · AFK & cleanup
General
Public commands available to everyone.
Shows an interactive help menu listing every command grouped by category. Use the dropdown to drill into a specific feature.
Usage-help
Sends Pokéname's invite link and a button to join the Support Server.
Usage-invite
Posts the Support Server invite. Use this if you need help, want to follow updates, or report something quickly.
Usage-support
Reports Pokéname's websocket latency, average premium / non-premium naming time, and database round-trip time. Also tells you which cluster and shard your server is on.
Usage-ping
Bot-wide stats: total servers, names told, hints solved, CPU / RAM usage, shard count, uptime, library version, and default prefix.
Usage-stats
Links you to the web dashboard, where every server setting can be configured without touching a command. Works in DMs and as a user app.
Usage-dashboard
Shows your vote streak, current coin balance, and a Top.gg vote button. Voting every 12 hours rewards +10 coins for the in-bot shop.
Usage-vote
Shows what Premium unlocks, with a link to the pricing page. Pass 'servers' to list every server currently on Premium.
Usage-premium [servers]
Look up how rarely a specific Pokémon spawns. Returns the percentage chance and an estimate like 'once every N spawns'. Non-spawnable Pokémon are marked as such.
Usage-spawnrate <pokemon>
Compute your odds of finding a shiny given a shiny-chain count. Returns the odds expressed as both '1 in N' and a percentage.
Usage-shinyrate <shinychain>
Opens a modal to send a feature suggestion straight to the developer. Cooldown: once per minute.
Usage-suggest
Opens a modal to file a bug report. Cooldown: once per minute. Please include reproduction steps.
Usage-report
Posts Pokéname's privacy policy and data-handling summary.
Usage-tos
Shows the latest Poké-Name update announcement — what changed most recently, with links to read more.
Usage-update
Server configuration
Admin-only commands. Require Manage Server (or Administrator in some cases). Most server-wide toggles can also be flipped from the Dashboard.
The master configuration command. Enables / disables a server-wide or channel-scoped feature. Run -toggle with no arguments to see the full list of options.
Usage-toggle <feature>
Subcommands
-toggle spawns
Automatic naming on spawns in the current channel.
-toggle alts
Show the alt-names embed below each name.
-toggle catchcommand
Show a tap-to-copy catch command under each naming in this channel. Off by default.
-toggle sh
Shiny-hunt pings in the current channel.
-toggle shtimer
Enable the configured Post-Tag (shiny) timer in this channel.
-toggle cltimer
Enable the configured Collection timer in this channel.
-toggle hint
Server-wide hint solver for Pokémon / Pokétwo hints.
-toggle manualsh
Allow members to trigger SH pings by typing the Pokémon name (per-channel, off by default).
-toggle rareping
Rare-spawn pings in the current channel.
-toggle paradoxping
Paradox-spawn pings in the current channel.
-toggle regionalping
Alolan / Galarian / Hisuian region pings in the current channel.
-toggle collection
Collection pings in the current channel.
-toggle questping
Quest pings in the current channel.
-toggle rarecollect
Allow members to add rare Pokémon to their collection list.
-toggle manualstarboard
Members can react ⭐ to send a message to the starboard.
-toggle starboardtheme
Post starboard catches as themed image cards instead of text embeds. Premium.
-toggle event
Render naming images for Pokétwo event embeds.
-toggle shstealwarn
Auto-warn users who catch into another member's shinyhunt. Premium.
-toggle clstealwarn
Auto-warn users who catch into another member's collection. Premium.
-toggle textnaming
Switch the naming output from image embeds to text-only.
-toggle showafk
Include AFK users in ping lists, or hide them.
-toggle lb
Your own setting, not the server's — show or hide your name on the global leaderboards. Needs no permissions and works in DMs.
View the entire server config in one embed — prefix, premium plan, every server-wide toggle, ping roles, collection limits, auto-lock state, and per-channel flag counts.
Usage-serversettings
View settings that apply only to the current channel — naming toggles, ping toggles, timers, starboard destination, and auto-lock enrollment.
Usage-channelsettings
Change Pokéname's command prefix for this server. The default is '-'. Slash commands keep working regardless of prefix.
Usage-setprefix <new_prefix>
Set the role to ping when a legendary, mythical or Ultra Beast spawns. Run with no role to clear it.
Usage-rareping <@role>
Set the role to ping when a paradox Pokémon spawns — the ten Ancient forms and the ten Iron forms. Run with no role to clear it.
Usage-paradoxping <@role>
Set the role to ping when an Alolan / Galarian / Hisuian Pokémon spawns. Run with no role to clear it.
Usage-regionalping <@role>
Set a role that can manage the bot like an administrator — members with it can use every admin/configuration command, in the bot and on the dashboard. Only server administrators can set or change it. Run with no role to view the current one.
Usage-managerrole <@role>
Clear the bot manager role, so only members with Manage Server / Administrator can configure Pokéname again.
Usage-removemanagerrole
-fixpingscleanpingsprunepings
Admin
Clean up after members who left. Scans every shiny hunt, collection list and quest ping in the server, shows you how many belong to people who are no longer here, and clears them once you confirm. Stops your ping lists filling up with users nobody can ping.
Usage-fixpings
Shiny hunting
Hunt a specific Pokémon and get pinged when it spawns. Server-local hunts apply to one server; global hunts auto-sync across every server you share with Pokéname.
Anywhere you type a Pokémon name you can use its English, German, French or Japanese name (romaji included) as well as form names — -sh Bisasam, -sh Fushigidane and -sh Bulbasaur all set the same hunt. Replies always come back in English.
Set the Pokémon you're shiny hunting in this server. Replaces your previous hunt for this server. Members get pinged when this Pokémon spawns.
Usage-shinyhunt <pokemon>
Stop hunting a specific Pokémon in this server. Use this if you don't want to be pinged for it anymore.
Usage-removeshinyhunt <pokemon>
-globalshglobalshinyhuntgsh
Set or manage your global shiny hunt — one Pokémon that auto-applies across every mutual server. Running it with no argument opens an interactive menu (Your Shinyhunt / Server Settings / Server List). Note: setting a new global hunt overwrites the previous one.
Usage-globalsh [pokemon]
Show what you're currently hunting in this server.
Usage-myshinyhunt
Configure the Post-Tag (shiny) timer for the current channel — how many seconds to wait after a tag before re-pinging. Range: 3–180 seconds. After setting, enable it per-channel with `-toggle shtimer`.
Usage-shtimer <seconds>
Collection
Track Pokémon you want for your collection and get pinged when one spawns. Collection commands have add / remove / list / clear subcommands grouped under one root.
Like shiny hunts, these accept foreign and alternate names as well as English ones.
Manage your per-server collection list. Run with no subcommand for an interactive menu (your collection, server settings, server list).
Usage-collection [subcommand]
Subcommands
-collection add <pokemon>
Add a Pokémon to your collection list for this server.
-collection remove <pokemon>
Remove a Pokémon from your collection list.
-collection list
View every Pokémon in your collection for this server.
-collection clear
Wipe your entire collection list for this server.
-globalcollectionglobalcolgcgclglobalcl
Like -collection, but your global list — auto-syncs to every mutual server you share with Pokéname.
Usage-globalcollection [subcommand]
Subcommands
-globalcollection add <pokemon>
Add a Pokémon to your global collection list (applies across all servers).
-globalcollection remove <pokemon>
Remove a Pokémon from your global collection list.
-globalcollection list
View every Pokémon in your global collection.
-globalcollection clear
Wipe your global collection list.
Cap how many Pokémon members can keep in their collection list. Pass just a number to set a server-wide limit. Pass a role to set a per-role limit (Premium only). Existing lists are trimmed to the new cap.
Usage-collectionlimit <limit> [@role]
Show the current global collection limit plus any per-role overrides set in this server.
Usage-collectionlimits
-removecollectionlimit
Admin
Remove a previously set collection limit. Pass a role to remove just that role's override; pass nothing to clear the server-wide limit.
Usage-removecollectionlimit [@role]
Configure the Collection timer for the current channel — how many seconds to wait after a collection ping before the next one fires. After setting, enable it per-channel with `-toggle cltimer`.
Usage-collectiontimer <seconds>
Quest pings
Get pinged when Pokémon from selected categories spawn — useful for daily quests in Pokétwo.
Open the interactive Quest Pings menu. Pick regions, types, or rarity tiers you want to be pinged for. Pings only fire in channels with `-toggle questping` enabled.
Usage-questpings
Starboard
Auto-relay notable catches — rares, regionals, shinies, Gigantamax, and high/low IV — to a starboard channel, or let members manually star messages with the ⭐ reaction.
Premium servers post these as themed image cards instead of plain embeds; turn that off with -toggle starboardtheme if you prefer the classic text look.
With a channel (-starboard #channel), sends the current channel's notable catches there. With no arguments, opens a panel listing every starboard in the server, where you can pick one and toggle which categories it receives (rare, regional, shiny, gigantamax, high IV, low IV). The same panel has a Category Channels button for per-category routing.
Usage-starboard [#channel]
Remove the starboard configuration for the current channel.
Usage-removestarboard
Sending each category to its own channel
By default every notable catch from a spawn channel goes to that channel's one starboard. If you'd rather split them up — shinies in one channel, rares in another — open -starboard, press Category Channels, pick a category and pick its channel. The same six rows are on the dashboard under Server Settings → Category channels.
Anything you leave on Default starboard keeps going where it always did, so servers that never touch this are unaffected.
A catch is only ever posted once. When a catch fits more than one category, the first match in this order wins:
- Shiny
- Gigantamax
- Rare
- Regional
- High IV
- Low IV
So a shiny legendary posts to your Shiny channel, not to both Shiny and Rare. Giving a category its own channel also switches that category on for it, so a route always takes effect immediately.
Global Starboard
A live feed of notable catches from every server running Pokéname — rares, shinies, regionals, Gigantamax and high/low IV — browsable in Discord or on the website. It is separate from your server's own starboard: you don't have to configure anything to appear in it, and nothing you set here changes where your server's starboard posts.
Both names are hidden by default. Your catches show up anonymously unless you opt in.
Browse the whole-bot feed of notable catches. Filter by category (rare, shiny, regional, gigantamax, high IV, low IV) and page through the results. Installable as a user app, so it works in DMs and in servers without Pokéname.
Usage-globalstarboard
-globalstarboardnamegsbname
Toggle whether YOUR name is shown next to your catches on the Global Starboard. Hidden by default — run this to be credited. Personal setting, no permissions needed, works in DMs.
Usage-globalstarboardname
-globalstarboardservergsbserver
Admin
Toggle whether THIS SERVER's name is shown when catches from it appear on the Global Starboard. Hidden by default.
Usage-globalstarboardserver
Leaderboards
Global rankings across everyone who uses Pokéname, plus per-Pokémon boards showing who has caught the most of a given species. Also on the website.
Opens the leaderboard with a category picker. Pass a Pokémon name instead to see the top catchers of that species — any name the bot accepts works (English, foreign and alt names, forms), and forms resolve to the base species, so '-lb alolan vulpix' ranks Vulpix. The prefix version also accepts a category name directly, e.g. '-lb shards'. Works in DMs and as a user app.
Usage-leaderboard [pokemon | category]
Subcommands
-lb poketwo
Richest trainers.
-lb caught
Most Pokémon caught.
-lb shiny
Most shinies caught.
-lb legendary
Most legendaries caught.
-lb mythical
Most mythicals caught.
-lb ultrabeast
Most Ultra Beasts caught.
-lb gmax
Most Gigantamax caught.
-lb hatched
Most Pokémon hatched.
-lb hatched_shiny
Most shinies hatched.
-lb hatched_gmax
Most Gigantamax hatched.
-lb coins
Coins earned in Poké-Name (see -vote).
-lb votestreak
Longest consecutive voting streaks.
Your name is shown by default. Use -toggle lb to hide yourself — it's a personal setting, needs no permissions, and works in DMs.
Auctions
Searchable history of ended Pokétwo auctions, so you can check what something actually sold for before you bid. Installable as a user app, so it works in DMs and in servers that don't have Pokéname.
Browse ended auctions. Run on its own for a summary of the subcommands.
Usage-auction [subcommand]
Subcommands
-auction search [filters]
Search ended auctions, 15 per page. No filters returns the most recent. Alias: -a s
-auction info <id>
Full details for a single auction by its numeric ID. Alias: -a i
-auction filters
Show every available search filter. Prefix-only. Alias: -a f
Search filters
Filters use Pokétwo's own syntax, so anything you're used to typing there works here. Combine as many as you like.
| Group | Filters |
|---|
| Name & text | <name> · --name --n · --nickname --nick --ni · --move <move> · --shiny --sh |
| Category | --alolan --alo · --galarian --gal · --hisuian --his · --mega · --gigantamax --gmax · --legendary --leg · --mythical --myth · --ub · --paradox --par · --event --ev |
| Region & type | --region <region> (alola, galar, paldea…) · --type <type> (fire, dragon, steel…) |
| IVs & numbers | --iv · --hpiv · --atkiv · --defiv · --spatkiv · --spdefiv · --spdiv · --level · --bid · --id · --nature <x> · --gender <x> |
| Matching IVs | --triple <n> · --quadruple <n> · --pentuple <n> · --hextuple <n> — N of the six IVs equal that value |
| Sorting & paging | --order <iv|level|price> with +/- (e.g. --order iv-) · --limit <n> · --skip <n> |
Numeric filters accept comparisons, e.g. --iv > 90.
Examples
-a s --legendary --shiny --order iv-
-a s --region alola --iv > 90 --limit 30
-a s --hextuple 31
-a s フシギダネ
Steal warnings
Premium safety net. Pokéname watches catches in the server — if someone catches a Pokémon that's in another member's active shiny hunt or collection list, the catcher gets warned and (optionally) auto-timed-out after a configurable number of strikes.
View shiny-hunt and collection steal warnings for a user. Defaults to yourself; admins can pass another user. Returns a paginated list of cases with case IDs.
Usage-warnings [@user]
-deletewarnremovewarndelwarn
AdminPremium
Delete a single warning case by its Case ID (visible in the -warnings output). Useful for clearing false positives.
Usage-deletewarn <case_id>
At warning level N, automatically time the user out for X minutes. Configure as many warning levels as you like — e.g. -settimeout 3 60 means a 60-minute timeout after the 3rd warning.
Usage-settimeout <warning_level> <minutes>
-unsettimeout
AdminPremium
Remove the auto-timeout configured for a specific warning level.
Usage-unsettimeout <warning_level>
Show every auto-timeout currently configured for this server: warning level → duration.
Usage-timeouts
Auto-Lock
Automatically lock channels for a configurable duration after a Pokémon spawns, to enforce naming or catching rules. Channels, delay, duration and trigger conditions are managed through one interactive command.
Available on every server, including free ones — Premium tiers just raise the caps on how many channels you can enrol and how long a lock can last.
Open the interactive Auto-Lock control panel. Pick which channels to enrol, set lock delay (how long after a spawn before the lock kicks in), lock duration, and trigger conditions (every spawn / shiny-hunt match / collection match / rare). Limits by tier — Free: 20 channels, 30s max delay, 8h max duration. Basic: 50 channels, 2m, 1 day. Standard: 100 channels, 5m, 3 days. Premium: 200 channels, 10m, 7 days.
Usage-setlock
Manually unlock the current channel if Auto-Lock has it locked. Cancels any pending unlock timer too.
Usage-unlock
Backgrounds & shop
Customise the artwork behind Pokéname's naming embeds with collectible backgrounds. Some are unlocked for free, others are paid (PayPal one-time purchases).
Browse every available background. Each tile shows the price (in coins or USD) and a preview.
Usage-shop
Show your current coin balance. Coins are earned by voting on Top.gg (see -vote).
Usage-balance
-serverinventoryserverinv
List every background this server has purchased or unlocked.
Usage-serverinventory
Set the active naming background for this server from your inventory. Run with no argument to see the current background and your owned options.
Usage-background [background_name]
AFK & cleanup
Stop receiving shinyhunt / collection / quest pings from every server you share with Pokéname. Run it again to come back.
Usage-afk