# Revolution Macro

> Automate Bee Swarm Simulator with Revolution Macro. Explore AI-powered gathering, quests, planters, and tools to make more of every session.

Revolution Macro is a free desktop app for Windows, macOS, and Linux that automates the Roblox game Bee Swarm Simulator. Revolution Pro is a separate subscription for Red AI and a few power features. The documentation covers installation, gathering, quests, planters, tools, and troubleshooting.

## Site

- [Home](https://revolutionmacro.com/): Automate Bee Swarm Simulator with Revolution Macro. Explore AI-powered gathering, quests, planters, and tools to make more of every session.
- [Download Revolution Macro](https://revolutionmacro.com/download): Get Revolution Macro for Windows, macOS, or Linux. Find download links, setup guides, and community help to start your first Bee Swarm Simulator session.
- [Revolution Pro](https://revolutionmacro.com/pro): Smarter gathering, deeper insights, and control from anywhere. Discover Revolution Pro and make more of every session.
- [Documentation](https://revolutionmacro.com/docs/): Learn how to set up the most advanced macro for Bee Swarm Simulator. Gather honey at fields, farm materials, finish quests and more.

## Getting started

- [Your first Bee Swarm Simulator gather session](https://revolutionmacro.com/docs/getting-started/first-gathering-session/): You've got Revolution Macro installed. Set up your macro to gather in a field, fill your bag, and convert it into honey at your hive.
- [Bee Swarm progression and Revolution Macro setup](https://revolutionmacro.com/docs/getting-started/game-progression/): Learn which Revolution Macro features to turn on at each stage of Bee Swarm Simulator, from your first fields to planters, quests, and alts.
- [Install on macOS for Bee Swarm Simulator](https://revolutionmacro.com/docs/getting-started/install-macos/): Revolution Macro runs on macOS 10.15 and later. Download the DMG from GitHub, grant the permissions it asks for, and start macroing Bee Swarm Simulator.
- [Install on Windows for Bee Swarm Simulator](https://revolutionmacro.com/docs/getting-started/install-windows/): Revolution Macro is a stand-alone Windows app you can download from GitHub and start using right away. This guide covers installing it and your first launch.
- [Import and use presets for Bee Swarm Simulator](https://revolutionmacro.com/docs/getting-started/migrating-presets/): Presets get you up and running with the best macro setup right away. Learn how to import one, keep one for each account, and switch between them.
- [Run Revolution Macro on RDP for Bee Swarm Simulator](https://revolutionmacro.com/docs/getting-started/run-on-rdp/): Learn how to run Revolution Macro and Roblox in an RDP session, so your Bee Swarm Simulator macro keeps farming while you use your PC.
- [What Revolution Macro does in Bee Swarm Simulator](https://revolutionmacro.com/docs/getting-started/what-revolution-does/): Revolution Macro plays Bee Swarm Simulator for you by gathering at fields and converting honey at your hive. Learn what it does and how it works.

## Gathering

- [Choose fields and patterns in Bee Swarm Simulator](https://revolutionmacro.com/docs/gathering/choose-fields-and-patterns/): Learn how to set up your macro to gather in the fields you want, each with its own pattern and settings, and cycle through them in order.
- [Gather settings for Bee Swarm Simulator](https://revolutionmacro.com/docs/gathering/gather-settings/): Learn how your Gather Settings decide how long you gather in a field, when you go back to convert pollen into honey, and which sprinkler you use.
- [Set up hotbar slots and buff timers](https://revolutionmacro.com/docs/gathering/hotbar-and-boosts/): Buffs are essential to improving your honey hourly. Learn how to set up your macro to use items from your hotbar or inventory on a timer.
- [How AI Gather decides where to move](https://revolutionmacro.com/docs/gathering/how-ai-gather-decides/): AI Gather is a revolutionary new way to farm fields. Learn how it detects tokens, scores them, and decides where your macro walks next.
- [Set up AI Gather in Bee Swarm Simulator](https://revolutionmacro.com/docs/gathering/set-up-ai-gather/): Configure your macro to walk directly to tokens with AI Gather. Learn how to set it up and prioritize the tokens you need for your hive color.
- [Why AI Gather](https://revolutionmacro.com/docs/gathering/why-ai-gather/): Patterns like Kettle have been the meta for years, but they can't collect every token. AI Gather detects where tokens are and lets you choose which to collect.

## Collect and quests

- [Automate quests in Bee Swarm Simulator](https://revolutionmacro.com/docs/collect-and-quests/automate-quests/): Learn how to set up your macro to receive, progress, and submit repeatable quests for glue, tickets, fruits, and other rewards while you gather.
- [Beesmas collectables in Bee Swarm Simulator](https://revolutionmacro.com/docs/collect-and-quests/beesmas-collectables/): Learn how to set up your macro to collect Stockings, Feast, Samovar, and other Beesmas decorations while it gathers during the event.
- [Automate dispensers and wealth clock](https://revolutionmacro.com/docs/collect-and-quests/dispensers-and-wealth-clock/): Wealth Clock is the most essential dispenser. Learn how to set up your macro to collect it, plus glue, fruit, and other dispensers, as soon as they're ready.
- [Memory Match in Bee Swarm Simulator](https://revolutionmacro.com/docs/collect-and-quests/memory-match/): Memory Match is a mini-game that awards loot. Learn how to set up your macro to play it on cooldown and skip the loot you don't want.

## Bosses and buffs

- [Set up Auto Field Boost in Bee Swarm Simulator](https://revolutionmacro.com/docs/bosses-and-buffs/auto-field-boost/): Learn how to set up Auto Field Boost so your macro keeps your gather field boosted with dice and glitter on a schedule.
- [HQ boosters, Sticker Stack, and Wind Shrine setup](https://revolutionmacro.com/docs/bosses-and-buffs/boosters-and-shrine/): Learn how to set up HQ boosters, Sticker Stack, and Wind Shrine so your macro keeps your field and combat buffs going.
- [Set up bug runs in Bee Swarm Simulator](https://revolutionmacro.com/docs/bosses-and-buffs/bug-runs/): Bug runs are an essential way to farm materials. Learn how to set up your macro to kill Ladybugs and other field bugs as soon as they respawn.
- [Set up Mondo Hop and Mondo Chick](https://revolutionmacro.com/docs/bosses-and-buffs/mondo-chick-and-hop/): Learn how to set up Mondo Hop so your macro hops servers during the Mondo Chick window, then searches for it, kills it, and collects the loot.
- [Stump Snail in Bee Swarm Simulator](https://revolutionmacro.com/docs/bosses-and-buffs/stump-snail/): Learn how to set up your macro to fight Stump Snail and handle the amulet choices for you.

## Planters

- [Edit the Planter Studio timeline](https://revolutionmacro.com/docs/planters/planter-timeline/): Revolution Macro makes it easy to create your own planter schedules. Learn how to place, drag, resize, and edit planter tracks in Planter Studio.
- [Set up auto planters in Bee Swarm Simulator](https://revolutionmacro.com/docs/planters/set-up-auto-planters/): Your nectar uptime is critical to your honey hourly. Learn how to set up Auto Planters to build and refresh planter schedules for the nectars you need.

## Tools

- [Auto-Jelly for Bee Swarm Simulator](https://revolutionmacro.com/docs/tools/jelly-tool/): Learn how to set up Auto-Jelly so your macro rolls royal jelly until it lands a bee that matches your filters.
- [Set up RBC alt gather in Bee Swarm Simulator](https://revolutionmacro.com/docs/tools/rbc-alt-gather/): Learn how to set up RBC Gather. Revolution Macro can automatically send your alts to your main's quest fields during Robo Bear Challenge.
- [Server Hop for Bee Swarm Simulator](https://revolutionmacro.com/docs/tools/server-hop/): Learn how to set up Server Hop so your macro joins new public servers for you. Need stingers? Follow the Vic Hop guide instead.
- [Set up Tad Sync in Bee Swarm Simulator](https://revolutionmacro.com/docs/tools/tadsync/): Learn how to orchestrate alts for endgame blue setups. Revolution Macro can keep every alt on your main's field while it uses the HQ booster.
- [Set up Vic Hop in Bee Swarm Simulator](https://revolutionmacro.com/docs/tools/vic-hop/): Learn how to set up Vic Hop to hop night-time servers and search for Vicious Bees.

## Multi-account

- [Connect accounts with relay in Bee Swarm Simulator](https://revolutionmacro.com/docs/multi-account/connect-accounts-relay/): A relay is how your Revolution Macro accounts talk to each other. Learn how to connect them so Vic Hop, Tad Sync, and other alt tools work.

## Settings

- [Appearance and theming for Bee Swarm Simulator](https://revolutionmacro.com/docs/settings/appearance-and-theming/): Learn how to switch Revolution Macro between light and dark themes and set your own background image.
- [Capture and diagnostics in Revolution Macro](https://revolutionmacro.com/docs/settings/capture-and-diagnostics/): Learn what Revolution Macro's capture settings do, and which ones to change when the macro can't see Roblox or detection keeps failing.
- [Set up a Discord webhook and bot](https://revolutionmacro.com/docs/settings/discord-webhook-and-bot/): Revolution Macro makes it easy to monitor your macro without watching your PC. Learn how to set up a Discord webhook for hourly updates, or a bot for more.
- [Game settings for Bee Swarm Simulator](https://revolutionmacro.com/docs/settings/general-game-macro/): Learn how to set your hive claim, movespeed, and routing so your macro joins the right hive and walks the map correctly.
- [Hotkeys for Bee Swarm Simulator](https://revolutionmacro.com/docs/settings/hotkeys/): Learn how to set the hotkeys that start, pause, and stop your macro, so you can control it from the keyboard.
- [Presets for Bee Swarm Simulator](https://revolutionmacro.com/docs/settings/presets/): Learn how to create, import, switch, and share presets, so each of your accounts keeps its own settings and playstyle.

## Troubleshooting

- [Fix detection failed in Revolution Macro](https://revolutionmacro.com/docs/troubleshooting/detection-problems/): When Revolution Macro can't detect your hive, nectars, or quests, troubleshoot common display issues that are usually the cause.
- [Doesn't join back after a disconnect](https://revolutionmacro.com/docs/troubleshooting/disconnect-and-rejoin/): When your macro gets disconnected and never rejoins Bee Swarm Simulator, troubleshoot the settings and Roblox issues that usually cause it.
- [Fix Access is denied in Revolution Macro](https://revolutionmacro.com/docs/troubleshooting/install-and-permission-problems/): When Revolution Macro won't start, your settings reset every launch, or macOS keeps dropping permissions, troubleshoot the most common causes.
- [Macro stuck or resets in Revolution Macro](https://revolutionmacro.com/docs/troubleshooting/macro-resets-or-stuck/): Your character keeps resetting, walks to the wrong field, or never converts. Troubleshoot the settings that can cause most of these problems.
- [Fix high CPU and RAM in Revolution Macro](https://revolutionmacro.com/docs/troubleshooting/performance-and-memory/): When Revolution Macro uses too much CPU or memory, troubleshoot the AI Gather and capture settings that usually cause it on low-end PCs.
- [Failed to harvest planter in Revolution Macro](https://revolutionmacro.com/docs/troubleshooting/planter-cycle-failures/): When your macro fails to harvest planters or Auto Planters leaves your schedule empty, troubleshoot the most common causes.
- [Relay connection problems in Revolution Macro](https://revolutionmacro.com/docs/troubleshooting/relay-and-connection-problems/): When your accounts won't connect over a relay, troubleshoot the configuration issues that usually cause it, so Vic Hop and Tad Sync can work.
- [Roblox won't open in Revolution Macro](https://revolutionmacro.com/docs/troubleshooting/roblox-launcher-loops/): When you press Start and Roblox never finishes opening, troubleshoot the launcher and game loading issues that usually cause it.
- [Vic Hop not finding Vicious Bees](https://revolutionmacro.com/docs/troubleshooting/vic-hop-failures/): When Vic Hop never finds a Vicious Bee or your alts never pull in your main, troubleshoot detection, Roblox launcher, and relay issues.

## Scripting

- [Custom gather patterns in Bee Swarm Simulator](https://revolutionmacro.com/docs/scripting/custom-patterns/): Learn how to install a custom gather pattern in Revolution Macro, copy its field settings, and test it from the console.
- [Writing your first gather pattern](https://revolutionmacro.com/docs/scripting/lua-overview/): Learn how to write your first Lua gather pattern for Revolution Macro, starting with a tiny path you'll code and run yourself.
- [Pattern API for Bee Swarm Simulator](https://revolutionmacro.com/docs/scripting/pattern-api/): Use the Pattern API as a reference while you write your own gather patterns. Learn every Lua call, from walking to camera rotation.

## AI Studio

- [AI Studio docs](https://revolutionmacro.com/docs/ai-studio/): Learn how to customize the way AI Gather moves with AI Studio. Build rules for the tokens you care about, test them, and send them to your macro.
- [Actions and action rules](https://revolutionmacro.com/docs/ai-studio/actions-and-action-rules/): Configure your macro to return to the sprinkler, run a pattern, wait, or rotate the camera with action rules. Learn how to write one in AI Studio.
- [AI Studio problems](https://revolutionmacro.com/docs/ai-studio/ai-studio-problems/): When AI Studio won't connect to Revolution Macro, won't save, or your edits don't change how the macro gathers, troubleshoot the most common causes.
- [Which editor fixes what](https://revolutionmacro.com/docs/ai-studio/choosing-your-lever/): AI Studio has several ways to change a decision your macro makes. Learn which one to use for the token, buff, or part of the field you want to change.
- [Edit Pattern Maker paths on the canvas](https://revolutionmacro.com/docs/ai-studio/edit-patterns-on-canvas/): Learn how to reshape a Pattern Maker route by dragging it on the canvas, repeat moves in a loop, and play it back before your macro runs it.
- [Shape your field with Field Zones](https://revolutionmacro.com/docs/ai-studio/field-zones/): Configure your macro to prefer or avoid parts of a field with Field Zones. Learn how to draw a zone and check how it changes token scores.
- [Your first movement rule](https://revolutionmacro.com/docs/ai-studio/first-movement-rule/): Learn how to add your first AI Studio rule with the guided wizard, see how it changes Melody's score, and save it for your macro to use.
- [Get started with AI Studio](https://revolutionmacro.com/docs/ai-studio/get-started/): Learn how to get started with AI Studio. Find out the two things to know before you click anything, and start your first rule.
- [AI Studio glossary](https://revolutionmacro.com/docs/ai-studio/glossary/): Learn what every word in AI Studio means, from profiles and scenarios to Trace, gates, High Value, and field overrides, in plain language.
- [How scoring works](https://revolutionmacro.com/docs/ai-studio/how-scoring-works/): AI Gather gives every token a score and walks to the highest one. Learn how that score is built, then change one number and predict the new winner.
- [Interrupt rules](https://revolutionmacro.com/docs/ai-studio/interrupt-rules/): Configure your macro to finish a return, a wait, or a token it has almost reached with interrupt rules. Learn how to write one and test it.
- [Link a movement profile to Revolution](https://revolutionmacro.com/docs/ai-studio/link-movement-profile/): Learn how to link AI Studio to Revolution Macro so you can start a gather from AI Studio, reload your rules while it gathers, and record sessions.
- [Movement profile reference](https://revolutionmacro.com/docs/ai-studio/movement-profile-reference/): Learn what each part of an AI Studio movement profile does, from hive layers and field overrides to rule types and save states.
- [Pattern Maker Lua reference](https://revolutionmacro.com/docs/ai-studio/pattern-lua-reference/): Learn which Lua calls Pattern Maker can preview, which ones it skips, and the limits that apply when you write a route by hand.
- [Patterns in AI Studio](https://revolutionmacro.com/docs/ai-studio/patterns/): Learn how to draw a route in Pattern Maker and save it to your profile, so your macro can run it when an action rule's conditions are met.
- [Rule conditions reference](https://revolutionmacro.com/docs/ai-studio/rule-conditions-reference/): Learn what every AI Studio rule condition checks, from buffs and abilities to distance, zones, and the token your macro is walking toward.
- [Use Simulator and scenarios](https://revolutionmacro.com/docs/ai-studio/simulator-and-scenarios/): Learn how to use the AI Studio Simulator to see why your macro picked a token, and rebuild the moment you saw in the field to test a fix.
- [Save and sync a movement profile](https://revolutionmacro.com/docs/ai-studio/sync-and-apply/): Learn how to save your AI Studio profile so your macro uses it, reload changes while it gathers with Live Apply, and find your profile files.
- [Read a gather recording in Test Bench](https://revolutionmacro.com/docs/ai-studio/test-bench/): Learn how to replay a real gather in AI Studio's Test Bench, one decision at a time, and see exactly why your macro picked each token.
- [Change one thing, then check it](https://revolutionmacro.com/docs/ai-studio/the-tuning-loop/): Learn how to tune an AI Studio profile one change at a time, test each change on a scenario and a real gather, and remove what didn't help.
- [Token rules and High Value](https://revolutionmacro.com/docs/ai-studio/token-rules/): Configure how your macro values each token with Token Rules, and make sure rare tokens like Bear Morph always come first with High Value.
- [Tuning basics](https://revolutionmacro.com/docs/ai-studio/tuning-basics/): Configure how far your macro will walk for a token with the walk distance curve. Learn how to change it in AI Studio and check the result.
- [Tuning settings reference](https://revolutionmacro.com/docs/ai-studio/tuning-settings-reference/): Learn what every AI Studio Tuning setting does, from walk distance and cluster bonus to returns and Red hive settings.
- [Watch a gather and find one thing to change](https://revolutionmacro.com/docs/ai-studio/watch-a-gather/): Learn how to run a gather from AI Studio, replay it, and find the one decision you'd want your macro to make differently.
- [About AI Studio](https://revolutionmacro.com/docs/ai-studio/what-ai-studio-is/): Revolution Macro offers a powerful tool called AI Studio to customize how AI Gather moves. Build and test the rules that AI Gather uses to pick tokens.