Skip to content
01 / 12

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 PokeMMOMinion.Launcher.exe. It checks for an update, applies one if there is one, and then shows 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 UnlockTrying 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.

In PokeMMO itself, there is nothing 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. There is no resolution picker because there is nothing to pick.

Windows display scaling must be 100%. This one is not optional and it is not the same thing as resolution. The bot recognises the game by matching pixel-exact images, and those images were captured at 100%. At 125% or 150% the game draws its text and buttons larger, so the bot fails to find things — encounters, battle buttons, items — usually with no visible error at all.

Settings › System › Display › Scale and layout
Change the size of text, apps and other items → 100%

Sign out and back in afterwards, then restart PokeMMO. The loader checks this at launch and warns you if it is set to anything else, including the case where one monitor is scaled and another is not.

If you have used other screen-reading bots, the resolution picker is the setup step you are looking for and will not find. The scaling requirement is the one that replaces it.

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 action bar matters too. The bot presses numbered slots for your rod, bike, repels, lures and PP restoratives — and it cannot see which slot holds what, so you have to tell it once on the Settings page under ACTION BAR SLOTS. Click a slot, press the key you actually use in game, done.

Until you do, an orange SET UP ACTION BAR pill sits in the title bar on every tab, and any unassigned action is skipped with a line in the status feed rather than pressing something at random.

Your first run(link to this section)

  1. Set your ACTION BAR SLOTS on the Settings page. One-time, and most "it does nothing" reports are this.
  2. Log in to PokeMMO and stand where you want the bot to work.
  3. Pick a Movement Mode and a Run Mode.
  4. Turn on the safety options — at minimum Humanize Actions and a break interval.
  5. 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.

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