Game Bot Creator · Loaded config → +
Getting Started
Everything from creating a config to watching the bot run your first scenario. Almost all of it works identically on Windows and Android — the toggle below switches the few parts that don't.
Create a config
A config holds one game's whole setup — its scenes, actions, and scenarios. Click the + button next to the Loaded config dropdown at the top of the window (or Create Your First Config… on the Start tab if you have none yet).
- Type a name for the config (the game's name works well) and confirm.
- Optionally type the name of the game it's for (shown later in the Configs tab).
Game Bot Creator then asks how the bot should reach this game — that's Part 2 — and which tools it needs: leave the extra ones unticked for a game you only click through menus in; tick Walk a character around using the minimap or Find things that move or look different each time for action games. This only decides what's shown — change it any time with Tools… next to the config selector. Nothing is saved until you finish these questions, so cancelling leaves no half-made config behind.
Connect it to your game
Pick Windows (a linked desktop window) or Android (emulator or device) — this can't be changed later without recapturing everything, so pick whichever matches how you actually play.
Windows
- Make sure the game is already open somewhere on screen.
- Pick it from the list of open windows, or click Later to link one afterward from the Scene Editor's Link Window… button, once the game is actually running.
Android
Pick where the game runs: LDPlayer, another detected emulator (MuMu, MEmu, BlueStacks), or Other ADB device for a phone or tablet. With LDPlayer, your game must already be installed inside it:
- Download and install LDPlayer (a button for this is right in the dialog if it isn't found automatically).
- Launch LDPlayer and install your game inside it — via its own app store, or an APK.
- In that LDPlayer instance: Settings → Other settings → ADB debugging, set to Enable local connection (one-time, per instance).
- Back in Game Bot Creator, click Continue — it picks up your LDPlayer install automatically.
Then:
- Pick which instance this config uses (skipped automatically if you only have one).
- Pick the game's package from the list of installed apps — or click Later to finish both of these afterward from the Configs tab's Link Devices… button.
Build your first scenes
After creating the config you land in the Scene Editor. A scene is one distinct screen or area of your game; here you teach Game Bot Creator to recognize each one, and what it can do there. This example builds two scenes — a Home scene and one it can navigate to and back from.
The pinned 🌐 Global entry at the top of the scene list isn't a real scene: actions added there work in every scene (handy for things like combat or picking up loot). You can ignore it for now.
The Home scene
- Click + Add, name it Home.
- The Scene Marker row is selected; click Capture: drag a box around a small, unique part of this scene that's always visible (a logo or title works well), then drag a slightly larger box around where it should be searched for (or press Esc to skip and search a little around it).
- Click Set as Home — the scene the bot treats as its home base and falls back to for recovery.
A second scene
- Click + Add again, give it a name (e.g. Farm).
- Capture its marker the same way — something only visible on this scene.
- New scenes already get a Back action that presses Esc. If your game leaves this scene some other way (a close button, a fixed point), delete it and add your own via + Add Action → Back.
- Click + Add Action, choose Click Image, and drag a box around a button that does something here (e.g. collects a resource) — name it. Press Esc when done; a short message confirms it's saved.
Wire the navigation
- Select Home in the list.
- Click + Add Action, choose Navigate, drag a box around whatever button on Home opens the second scene, name it, and pick that scene as the destination.
A scene shown in red with ✗ isn't usable yet — select it and the panel on the right says what's missing. Once both are ✓, the bot can path from Home to your second scene, act, and find its way back — automatically.
Build a scenario
A scenario is a list of steps — go to a scene, then run some of its actions — that the bot repeats. Open the Scenario Editor.
- Click + Add — a new scenario is created and selected.
- Name it, and set a Cooldown seconds — how long to wait after it finishes before it can run again.
- Under Flow, click + Add Step: set Navigate to: your second scene, and check the action you added there.
There's no Save button — every change autosaves within about half a second. Run Limit and Prerequisites below the flow are optional; open them when you need them. Each step's navigation computes the shortest path from wherever the bot currently is, so this scenario can run from anywhere reachable, not just from Home.
Run it
The Start page runs scenario sets: a set picks which of a config's scenarios to run, and where. While your config isn't fully set up, a checklist at the top of the Start page shows what's left, with a button for each step.
- Open Start and click + Add Scenario Set.
- Name the set. All of the config's scenarios start ticked — untick any you don't want this set to run.
- Pick the device it runs on. If you clicked Later back in Part 2, link one first via the Configs tab's Link Devices….
- Click Start on the set's row (or Start All).
The bot detects the current scene, paths to your second scene, runs the action, comes back, and waits out the cooldown before doing it again. Watch it happen live in the Logs pane on the Start page. A scenario that can't run is shown in red with the reason, and a set that can't start says why when you hover it.
Selecting a set lists its scenarios on the right. Each has a Run checkbox to switch it on or off for that set, even while it runs. Scenarios you create later aren't added to existing sets automatically — add them with the set's wrench button.
Where to go from here
- Check (in the Add Action picker) detects an image without clicking it — useful as a prerequisite, e.g. "only run this scenario if a resource icon is full."
- Alternates, on a flow step, watch for an unexpected popup (like an ad) mid-step and react without aborting the whole scenario.
- Depends on, on an individual action, makes it wait for another action in the same step to have already fired first.
- Global actions (the 🌐 Global scene) work in every scene. Tick Run in any scene (no navigation) on a scenario to run them right where the bot is, without navigating — e.g. a combat scenario; other scenarios wait while it runs.
- Background scenarios (Run in the background) run alongside the others, only in the scenes you tick (or Any scene) — e.g. drinking a potion when health is low. Pause while other scenarios run makes one wait instead.
- Use Tools… next to the config selector to turn on minimap walking (the Maps page) or AI models (the AI page) for a config — or just pick one of those actions under More actions in the + Add Action picker.
- The AI page trains an object-detection model instead of matching a fixed image — see the Training a Detection Model and Kaggle Training Setup tutorials.
- The Maps page sets up minimap navigation (Go To Waypoint, Go To Icon, Explore); the Jobs page tracks long-running background jobs like training runs.