Tutorial

Let's set up your personal bot. First, download it from the download page or from GitHub, then unzip it into any directory on your device.

In the downloaded folder, find the file specific to your platform and double-click it to start the bot. It will now install the required binaries into a virtual environment.

Wait until everything is installed. The bot should start automatically afterwards.

The first time you start the bot, you should see a notification with some instructions. Follow them carefully, and once everything is set up correctly, you'll be able to press the Start Bot button. Be aware that MTG Arena must already be open at this point.

Choose your desired game mode. The default mode is “Starter Deck”, where the bot plays with the starter decks from Magic Arena, so you don't need any wildcards.

Then go back to the main menu and press Start Bot. The bot now plays autonomously, queuing for the next match on its own once a game ends. If you want the bot to play with the starter decks, choose Starter Deck mode and click the Start Bot button. The bot will then select a deck automatically.

The other game mode is “Historic”, where you can use the recommended decks and should reach a better win rate. You will also need to select a deck of your choice before starting the bot. Check out the Decks section to see which decks work well with the bot.

Building your own decks

If you want to build your own decks for the bot, keep in mind what it can and cannot play. The bot does not work out the rules for itself. It picks from the plays Magic Arena offers it, and that sets a hard limit on which cards actually do anything in its hands.

Works

• Lands. One per turn, chosen by which casts it unlocks.
• Creatures, instants, sorceries, enchantments, artifacts. Any spell it can pay for. Colors, cost reductions and Convoke are all checked.
• Mana abilities. Including duals and utility lands.
• Attacking and blocking. The bot only ever picks from the attacks and blocks Arena itself offers, so every evasion keyword works without the bot knowing it exists: Flying, Reach, Menace, Trample, First Strike, Deathtouch, “can't block”, Summoning Sickness.
• Static and triggered abilities. They resolve by themselves, so nothing has to be clicked. Lords, ETB triggers, death triggers and anthem effects all work.
• Removal. Targeted, only at creatures actually on the battlefield, with Ward cost priced against the mana left over.
• Buff auras and pump spells. Only with one of your own creatures on the board.
• Counterspells. The one reactive line: a counterable spell on the stack plus a payable counter in hand.
• Lifegain payoffs. “Whenever you gain life, put a +1/+1 counter” creatures are deployed ahead of equal alternatives.
• Kicker spells. Always cast without the kicker.
• Search-your-library spells. The browser and the card-ordering window that follows are handled, for example Circuitous Route.
• Scry and Surveil.

Two activated abilities, by name only

• Phoenix Chick
• Reassembling Skeleton

Does not work

• Every other activated ability. Tap abilities, sacrifice outlets, Equip, Adapt, Level Up, Planeswalkers.
• Instants at instant speed. Only counterspells are cast reactively, everything else is played in your own main phase.
• Flash.
• Modal spells chosen by situation. The bottom option is always taken.
• Graveyard recursion worded “return a/an/one … from your graveyard”. It is skipped outright, because the chooser is not clickable.
• A second copy of a legend already on your board.
• Mulligans. The opening hand is always kept.

Manage Accounts

Open Settings → Manage Accounts in the bot's interface. Here you can choose whether the bot switches accounts by Time or by Quests. If you choose Time, set the interval after which the bot should switch to the next account, for example 15 min. If you choose Quests, set the number of quests the bot needs to finish before it switches accounts (choose 3 if you want it to finish all quests), and optionally the number of wins (0-15) it needs to reach first. Confirm your settings with the Save button.

Enter the accounts you want to run in the list below, then set the order in which they should be logged in at the bottom of the window.

Rename your decks by color

Open your decks in Magic Arena and rename each one using a color abbreviation. The bot uses these names to pick the right deck for the active color quest.

Take a screenshot of each deck thumbnail

Capture each deck's thumbnail (as shown below) so the bot can visually recognize the deck on screen.

Save screenshots into the Accounts folder

Save each screenshot inside the Accounts folder, under a subfolder named after the matching account. Name each image the same way as the deck. For example, a Black deck is saved as B.png.

Open Settings → Bot Behavior in the bot's interface and tick Enable Forge Engine (experimental) under “Decision engine”. The first time you tick it, the bot downloads the engine once (about 85 MB, Windows only). Once it shows Engine installed. you are ready to go.

With the box ticked, the open-source Forge rules engine and its AI decide how to play. At every decision Forge looks at the current game and picks the lands, spells, abilities, attacks, blocks, targets and scry choices. The bot then carries out those plays with its own clicks, which should lead to smarter games and a better win rate.

Whenever Forge has no answer, for example while it is still starting or when it times out, the bot simply decides as before. The mulligan always stays with the bot. The engine needs about 2 GB of RAM, so untick the box if your PC runs short on memory.