A small bot that keeps "Firestone - Idle Clicker Online RPG" progressing while you are away. It looks at the screen and clicks, like a player would. It never spends gems, never drags the map, and never reads game memory or talks to the network.
- Heroes: presses every green Upgrade button in the heroes menu.
- Guild: claims and restarts expeditions, awakens heroes when affordable, buys personal tree nodes (off by default).
- Guardian: evolves when the red dot shows, trains the guardian you pick.
- Alchemist: collects finished experiments, completes free speed-ups, starts new ones.
- Oracle: claims and starts rituals.
- Research: claims finished research and starts any available one in view.
- Map: claims finished missions and starts new ones while squads are idle, panning across the whole world when the one to start is off screen. Titan missions go first.
A few things only need doing a couple of times a day. They run at the hours set in their
run_at list (Campaign loot and Engineer instead wait every_h hours after their last claim)
and are remembered in state.json, so a restart does not repeat them:
- Arena of Kings: fights the opponent position you choose until the day's attempts are used.
- Free pickaxes: claims them from the guild market's Supplies tab.
- Daily missions: clears both Dungeon fights and every Liberation card.
- Campaign loot and Engineer: claim their chests when the 6 hour timers are up.
- Market: claims the free Mystery box and presses the daily Check In.
- Oracle's gift: claims the free card on the Oracle's Market tab.
Then it pauses (60 seconds by default) and goes again.
- Windows 10 or 11.
- Firestone from Epic or Steam, already running, in English.
- A 1920x1080 monitor at 100% display scaling. The bot maximizes the game window itself.
- The classic hero menu (the one opened with the U key). The "new adventure" layout with hero cards along the bottom is not supported.
- Account level 200 or higher so every feature is unlocked.
The bot refuses to start, with a message saying why, when the game is not running or the window is not 1920x1080.
- Download
FirestoneClicker-<version>-win64.zipfrom the Releases page and unzip it anywhere. - Open
settings.toml(next to the exe) in any text editor and turn off what you do not want. Every feature is on by default except the personal tree. - Start Firestone and get to the main screen.
- Double-click
FirestoneClicker.exe. A console window shows what it is doing; the same text goes tobot.lognext to the exe. - Stop it with Win+Esc or Ctrl+C in the console.
The bot owns the mouse and keyboard while it runs. Do not use the PC for something else at the same time: keystrokes meant for the game would land in whatever window you clicked.
settings.toml controls which features run, which hero slots, alchemist experiments or tree
nodes to use, which guardian to train, the arena opponent, the hours for the once-a-day
features, and the pause between cycles. Changes apply the next
time you start the bot. If you delete the file, the next run recreates the defaults.
The exe is not code-signed, so SmartScreen shows a warning the first time. Click "More info",
then "Run anyway". Some antivirus tools also flag it because it bundles a keyboard-hook
library used for the Win+Esc stop key. If that worries you, the source is right here: run
build.ps1 to build the exe yourself.
FirestoneClicker.exe --checkreports the window it found, the client size, and whether the main-screen markers are visible. Run it on the main screen with no dialog open.FirestoneClicker.exe --once heroesruns a single feature and exits. Feature names:heroes,guild,guardian,alchemist,oracle,research,map_missions,arena,pickaxes,daily_missions,campaign_loot,engineer,market,oracle_gift.--onceignoresrun_atandevery_h.FirestoneClicker.exe --dry-runruns one cycle without clicking anything.- When a feature fails the bot saves a screenshot in
diag/and carries on. If it cannot get back to the main screen three cycles in a row it stops.
Needs Python 3.12 and uv.
uv sync
uv run pytest -q
uv run python -m firestone_clicker
MIT, see LICENSE. The screen coordinates and colour probes derive from
Lutakh/firestone-bot (MIT), itself a port of
Deaeth85's AutoHotkey Firestone Bot. Automating a game may be against its terms of service;
use at your own risk.