Menu

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.

-help
Shows an interactive help menu listing every command grouped by category. Use the dropdown to drill into a specific feature.
Usage-help
-invite
Sends Pokéname's invite link and a button to join the Support Server.
Usage-invite
-support
Posts the Support Server invite. Use this if you need help, want to follow updates, or report something quickly.
Usage-support
-ping
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
-stats
Bot-wide stats: total servers, names told, hints solved, CPU / RAM usage, shard count, uptime, library version, and default prefix.
Usage-stats
-dashboard
dashpanel
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
-vote
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
-premium
Shows what Premium unlocks, with a link to the pricing page. Pass 'servers' to list every server currently on Premium.
Usage-premium [servers]
-spawnrate
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>
-shinyrate
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>
-suggest
Opens a modal to send a feature suggestion straight to the developer. Cooldown: once per minute.
Usage-suggest
-report
Opens a modal to file a bug report. Cooldown: once per minute. Please include reproduction steps.
Usage-report
-tos
Posts Pokéname's privacy policy and data-handling summary.
Usage-tos
-update
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.

-toggle
Admin
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.
-serversettings
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
-channelsettings
View settings that apply only to the current channel — naming toggles, ping toggles, timers, starboard destination, and auto-lock enrollment.
Usage-channelsettings
-setprefix
Admin
Change Pokéname's command prefix for this server. The default is '-'. Slash commands keep working regardless of prefix.
Usage-setprefix <new_prefix>
-rareping
Admin
Set the role to ping when a legendary, mythical or Ultra Beast spawns. Run with no role to clear it.
Usage-rareping <@role>
-paradoxping
Admin
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>
-regionalping
Admin
Set the role to ping when an Alolan / Galarian / Hisuian Pokémon spawns. Run with no role to clear it.
Usage-regionalping <@role>
-managerrole
Admin
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>
-removemanagerrole
Admin
Clear the bot manager role, so only members with Manage Server / Administrator can configure Pokéname again.
Usage-removemanagerrole
-fixpings
cleanpingsprunepings
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.

-shinyhunt
sh
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>
-removeshinyhunt
rsh
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>
-globalsh
globalshinyhuntgsh
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]
-myshinyhunt
mysh
Show what you're currently hunting in this server.
Usage-myshinyhunt
-tags
See every member who is hunting a specific Pokémon in this server.
Usage-tags <pokemon>
-alltags
Paginated list of every Pokémon currently being hunted or collected by anyone in this server.
Usage-alltags
-shtimer
Admin
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.

-collection
cl
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.
-globalcollection
globalcolgcgclglobalcl
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.
-collectionlimit
Admin
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]
-collectionlimits
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]
-collectiontimer
cltimer
Admin
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.

-questpings
qpquestping
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.

-starboard
starboards
Admin
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]
-removestarboard
Admin
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:

  1. Shiny
  2. Gigantamax
  3. Rare
  4. Regional
  5. High IV
  6. 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.

-globalstarboard
gsb
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
-globalstarboardname
gsbname
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
-globalstarboardserver
gsbserver
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.

-leaderboard
lb
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 shards
Most shards.
-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.

-auction
auca
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.

GroupFilters
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.

-warnings
Premium
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]
-deletewarn
removewarndelwarn
AdminPremium
Delete a single warning case by its Case ID (visible in the -warnings output). Useful for clearing false positives.
Usage-deletewarn <case_id>
-settimeout
AdminPremium
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>
-timeouts
Premium
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.

-setlock
Admin
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
-unlock
Admin
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).

-shop
Browse every available background. Each tile shows the price (in coins or USD) and a preview.
Usage-shop
-balance
bal
Show your current coin balance. Coins are earned by voting on Top.gg (see -vote).
Usage-balance
-serverinventory
serverinv
List every background this server has purchased or unlocked.
Usage-serverinventory
-background
bg
Admin
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

-afk
Stop receiving shinyhunt / collection / quest pings from every server you share with Pokéname. Run it again to come back.
Usage-afk
-removetags
Admin
Wipe a user's shiny hunts, collection lists and quest pings from this server — useful when someone leaves or is moderated. Targets one user at a time.
Usage-removetags <@user>