On this page
- What You Need Before You Install Natro Macro
- Step 1: Download Natro Macro From GitHub
- Step 2: Extract the Zip Properly
- Why You Do Not Need to Install AutoHotkey
- Step 3: Deal With Antivirus Before It Deals With You
- Step 4: Run START.bat and Watch the First Launch
- Step 5: Check Your Windows and Roblox Settings
- Step 6: Set the Basics in the Settings Tab
- Step 7: Do a Short First Test Run
- Where Natro Macro Saves Your Settings
- Optional: Start Natro Macro Automatically With Windows
- Getting Help If the Install Still Fails
- FAQ
Installing Natro Macro takes about five minutes, and most of the problems people run into later come from those five minutes. A file left inside the zip, an antivirus that quietly removes AutoHotkey32.exe, a laptop set to 125% display scale. This guide walks through the whole process in the order you will actually do it, with the exact messages the macro and its launcher show you, so you know what is normal and what needs fixing.
Everything here applies to the current release, Natro Macro v1.1.2 (released March 8, 2026). Natro Macro runs on Windows only, so if you play Bee Swarm Simulator on a Mac, phone or console, it will not work for you.
What You Need Before You Install Natro Macro
Natro Macro is light. The release zip is only around 7 MB, and it carries everything it needs to run. You still want these in place before your first launch:
- A Windows PC. The project describes itself as "A Bee Swarm Simulator macro for Windows", and it relies on Windows features such as the
.batlauncher, the registry and Windows OCR. - The standard Roblox Player from
roblox.com/download. The Microsoft Store (UWP) version of Roblox is not supported in the current release. - Windows display scale at 100%. The macro reads pixels on your screen, and scaling moves those pixels. More on this below and in our Roblox and Windows settings guide.
- Bee Swarm Simulator, the Roblox game by Onett (open it on Roblox).
- A folder you can write to, such as Downloads, Desktop or Documents. Protected folders like Program Files cause permission errors.
You do not need to install AutoHotkey. That surprises a lot of people who remember older macro tutorials, so we explain why in its own section.
Step 1: Download Natro Macro From GitHub
Natro Team publishes every version on the official GitHub releases page, and the only other official source is their Discord server. The project README states it plainly: they do not have a website, and the only official place to download is the repository and discord.gg/natromacro. Any page offering a "Natro Macro installer" .exe is not the real thing.
The button below points straight at the latest official GitHub release:
Direct download from the official GitHub release
If you prefer to grab it yourself, open the latest release on GitHub, scroll to Assets and click the zip file. For the current version the file is Natro.Macro.v1.1.2.zip. Recent releases use dots in the name (for example Natro.Macro.v1.1.2.zip), while the README still shows the older underscore style, so do not worry if the name looks slightly different from tutorials.
Ignore the two "Source code" links GitHub adds to every release. Those are automatic snapshots of the repository, and the release zip is the one that is packaged for players. Need an older build? Our Natro Macro download page lists every version with links to its GitHub release.
Step 2: Extract the Zip Properly
This is the step people skip. Windows lets you double-click into a zip and even "run" files from inside it, which makes it look like the macro is installed when it is not. Files opened that way live in a temporary folder, the macro cannot save settings next to itself, and nothing works the way it should.
- Find the zip. Open your Downloads folder (or wherever your browser saved it).
- Right-click it and choose Extract All. Pick a simple location such as Downloads or Desktop and confirm.
- Open the extracted folder. The README describes it as opening
Natro_Macro_v#.#.#and double-clicking the folder inside. You are in the right place when you can seeSTART.batplus thesubmacros,patternsandpathsfolders.
Do not extract into C:\Program Files or another protected folder. If Natro Macro cannot write there it shows: "You must run Natro Macro as administrator in this folder! If you don't want to do this, move the macro to a different folder (e.g. Downloads, Desktop)". Moving the folder is the cleaner fix.
What START.bat Does If You Forget to Extract
Since v0.9.7, Natro Macro ships with a launcher that tries to save you from this mistake. If you run START.bat from inside an unextracted zip, it searches for the zip in your user folders: Downloads, Downloads\Natro Macro, Desktop, Documents, and the OneDrive versions of Downloads, Desktop and Documents. When it finds the zip, it extracts it there, deletes the original .zip, and prints "Unzip complete! Starting Natro Macro in 10 seconds."
Two things to know about that behavior. First, the zip is gone afterwards, so keep a copy elsewhere if you like to hold on to old versions (or just re-download from GitHub). Second, if the zip is somewhere else, the auto-extract fails with this message:
Unable to automatically extract Natro Macro! - If you have already extracted, you are missing important files, please re-extract. - If you have not extracted, you may have to manually extract the zipped folder.
The fix is simply to do Step 2 by hand.
Why You Do Not Need to Install AutoHotkey
Natro Macro is written in AutoHotkey v2, a free scripting language for Windows automation. Before v0.9.6 you had to install AutoHotkey yourself. Since that release, Natro Macro includes AutoHotkey in its own folder, "removing the need for users to install AutoHotkey."
Inside submacros you will find AutoHotkey32.exe and AutoHotkey64.exe, both version 2.0.12. The launcher runs submacros\AutoHotkey32.exe submacros\natro_macro.ahk, and the main script forces the 32-bit interpreter: if it is started in 64-bit, it reloads itself with AutoHotkey32.exe. So even if you already have a different AutoHotkey version installed, the macro uses its bundled copy and the two do not conflict.
Curious about the language itself? The AutoHotkey v2 documentation is the best reference, but you do not need any of it to use the macro.
Step 3: Deal With Antivirus Before It Deals With You
Some third-party antivirus programs flag AutoHotkey executables because the same language that automates key presses can be misused by other software. The usual symptom: you extract the macro, run START.bat, and get this message instead of the Natro window:
Could not find submacros\AutoHotkey32.exe! This is most likely due to a third-party antivirus deleting the file: 1. Disable any third-party antivirus software (or add the Natro Macro folder as an exception) 2. Re-extract the macro and check that AutoHotkey32.exe exists in 'submacros' folder 3. Run START.bat. Note: Both Natro Macro and AutoHotkey are safe and work fine with Microsoft Defender!
Here is how we handle it:
- Open your antivirus quarantine or history and confirm it removed
AutoHotkey32.exefrom the Natro Macro folder. - Add the whole Natro Macro folder as an exclusion in that antivirus (not just the single file, since updates replace files).
- Delete the broken folder, extract the zip again, and check that
submacros\AutoHotkey32.exeis there. - Run
START.batagain.
Only do this for a zip you downloaded from the official GitHub release. Our page on whether Natro Macro is safe explains false positives, how to check the file yourself and how to add a Windows Security exclusion step by step.
Step 4: Run START.bat and Watch the First Launch
Double-click START.bat. A console window appears briefly, then the Natro Macro window opens. While it loads, the title reads "Natro Macro (Loading N%)". The first launch takes a little longer because the macro creates its settings folder and default config files.
On load, Natro Macro also does a few checks you might notice:
- Update check. It asks the GitHub releases API whether a newer version exists. If one does, you will see an update prompt and a red icon next to the version number. See how to update Natro Macro.
- Display scale check. If Windows is not at 100%, you get: "Your Display Scale seems to be a value other than 100%. This means the macro will NOT work correctly!"
- Roblox check. If it finds the Microsoft Store version, it warns "UWP Roblox installation is detected, Natro Macro currently does not support it." If it finds no Roblox at all: "Unable to detect a Roblox installation."
- Roblox settings check. If your in-game settings are off, the "Incorrect Roblox Settings Detected" window lists what to change.
- Pattern import. Since v1.1.0, the macro asks you to confirm any new or unknown pattern files before importing them, because pattern files can run any AutoHotkey code. The 12 patterns shipped with the release are the standard set.
The main window is small (490 by 275) with tabs across the top: Gather, Collect/Kill, Boost, Quests, Planters, Status, Settings, Misc and Credits. The bottom bar holds "Current Field", the Status box, and the F1 Start, F2 Pause and F3 Stop buttons. Our Natro Macro features overview walks through every tab.
Step 5: Check Your Windows and Roblox Settings
Natro Macro "sees" the game through screen pixels, so it needs Roblox to look the way it expects. These are the settings the macro itself checks and asks for:
| Setting | Required value |
|---|---|
| Windows display scale | 100% |
| Roblox version | Web Roblox Player, not Microsoft Store (UWP) |
| Graphics Quality | Manual, set to lowest |
| Text Size | Lowest |
| Shift Lock | On (the Roblox setting that allows it) |
| Camera Mode | Classic |
| Movement Mode | Keyboard |
| Inverted Camera / Microprofiler | Off |
| Experience Language | English |
| Touchscreen | Disabled in Device Manager (touch laptops) |
After changing display scale, close and restart Roblox before starting the macro, as the warning itself instructs. The full walkthrough, with where each option lives, is in our Natro Macro Roblox settings guide.
Step 6: Set the Basics in the Settings Tab
Before pressing Start, open the Settings tab and fill in the handful of values the macro cannot guess:
- Hive Slot. 1 to 6, counted "(6-5-4-3-2-1)". The default is 6. Match it to the hive you claim.
- My Hive Has: N Bees. Default 50. This decides which zones the macro will travel to (35 bees opens the whole map).
- Movement Speed (WITHOUT HASTE). Default 28. Enter the exact number from your Bee Swarm Simulator stats, decimals included (for example 33.6).
- Sprinkler Type. Default Supreme. Change it if you use a different sprinkler, because Field Drift Compensation relies on the Supreme Saturator.
- Move Method. Cannon by default, or Walk.
- Private Server Link. Optional, but strongly recommended for reconnects. Both the classic
privateServerLinkCodelinks and the newerroblox.com/share?code=...links are accepted.
Each of these is covered in depth in Natro Macro settings and hotkeys.
Step 7: Do a Short First Test Run
Do not leave the macro running overnight on its first day. A ten-minute supervised test tells you whether everything is wired up correctly.
- Join Bee Swarm Simulator and claim your hive, ideally in a private server.
- Keep the defaults on the Gather tab for this test: Sunflower field, Squares pattern, size M, width 3, until 20 minutes or 95% bag.
- Turn off extras on the Collect/Kill, Quests and Planters tabs so you are testing gathering only.
- Press F1. The macro activates Roblox, resets, travels to the field and starts its pattern.
- Watch one full cycle: gather, return to hive, convert, travel back. Stop any time with F3.
If the character walks out of the field, drifts or gets stuck at the hive, the cause is almost always a setting from Step 5 or a wrong Movement Speed. Our Natro Macro troubleshooting guide covers each error message. Once the basic loop works, move on to gather settings and the best patterns for each field.
Where Natro Macro Saves Your Settings
Everything you change is stored in the settings folder inside your Natro Macro folder. The macro creates it on first start. The important files are:
| File | What it holds |
|---|---|
nm_config.ini | Main settings from every tab |
field_config.ini | Saved field defaults used for quests and planters |
manual_planters.ini | Manual planter cycles |
mutations.ini | Auto-Jelly choices |
debug_log.txt | The debug log used for support |
imported\patterns.ahk | Imported pattern data |
Back this folder up from time to time. Since v0.8.4 it has been "safely transferrable between versions", which is exactly what makes updating painless. If you see "Could not create the settings directory!" on launch, the macro is in a folder it cannot write to, so move it to Downloads or Desktop.
Optional: Start Natro Macro Automatically With Windows
If you run the macro on a dedicated PC, Misc > Macro Tools > Auto-Start Manager can launch Natro Macro when you log in to Windows. It adds a "NatroMacro" entry to your user startup list, with an optional delay and a "Start Macro on Run" toggle. Pair it with a private server link and the Discord integration from our Discord bot guide and you can check on your hive from your phone.
Getting Help If the Install Still Fails
When something goes wrong that this page does not cover, collect a debug report first. Press F6, use the tray menu's "Copy Logs", or open Misc > Debug Options > "Copy Logs". The macro copies a report with your OS, resolution and scale, AutoHotkey version, Natro version, install path, Roblox type and any detected problems. Paste it into a help channel on the official Natro Macro Discord. The GitHub issue template reminds users that Natro Macro is maintained by volunteers, so a clear report gets you an answer faster.
That is the whole Natro Macro install: download from GitHub, extract properly, let the bundled AutoHotkey do its job, keep antivirus out of the way, set Roblox up correctly and run a short test. From there, the fun part is tuning your fields, planters and quests.
Frequently asked questions
Do I need to install AutoHotkey to use Natro Macro?
No. Since v0.9.6, Natro Macro includes AutoHotkey in its own submacros folder, so there is nothing extra to install. The bundled AutoHotkey32.exe (version 2.0.12) is what START.bat uses, and the script forces the 32-bit interpreter even if you have another AutoHotkey version on your PC. A separate install will not conflict with it.
Why does START.bat say it could not find AutoHotkey32.exe?
Almost always a third-party antivirus removed the file. Restore or exclude the Natro Macro folder in that antivirus, delete the folder, extract the zip again and confirm submacros\AutoHotkey32.exe exists, then run START.bat. The launcher's own message notes that Natro Macro and AutoHotkey work fine with Microsoft Defender.
Can I run Natro Macro straight from the zip file?
You should not. Files run from inside a zip sit in a temporary location and the macro cannot save settings. START.bat will try to auto-extract the zip if it is in Downloads, Desktop, Documents or their OneDrive versions, and it then deletes the zip. If the zip is elsewhere, extract it manually with Extract All.
Does Natro Macro work on Mac or mobile?
No. Natro Macro is built for Windows only. It uses a Windows batch launcher, the Windows registry, Windows OCR and Windows display APIs, and its GitHub description is "A Bee Swarm Simulator macro for Windows". There is no macOS, Android or iOS version from Natro Team, so be wary of any download claiming otherwise.
Which folder should I install Natro Macro in?
Any normal user folder such as Downloads, Desktop or Documents works well. Avoid Program Files or other protected locations, because the macro needs to create its settings folder. If it cannot write there, it asks you to run as administrator or move the macro to a different folder, and moving it is the simpler fix.
How do I know the Natro Macro install worked?
The Natro Macro window opens with tabs from Gather to Credits and the version number in the bottom-right corner, with no display-scale, Roblox or settings warnings. Then join Bee Swarm Simulator, press F1 and watch one full gather and convert cycle. If the character reaches the field, runs the pattern and returns to convert, you are set.
Keep reading




