Complete trainer handbook

Everything you need to master PokeBot

Start your trainer, explore routes, win battles, manage your collection, conquer regional Leagues, and use every major game system.

Step one

Quick start

After PokeBot is invited to a server, run /start or /pb start. The bot will guide you through creating a trainer and choosing the starter for your current regional journey.

Invite
/start
Choose starter
Explore
CommandUse
/startCreate your trainer and choose a starter.
/resume-startContinue an interrupted starter selection.
/profileView your trainer profile and progress.
/pb guideOpen the in-Discord illustrated guide.
/pb helpOpen a compact command directory.
First recommended actions:

Run /route info to see where you are, /explore to search the area, and /team view to inspect your new starter.

The core loop

How the adventure works

PokeBot is built around a connected RPG loop. Explore routes, battle and catch Pokémon, strengthen your party, earn money and items, complete story encounters, collect badges, defeat the League, and unlock the next regional journey.

Explore

Search routes for wild Pokémon, Trainers, items, story encounters, and special events.

Build

Level Pokémon, learn moves, evolve species, equip held items, and organize your party.

Progress

Defeat rivals, villain teams, Gym Leaders, the Elite Four, Champions, and legendary encounters.

Connect

Trade securely with other players, challenge friendly duels, and climb the duel leaderboard.

Find your path

Travel and exploration

Locations form a connected travel graph. You normally move between directly connected, unlocked destinations. Badge gates and story progress can block routes until you meet their requirements.

Useful route commands

/route infoShows the current location, connections, encounters, requirements, and available actions.
/route travelMoves to a directly connected unlocked location.
/route mapDisplays a labelled regional map with progression information.
/region mapDisplays the current region and its travel graph.
/exploreSearches for Pokémon, items, Trainers, or events.
/wildSearches specifically for a wild Pokémon.
/trainer infoLists Trainers that may spot you on the current route.

Fast travel

Once destinations are discovered and the required travel method is available, use /fly map and /fly location. /teleport can return you to a discovered route when a party Pokémon knows Teleport.

Fishing

Fishing uses route-specific encounter tables and your best available rod. Check /fishing info, view your rod with /rod, and start an encounter with /fish.

Expand your collection

Catching Pokémon

Wild encounters are rolled for the current route. Each encounter keeps its shiny result for that encounter, so reopening controls does not reroll the Pokémon. Different Poké Balls can receive conditional catch modifiers depending on the target or situation.

Recommended catching flow

  1. Use /wild or /explore to find a Pokémon.
  2. Lower its HP and apply a useful status condition when possible.
  3. Open the Bag during battle and select a suitable Poké Ball.
  4. After capture, the Pokémon enters an open party slot or is sent safely to the PC.
Master Ball:

The Master Ball is an extremely rare guaranteed-catch option. Save it for an encounter that truly matters.

Pokédex tools

Use /pokedex view for regional completion, /pokedex search for species information, and /pokesearch to find configured regional routes for a Pokémon.

Think before every turn

Battle system

PokeBot uses turn-based battles with move priority, speed order, accuracy, evasion, critical hits, Same-Type Attack Bonus, type effectiveness, status effects, stat stages, residual damage, move PP, switching, items, fainting, experience, and level-ups.

Fight

Choose one of the active Pokémon’s available moves. PP, accuracy, type, power, priority, status, recharge, charge turns, pivoting, and other supported effects matter.

Switch

Change to a healthy eligible party member. When a Pokémon faints, choose a replacement before battle continues.

Bag

Use compatible medicine, battle items, and Poké Balls when the battle rules allow it.

Run or forfeit

Wild battles may allow escape. Formal battles may require /battle forfeit, which can reset the current challenge.

Recovering battle controls

Use /battle resume if the active interaction panel is lost or Discord no longer shows the buttons. Use /battle forfeit only when you intend to abandon the battle.

League battles are a gauntlet:

Once the Elite Four run begins, normal healing, shopping, and leaving the League are restricted until the run ends by victory, defeat, or forfeit.

Manage your roster

Team and PC storage

Your active party contains up to six Pokémon. Extra catches are stored in PC boxes. Pokémon have individual records for level, EXP, HP, PP, IVs, EVs, nature, ability, gender, moves, held item, capture history, ownership, favourite status, lock status, and trade history.

/team viewGenerate a six-slot team card with HP and EXP information.
/team swapSwap two party positions.
/team leadMove a Pokémon into the lead position.
/pokemon infoInspect a party Pokémon in detail.
/pc viewOpen a PC box.
/pc depositMove a party Pokémon into storage.
/pc withdrawMove a stored Pokémon into an open party slot.
/pc transferTransfer a Pokémon from another regional PC into the current region’s PC.

Releasing Pokémon

Use /pb release or /pc release. Releases require confirmation and are blocked for protected favourites or locked Pokémon. A held item is returned safely when supported.

Prepare before the next battle

Economy and items

PokéCoins are used for Poké Balls, medicine, machines, evolution items, held items, Mega Stones, rods, and other regional supplies. Your normal bag and wallet are stored separately for each region.

/balance or /walletCheck your current regional PokéCoin balance.
/daily and /weeklyClaim timed trainer rewards.
/bag or /inventoryBrowse the current regional inventory.
/shop viewBrowse the Poké Mart by category and page.
/shop searchSearch the catalogue by item name.
/buy and /sellPurchase or sell permitted items.
/item infoSee an item’s effect, value, ownership, and use command.
/item useUse field items; quantity supports bulk use for suitable items.
/helditem giveEquip an owned held item to a party Pokémon.
/helditem removeReturn the held item to your bag.

Healing

Use /heal at a valid Pokémon Centre. A blackout sends you to the appropriate nearby or League recovery location and restores the party.

Exp. Share

Use /expshare status, /expshare on, and /expshare off after the feature is available.

Train with purpose

Levels, moves, and evolution

Pokémon gain experience according to their configured growth rate. Team cards, detailed Pokémon cards, and battle results display current EXP and progress toward the next level. Level 100 is shown as maximum level.

Learning moves

Level-up prompts let you replace an existing move. Pending decisions are saved so they can survive a restart. Use /learn moveinfo to inspect compatible moves and /learn move to teach eligible level-up or machine moves.

Machines are reusable where the game data permits. Compatibility is checked against the exact species and form.

Evolution

Supported evolution methods include levels, items, friendship, trade-style requirements, held-item trade rules, and special conditions. Use /pokemon evolve to resume a pending evolution.

Missed a move or prompt?

Use the learning and evolution resume commands rather than restarting your save. Pending choices are designed to be restart-safe.

Earn the title

Gyms and the Pokémon League

Each regional campaign contains eight Gym challenges, an Elite Four gauntlet, a Champion, Hall of Fame records, story battles, and post-League legendary opportunities.

/gym infoView the next Gym, requirements, and Leader details.
/gym challengeChallenge the next unlocked Gym Leader.
/badgesView the regional badge case.
/elitefour challengeBegin or continue the Elite Four run.
/champion challengeChallenge the Champion within the same League run.
/halloffameView saved championship records and teams.

League gauntlet rules

  • You may prepare, heal, and buy items at the League entrance before beginning.
  • After entering the first Elite Four battle, healing services, shopping, flying, and leaving are restricted.
  • Elite Four progress is saved between members during the active run.
  • Losing or forfeiting resets the run and returns you to the League entrance with a healed team.
  • After the first clear, Elite Four rematches use high-level teams with Mega aces and Champion rematches reach Level 100.

A new beginning in every generation

Regional journeys

PokeBot includes Kanto, Johto, Hoenn, Sinnoh, Unova, Kalos, Alola, Galar, and Paldea. Complete the active regional League and resolve the required legendary progression to unlock the next region.

What changes between regions

Each region stores its own party, Pokémon collection, PC boxes, box names, ordinary items, PokéCoins, current location, and starter state. Global trainer records, key items, settings, statistics, Pokédex information, and Hall of Fame records can remain trainer-wide.

Foreign Pokémon

Transferred Pokémon remain collectible and manageable, but a Pokémon whose origin does not match the active region is excluded from that region’s battle party, lead selection, switching, and battle-item targets. This prevents a completed-region team from skipping the intended progression of a new journey.

Region commands

Use /region travel to enter an unlocked region. /fly region is an alias. Returning to a visited region restores that region’s exact saved team, PC, bag, wallet, and location.

Unlock greater power

Mega Evolution and special forms

Mega Evolution requires a compatible Pokémon, the correct owned Mega Stone, and a valid Mega accessory such as the Mega Ring. Special supported forms include Charizard X and Y, Mega Greninja, Rayquaza, and Battle Bond Ash-Greninja.

/mega infoView compatible Mega or Battle Bond forms for a party Pokémon.
/mega inventoryView owned Mega Stones and accessories.
/mega equipEquip an owned stone to a compatible party Pokémon.

When all requirements are met, an in-battle Mega action becomes available under supported battle rules. Only the allowed transformation can be used in a battle.

Play together

Trading and duels

Protected trading

Trades use private panels, selection and lock stages, a final confirmation, rollback protection, transaction files, and receipt IDs. Both players must confirm before ownership changes.

/trade requestSend a protected trade request.
/trade acceptAccept the pending request and open the trade flow.
/trade declineDecline the request.
/trade cancelCancel a pending or active trade.
/trade historyView recent trade receipt IDs.

Friendly duels

Duels support singles, doubles, or trios team sizes with optional balancing. Move choices are made privately, battle HP and PP are isolated from the saved adventure state, and results are recorded.

Use /duel request, /duel accept, /duel rules, /duel history, and /duel leaderboard.

PokeBot Overlord

/duelpokebot challenge starts an unrestricted Level 100 boss encounter. Use /duelpokebot info to inspect the rules, reward, and all six boss builds before challenging it.

Rare encounters

Events and legendary battles

Weekly Mythical event

Use /event mythical to search the current weekly event for its featured Mythical Pokémon. Event availability and encounter rules are shown in Discord.

Legendary progression

Regional League clears earn legendary encounter opportunities. Use /legendary info to review earned encounters and /legendary battle to select or retry one.

Legendary encounters can maintain a shiny chain across eligible replays. League rematches may grant the next unresolved encounter without wiping an active chain.

Your progress is protected

Recovery, blackouts, and save safety

PokeBot uses atomic JSON writes, per-player locks, rotating backups, schema migrations, validation, corruption recovery, and multi-player transaction rollback for trades.

When something is interrupted

/resume-startRestore starter selection.
/battle resumeRestore the current battle controls.
/pokemon evolveContinue a saved evolution prompt.
/learn moveContinue or resolve move learning.
/cooldownsSee when timed actions become available again.

Blackouts

When no healthy Pokémon remain, the trainer is returned to an appropriate nearby Pokémon Centre without being moved forward past unfinished route progression. League defeats return the trainer to the League entrance. The party is automatically healed.

For Discord server owners

Adding and supporting PokeBot

  1. Use the official invite link and select the Discord server you manage.
  2. Confirm the requested permissions and complete Discord’s authorization screen.
  3. Make sure PokeBot can view the game channel, send messages, embed links, attach files, read message history, and use application commands.
  4. Run /pb about or /pb help to confirm commands are visible.
  5. Direct members to /start and this guide.
Permission notice:

The supplied invite URL currently requests Discord’s Administrator permission. Review the authorization screen carefully and only add bots you trust. A least-privilege invite can instead use View Channels, Send Messages, Embed Links, Attach Files, Read Message History, and Use Application Commands when the hosted bot supports that configuration.

For public support, use /pb support or join the official support server.

Common questions

Frequently asked questions

What command starts the game?

Use /start or /pb start. Use /resume-start if the starter flow was interrupted.

Why can’t I use a transferred Pokémon in battle?

Regional battle restrictions keep each journey balanced. A Pokémon from a different origin region remains collectible but is excluded from the active region’s battle system.

How do I restore missing battle buttons?

Run /battle resume. The active battle must still exist in memory.

Where did my newly caught Pokémon go?

If your party was full, it was placed into the current region’s PC. Use /pc view.

How do I heal?

Travel to a valid town or League entrance with a Pokémon Centre and use /heal. During an active Elite Four gauntlet, normal healing services are locked.

Can I use more than one Rare Candy or EXP Candy at once?

Yes. /item use supports a quantity option for suitable bulk-use field items, including supported candies and medicine.

How do I find a Pokémon?

Use /pokesearch to see configured regional locations, then travel there and use /wild or /explore.

How do I get help from a person?

Use /pb support or join the official PokeBot Discord support server.

Ready to play?

Choose your starter and begin the journey.