Skip to content
Documentation

How Minion works

Every run mode, movement mode and option, named exactly as it appears in the bot. If something here does not match what the bot actually does, tell us in Discord — documentation that lies is worse than none.

Free34 features, no key needed
Premium29 more with a subscription
See plans
01

Getting Started

From a downloaded zip to a bot running on its own. Headings across these docs are tagged Free or Premium so you can see what a subscription adds without reading a word of it.

Overview(link to this section)

Minion automates PokeMMO by reading the game window and sending keyboard and mouse input. It never reads or writes game memory and never modifies the client.

You configure it with two dropdowns and a pile of checkboxes:

  • Run Mode — what it does in a battle, or instead of one
  • Movement Mode — how it finds encounters

Everything else is a feature that attaches to those two choices. If you understand that pairing, the rest of the interface makes sense.

Installation(link to this section)

Unzip the archive to a folder you own — Documents or Desktop. Do not run it from inside the zip, and avoid Program Files, because the bot writes Settings.ini next to the executable and Windows blocks that there.

Add the folder to your antivirus exclusions before first launch. This is not optional: the bot reads another application's window and sends synthetic input, which is behaviourally identical to a keylogger as far as a heuristic scanner is concerned. Verify the SHA-256 from the download page first, then exclude the folder.

Run minion.exe. On the login window:

ButtonUse it when
Premium LoginYou have an account and an active subscription
Premium RegisterFirst key — pick a username and password, paste the key
Extend SubscriptionRenewing — adds time to the account you already have
Free AccessTrying the free feature set without a key

Renewing always means Extend Subscription, never Register. Register creates a second account, and your settings, profiles and bound machine stay with the first.

Game Settings(link to this section)

There are none to change.

The bot resolves the game's geometry at runtime and computes its regions from the live client, so it adapts to whatever the game is running at — any resolution, windowed or fullscreen, any Windows display scaling. There is no resolution picker because there is nothing to pick.

If you have used other screen-reading bots, this is the setup step you are looking for and will not find.

Hotkeys(link to this section)

Two global hotkeys, active whether or not the bot window has focus:

KeyAction
F9Start
F10Stop

If another application has already registered them, the bot says so at startup rather than failing silently — close the other application and restart, or use the START and STOP buttons.

Your in-game hotkey slots matter too. The bot presses numbered slots for items and moves, so keep your rod, repels and healing items where you configured them.

Your first run(link to this section)

  1. Log in to PokeMMO and stand where you want the bot to work.
  2. Pick a Movement Mode and a Run Mode.
  3. Turn on the safety options — at minimum Humanize Actions and a break interval.
  4. Press F9.

Watch the first ten minutes. That is long enough to confirm your slots, items and route are what the bot expects. After that, leave it and let Discord tell you when something happens.

02

Battle Modes

4 free·6 premium

Set under RUN MODE. This decides what happens once an encounter starts. Pick one — it pairs with a Movement Mode, which decides how encounters are found.

Fight(link to this section)Free

Battles normally and wins. Move choice accounts for type effectiveness rather than spamming the first slot, and the bot switches out when a Pokémon is in trouble instead of letting it faint.

Use it for levelling, for clearing a route you intend to farm later, or as the safe default while testing a new setup.

Run(link to this section)Free

Flees from every encounter it can flee from.

Pair with shiny hunting: encounters cycle as fast as the game allows and the bot only stops when something is worth stopping for.

Catch(link to this section)Free

Throws balls until the Pokémon is caught, then carries on.

Most of the catching options attach to this mode — ball selection, status moves before the throw, switching to a dedicated catcher. See Features and Premium Features.

Pay Day(link to this section)Premium

Uses Pay Day to generate money from encounters.

The most reliable income in the bot, and the one that benefits most from a good route. Enable 2+ Pay Day if more than one party member knows the move, and Multi Target Move (2) so hordes pay out several times instead of once.

Pay Day + Catch [MIXED](link to this section)Premium

Farms money and still catches what you have asked for. Pay Day runs on encounters you do not want; the catching routine takes over on the ones you do.

Slower income than pure Pay Day, but you are not choosing between money and a hunt.

Thief(link to this section)Premium

Steals held items from wild Pokémon.

Imprison stops the target using a move that would end the encounter early. What you collect depends entirely on where you are — check which species in your area hold something worth having before committing to a long session.

Pay Day + Thief [MIXED](link to this section)Premium

Both in one encounter: take the item and take the money.

The highest value per encounter of any mode, and correspondingly the slowest. Worth it on routes where the held items are good. 2+ Thief applies here the same way 2+ Pay Day does.

Pickpocket(link to this section)Premium

Steals from hordes, which multiplies the take per encounter.

Horde encounters need to stay alive long enough to work through, so this mode leans on a sleep-inducing Pokémon and will swap to it when it needs to.

Safari(link to this section)Premium

Handles Safari Zone encounters properly — throwing Bait and Rock rather than fighting, since you cannot battle there.

Pairs with the Safari movement modes.

None(link to this section)Free

No battle behaviour at all. The bot leaves fights to you.

Use it when you want the non-battle automation running without anything touching your encounters, or when you are watching a shiny hunt manually.

03

Non-Battle Modes

2 free·1 premium

Also set under RUN MODE, but these do not fight anything. They automate the housekeeping around a session instead.

Sell Box(link to this section)Free

Sells boxed Pokémon to vendors for quick cash, with a price threshold so it does not sell something valuable.

Long catching runs fill boxes. This clears them and turns them into money without you sorting through anything by hand.

Mail Claim(link to this section)Free

Collects mail from the PC automatically, so rewards and deliveries do not sit unclaimed while the bot works.

GTL Sniper(link to this section)Premium

Watches the Global Trade Link for listings under a price you set and buys them.

It reports every purchase through Discord, and tells you when it found something and could not afford it — usually the signal to move money into the account. The SESSION panel tracks everything it has picked up so you can see what a run actually earned.

Set the price threshold deliberately. Too high and it buys things you did not want; too low and it watches listings go past all night.

04

Behaviors

2 free·6 premium

Set under MOVEMENT MODE. This decides how the bot finds encounters. It pairs with a Run Mode, which decides what happens once one starts.

The plain modes pace a pattern and are free. The Auto modes follow a saved route and manage their own PP — those are Premium, because routes are.

Walk(link to this section)Free

Walks automatically to trigger encounters, back and forth in a fixed pattern.

Choose the pattern under the same panel:

PatternShape
Left RightSide to side
Up DownVertically
SquaresA square circuit
RandomUnpredictable

Prefer Random unless the terrain forces a shape. It costs nothing and is the least patterned to anyone watching.

Fish(link to this section)Free

Fishes automatically using the rod in your assigned hotkey slot, reeling in and recasting on its own.

Sweet Scent(link to this section)Premium

Uses Sweet Scent to force encounters instead of walking into them — far faster per encounter, and completely silent in terms of movement.

It runs until the move's PP is exhausted. Pair it with Auto Leppa to keep going, or use Auto Sweet Scent below to have a route handle it.

Auto Walk(link to this section)Premium

Walks a saved route rather than pacing a fixed pattern, restoring PP on its own when it runs low.

This is the difference between a bot that runs for twenty minutes and one that runs overnight.

Auto Fish(link to this section)Premium

The same for fishing: follows a route between fishing spots and keeps itself topped up.

Auto Sweet Scent(link to this section)Premium

Follows a route, forcing encounters with Sweet Scent at each stop and restoring the PP it needs to keep doing so.

The fastest sustained encounter rate in the bot. If you are hunting a specific species in a known area, this is usually the answer.

Safari Auto Walk(link to this section)Premium

Auto Walk for the Safari Zone, aware that Safari rules are different — bait and rocks instead of battles, and a step limit that ends the run.

Safari Auto Fish(link to this section)Premium

The same for fishing inside the Safari Zone.

Choosing a pairing(link to this section)

Some combinations are much better than others:

GoalMovement ModeRun Mode
Shiny huntingAuto Sweet ScentRun
MoneyAuto WalkPay Day
Money + itemsAuto WalkPay Day + Thief [MIXED]
Filling a dexAuto WalkCatch
LevellingWalkFight
Safari huntingSafari Auto WalkSafari
Free shiny huntWalkRun
05

Routes

2 premium

A route is a recorded path the bot walks, with the moves and items it needs along the way. Routes are what turn a bot that paces a corridor into one that runs unattended for hours.

All of this is Premium. Free accounts still get Walk and Fish in a fixed pattern.

Automatic Routes(link to this section)Premium

More than 70 preconfigured routes across five regions — Kanto, Johto, Hoenn, Sinnoh and Unova — built and tested so you can pick one and press start.

Route names tell you what they are for. A name ending _Fish is a fishing route; _Safari_Walk is a Safari walking route; _Repel means the route expects repels in your bag. Pick one that matches the Movement Mode you selected — an Auto Fish route in Auto Walk mode will not do anything useful.

Before you start a route(link to this section)

Three things. Nearly every "the route did not work" report is one of them:

  1. You are standing where the route begins. Routes are recorded from a start point and do not path you to it.
  2. You have the items it needs — PP restoratives for Sweet Scent routes, a rod for fishing routes, repels where the name says so.
  3. The moves are on the Pokémon the route expects, in the slots it expects.

Custom Routes(link to this section)Premium

Record a path by walking it. Press RECORD, walk the circuit, press it again. That becomes an editable route.

Then open it in the visual editor, which is where the real work happens:

  • Move points — drag a waypoint to where it should actually be
  • Retime steps — change how long the bot holds a direction
  • Insert and delete — add a step you missed, remove one that overshoots
  • Random route variables — mark parts of the route as varying, so it is not walked identically every lap

That last one matters more than it looks. A bot tracing a pixel-identical path for six hours is describing itself to anyone watching. Random variables make each lap slightly different — a different turn point, a different pause — without changing where the route goes or what it does.

The route list also supports DUPLICATE, RENAME and DELETE, so building a variant of a working route does not mean starting over.

Sharing routes(link to this section)

Routes are files. Copy one to another machine and it works, or send it to someone else and they can run it.

If you build something good for a region that is underserved, the Discord is the place to post it.

06

Features

12 free·1 premium

Options that attach to whatever Run Mode and Movement Mode you have chosen. Everything on this page is available to free accounts unless it says otherwise.

Catch Shiny(link to this section)Free

Catches any shiny it finds, whatever else it was doing. A shiny that appears during a money farm is still a shiny.

Leave this on. There is no scenario where you want the bot to walk away from one.

Anti AFK Shiny(link to this section)Free

Stops the bot when a shiny appears and alerts you, instead of catching it automatically.

Use it when you would rather handle a shiny yourself — a safer ball, a status move, a specific approach. The bot goes idle and waits rather than risking the encounter.

Combined with the Discord alert this is the standard AFK shiny hunt: the bot hunts, and the moment it finds something your phone tells you.

IV 31(link to this section)Premium

Checks IVs and keeps only Pokémon with a 31 in a stat you care about.

This turns a catching session into a breeding-stock session. Without it you get a box to sort by hand; with it, only the ones worth keeping.

Switch(link to this section)Free

Switches to a second Pokémon before throwing balls.

Your lead is built to fight; your catcher is built to catch — the right level to avoid KOs, the right moves, maybe a helpful ability. This lets you run both without compromising either.

Level 1st(link to this section)Free

Switches Pokémon so the first slot gains experience, for levelling something weak behind something safe.

Choose Poké Ball(link to this section)Free

Which ball to throw, with a fallback when you run out.

The fallback matters for long unattended sessions: running out of your preferred ball should not end the run, it should quietly step down to the next one.

Auto Lure(link to this section)Free

Keeps a lure active to raise the encounter rate, reapplying it when it expires.

Worth it on any hunt long enough to outlast one lure.

Auto Refill PP(link to this section)Free

Restores PP between encounters so a session does not quietly end when a move runs dry.

Set this before any unattended run. It is the most common cause of a session that "stopped for no reason".

Auto Leppa(link to this section)Free

Restores Sweet Scent PP specifically, using Leppa Berries.

Sweet Scent burns PP faster than anything else in the bot, which is why it gets its own option. If you are running Sweet Scent or Auto Sweet Scent, turn this on.

Skip Dialogue(link to this section)Free

Clears text boxes automatically. Without it the bot stops at the first NPC line and waits for you.

Skip Evolve(link to this section)Free

Cancels evolutions, so a levelling run does not change a team you configured deliberately.

Skip Learn Move(link to this section)Free

Declines new moves, so a carefully built moveset stays intact.

Auto Login(link to this section)Free

Logs back in automatically when the session drops, instead of leaving the bot sitting at a login screen for hours.

07

Premium Features

11 premium

Everything on this page needs an active subscription. These are the options that make a session survive without you.

Potion System(link to this section)Premium

Heals on HP thresholds rather than waiting for a faint.

Two levels, each with its own item: a lighter one at the first threshold, a stronger one when HP gets genuinely low. Potion, Super Potion and Hyper Potion are all selectable, so routine chip damage is handled cheaply and real trouble gets the good item.

Catch Moves Routine(link to this section)Premium

Status moves before the ball, in an order you choose.

  • False Swipe leaves a target at 1 HP without knocking it out
  • Spore puts it to sleep
  • Substitute and Imprison block moves that would end the encounter — self-KO, roar, teleport

Order matters and the right order depends on what you are catching, which is why it is yours to set rather than fixed. Get it right and difficult catches stop failing; get it wrong and the bot burns balls on something that keeps fleeing or fainting.

Teleport Back(link to this section)Premium

Returns to the route start by teleporting rather than walking, when the bot needs to reset position.

Escape Rope / Dig(link to this section)Premium

Gets the bot out of caves and holes automatically instead of leaving it stuck underground.

Slow Mode(link to this section)Premium

Adds delay between actions for machines or connections where the bot outruns the game.

If actions seem to land in the wrong place or get skipped, this is the fix. It is never a resolution problem with this bot — there is no resolution setting to get wrong.

Multi Target Move (2)(link to this section)Premium

Uses area-of-effect moves against multiple targets where that beats hitting one.

On hordes this multiplies Pay Day income and clears the encounter in fewer turns.

2+ Pay Day(link to this section)Premium

Uses Pay Day from more than one party member, so a single encounter pays out several times.

2+ Thief(link to this section)Premium

The same for Thief — more than one member stealing per encounter.

Discord Bot(link to this section)Premium

Turns the bot from something you watch into something that tells you when it needs you.

Events arrive as direct messages while it runs:

EventSent when
ShinyA shiny appears
IV 31A Pokémon with a 31 IV is caught
CaptchaA captcha appears, and again when solved
Pay DayMoney is collected
ThiefAn item is stolen
Ball throwsA ball is thrown, by type
GTL SniperA purchase succeeds, or is missed for lack of funds
Start / StopThe bot starts or stops

You can also start and stop the bot from Discord with a slash command — a shiny alert arrives while you are out and you stop the run from your phone so the encounter is still there when you get home.

Use /link in the Discord server once to connect your Discord account to your bot account. That link is what tells the relay which DMs are yours.

Security DMs with screenshots(link to this section)Premium

Separately from activity, the bot sends a DM with a screenshot whenever it does something that changes your visibility:

  • switching channel
  • starting a break
  • closing the game

The screenshot is the point. A message saying "switched channel" tells you it happened; the screenshot tells you what the game looked like when it did, which is what you actually want if something went wrong while you were away.

Session summary(link to this section)Premium

The SESSION panel tracks what a run produced — items collected and GTL Sniper purchases — so you can tell whether a route is worth running again.

08

Security

8 free·2 premium

Automation is against PokeMMO's rules. Nothing here makes it allowed, and nothing here makes a ban impossible — the bot never reads or writes game memory and never modifies the client, which is the hardest kind of automation to spot, but "hardest" is not "impossible".

Use an alt account you would not be upset to lose. Anyone selling you a zero-risk bot is lying.

What these options do is remove the patterns that make a bot obvious: perfect timing, infinite sessions, identical paths, instant reactions.

Captcha Solver(link to this section)Premium

Detects PokeMMO's captcha and solves it automatically, logging the image to Discord so you can see what happened.

An unattended bot that hits a captcha and stops is a bot standing motionless in the open for hours. Solving it is both a convenience and a safety feature. You can also set an alert so you know a captcha happened even though it was handled.

Humanize Actions(link to this section)Free

Randomises timing and behaviour so actions do not land on a metronome.

The most valuable option on this page. A human's inputs vary; an unmodified bot's do not, and that regularity is the easiest thing in the world to measure. Leave it on permanently.

Humanize Mouse(link to this section)Free

Moves the cursor along curved paths with small imperfections, rather than teleporting it to exact coordinates.

Instant pixel-perfect cursor jumps are not a thing humans do.

Walk Cycle Guard(link to this section)Free

Stop after x Walkcycles and Alert after x Walkcycles — stop or warn when the bot completes a number of walk cycles without an encounter.

This is the stuck detector. If the bot is pacing somewhere encounters have stopped happening — blocked, moved, or the route drifted — this catches it instead of letting it pace for six hours.

Stop when PM / Alert when PM(link to this section)Free

Watches for private messages and either stops the bot or alerts you when one arrives.

A PM is often another player checking whether anyone is home — sometimes a staff member. Stopping on a whisper means the bot is not visibly ignoring a direct question.

Alert when 0 SS(link to this section)Free

Warns you when Sweet Scent PP hits zero, so a session that has effectively stopped does not look like one still running.

Auto CH Switch [m](link to this section)Free

Changes game channel at a random interval, in minutes.

This limits how long any one observer sees you in the same place doing the same thing. Random intervals matter — switching every exactly-thirty-minutes is its own pattern.

Take a break(link to this section)Free

Take a break every x [m] for x [m] — stops for a while at intervals, then resumes.

A character that plays for fourteen hours without pausing is not plausible. Breaks are the difference between a long session and an obviously automated one, and they cost very little throughput.

Close [m](link to this section)Free

Closes the game after a set number of minutes.

Combined with breaks, this caps a session at a believable length even when nobody is watching the clock.

HWID Spoofer(link to this section)Premium

Changes the network adapter's hardware (MAC) address, with a RESET to put the original back.

This is a heavier measure than the behavioural options above — it changes a system setting rather than the bot's own conduct — so understand what it does before turning it on.

A sensible baseline(link to this section)

For any unattended session:

  • Humanize Actions on
  • Humanize Mouse on
  • Take a break on
  • Captcha Solver on
  • Stop when PM on
  • Walk Cycle Guard on
  • Random walk pattern

That combination costs a little throughput and removes most of what makes a bot look like one.

09

Settings

6 free

Configuration that applies to the bot itself rather than to a particular run.

Profiles(link to this section)Free

Settings are saved to Settings.ini next to the executable, so a working configuration survives restarts and updates.

Profiles let you keep more than one. A shiny-hunting setup and a money-farming setup want very different options, and swapping profiles is faster than rebuilding either by hand. Profile files are plain text and portable — send one to a friend and they load exactly your configuration.

Primary Mouse Button(link to this section)Free

Left Click or Right Click, for left-handed users who have swapped their buttons in Windows.

If the bot seems to click without anything happening, this is worth checking — a swapped primary button means every click lands as the wrong one.

Resolution(link to this section)Free

There is no resolution setting, and that is deliberate.

The bot resolves the game's geometry at runtime and computes its regions from the live client, so it works at any resolution, windowed or fullscreen, at any Windows display scaling. The picker that used to live here was removed because there is nothing left for you to declare.

PokeMMO Directory & GFX Files(link to this section)Free

Points the bot at your PokeMMO install and applies its graphics file adjustments.

Set the directory correctly on first run. Most "the bot cannot find the game" reports are this being wrong or pointing at an old install.

Session(link to this section)Free

A live view of what the current run has produced — counters, items and GTL Sniper activity.

Useful for deciding whether a route is worth running again, which is otherwise guesswork.

Settings File(link to this section)Free

RELOAD re-reads the settings from disk, RESET returns everything to defaults.

Reset is the right first move when a configuration has become confusing and you cannot remember what you changed. It is faster than hunting for the one checkbox causing trouble.

10

Troubleshooting

The problems people actually hit, roughly in the order they hit them.

My antivirus deleted it(link to this section)

Expected, and explained in full on the download page. The bot reads another application's window and sends synthetic input — the same two behaviours a keylogger has — so heuristic scanners flag it regardless of intent.

Verify the SHA-256 from the download page against your file, then exclude the folder. If the checksum does not match, do not run it and tell us in Discord.

My key will not work(link to this section)

Check which button you used. Premium Register is for a first key; Extend Subscription is for renewing. Registering with a renewal key creates a second, empty account.

If it still fails:

  • Confirm the key on your licences page shows Ready to use rather than Awaiting payment
  • Paste it rather than typing it — the alphabet excludes 0, O, 1 and I, but a typo is still a typo
  • A revoked or refunded key will not activate; the licences page says so plainly

It says the licence is locked to another machine(link to this section)

Licences bind to one machine on first use. You get two self-service resets from the licences page — click Reset machine, then sign in again on the new PC.

Out of resets and it is a genuine hardware change? Ask in Discord.

The bot clicks in the wrong place(link to this section)

Not a resolution problem. The bot works out the game's geometry at runtime, so there is nothing to configure and nothing to mismatch.

Check instead:

  • The game window is not covered by another window
  • Primary Mouse Button matches your Windows setting
  • Slow Mode — if the bot is outrunning the game, actions land before the screen has caught up
  • PokeMMO Directory points at the install you are actually running

It stopped on its own(link to this section)

In order of likelihood:

  1. PP ran out. Turn on Auto Refill PP, and Auto Leppa for Sweet Scent runs.
  2. A safety trigger fired. Walk Cycle Guard or Stop when PM did its job — check the log.
  3. A captcha appeared and the solver is off or you are on a free account.
  4. A break started. It resumes on its own.
  5. Your subscription expired. The licences page will say.

It walks off the route(link to this section)

Routes start from a fixed point and do not path you to it. Stand at the start before pressing F9.

If it drifts partway through, the route needs a small edit — open it in the visual editor and correct the step that overshoots. Terrain and NPC positions change; a route recorded months ago can need a nudge.

Discord notifications stopped(link to this section)

In order:

  1. Your DMs are closed. Server privacy settings that block DMs from members block the bot too.
  2. You are not linked, or linked a different Discord account. Run /link again.
  3. Your subscription expired — the Discord bot is Premium.
  4. The bot is not running. Check the session is alive before assuming notifications are broken.

F9 and F10 do nothing(link to this section)

Another application registered them first. The bot says so at startup. Close it and restart, or use the START and STOP buttons.

Still stuck(link to this section)

Ask in Discord with:

  • what you were running (Run Mode + Movement Mode + route)
  • what you expected
  • what happened instead
  • your order reference if it is licence-related

That gets a useful answer far faster than "it doesn't work".

29 features behind the key

Everything marked Premium above — the farming modes, all route automation, the Discord bot and the catch routines. The free tier stays free either way.

These docs are plain Markdown, so a correction is a one-line change. Spot something wrong? Tell us in Discord.