Troubleshooting Guide

This guide covers common problems and their solutions. Check here before asking for help!

Critical Errors

AutoHotkey32.exe Missing

This is the most common installation issue.

Error Message (from START.bat:31-42):

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!
Join our Discord server for support: discord.gg/natromacro

Solutions:

Check Antivirus Quarantine
- Open your antivirus program
- Check quarantine/vault for AutoHotkey32.exe
- Restore the file
- Add Natro Macro folder to exclusions
Re-extract Macro
- Delete current Natro Macro folder
- Re-download from official source
- Extract to a safe location (Desktop, Downloads)
- Verify AutoHotkey32.exe exists in submacros/ folder
Windows Defender (Safe)
- Natro Macro works fine with Windows Defender
- No exclusions needed for Defender
- Disable third-party antivirus instead

Recommended antivirus: Windows Defender (built-in). Third-party antivirus often causes false positives.

Admin Privileges Issues

Error (from natro_macro.ahk:22509-22516):

Your Roblox window is run as admin, but the macro is not!
This means the macro will be unable to send any inputs to Roblox.
You must either reinstall Roblox without administrative rights, or run Natro Macro as admin!

NOTE: It is recommended to stop the macro now, as this issue also causes hotkeys 
to not work while Roblox is active.

Why This Happens:

Windows security (UIPI) prevents non-admin programs from controlling admin programs
Roblox shouldn’t run as admin, but sometimes does

Solutions:

Solution 1: Reinstall Roblox (Recommended)

Uninstall Roblox completely
Delete C:\Users\YourName\AppData\Local\Roblox
Reinstall Roblox WITHOUT running installer as admin
Launch Roblox normally (not as admin)
Restart Natro Macro

This fixes the root cause permanently.

Solution 2: Run Macro as Admin

Right-click START.bat
Select “Run as administrator”
Accept UAC prompt

Warning: Auto-Start Manager won’t work if macro runs as admin (from natro_macro.ahk:8853-8858):

Natro Macro has been run as administrator!
Auto-Start Manager can only launch Natro Macro on logon without admin privileges.

If you need to run Natro Macro as admin, either:
- fix the reason why admin is required (reinstall Roblox unelevated, move Natro Macro folder)
- manually set up a Scheduled Task in Task Scheduler with 'Run with highest privileges' checked

Solution 3: Move Macro Folder

If Natro Macro is in a protected folder (Program Files, System32), move it:

Extract to C:\Users\YourName\Desktop\Natro Macro
Or C:\Users\YourName\Downloads\Natro Macro
Avoid system folders requiring admin access

Display Scale (DPI) Issues

Error (from natro_macro.ahk:118 & 10450):

Display scale is not set to 100%

Why This Matters:

Macro uses pixel detection and coordinates
Scaling affects pixel positions
Can cause misclicks and detection failures

Solution:

Windows 10/11:
- Right-click Desktop → Display settings
- Scroll to “Scale and layout”
- Set to 100% (not 125%, 150%, etc.)
- Click “Apply”
- Restart Natro Macro
Check Current Scale:
- Run Natro Macro
- Check status/debug info
- Shows current resolution and scale percentage
Per-Monitor Scaling:
- If using multiple monitors, set ALL to 100%
- Or keep Roblox on the 100% scaled monitor

Your screen resolution is fine at any value. Only the scale percentage must be 100%.

Connection Issues

Disconnects

The macro detects and handles disconnects automatically. Detection (from natro_macro.ahk:17622-17632):

disconnectCheck()
{
    ; Checks for disconnect screen bitmap
    pBMScreen := Gdip_BitmapFromScreen(windowX+windowWidth//2 "|" 
                                       windowY+windowHeight//2 "|200|80")
    if (Gdip_ImageSearch(pBMScreen, bitmaps["disconnected"], , , , , , 2) != 1) {
        return 0  ; Not disconnected
    }
    ; Disconnected - start reconnect process
}

Reconnect Process:

Detection - Checks for “Disconnected” screen
Delay - Waits if Daily Reconnect scheduled
Server Selection - Tries Private Server, then Fallbacks
Method - Uses Deeplink (default) or Browser
Retry - Attempts up to 20 times with different servers

Reconnect Methods:

Fastest and most reliable method.
Uses Roblox deeplinks to join directly.
No browser required.

Set in: Settings → Reconnect Method → Deeplink

Common Disconnect Causes:

Private Server Down

Symptom: Repeated disconnects, macro can’t rejoinSolution:

Check if Private Server link still works (open in browser)
Server owner may have shut down server
Use Public Fallback or different Private Server
Enable “Public Fallback” in settings

Internet Connection Issues

Symptom: Frequent disconnects, long reconnect timesSolution:

Check your internet stability
Restart router/modem
Use wired connection instead of WiFi
Close bandwidth-heavy applications

Roblox Server Issues

Symptom: Disconnects affecting all playersSolution:

Check Roblox status: https://status.roblox.com
Wait for Roblox to fix server issues
Use different region servers (Private Servers)

Death Detection

The macro automatically detects when you die. Detection Code (from background.ahk:96-111):

nm_deathCheck(){
    static LastDeathDetected:=0
    if (((nowUnix()-resetTime)>20) && ((nowUnix()-LastDeathDetected)>10)) {
        try
            result := ImageSearch(&FoundX, &FoundY, 
                                windowX+windowWidth//2, windowY+windowHeight//2, 
                                windowX+windowWidth, windowY+windowHeight, 
                                "*50 nm_image_assets\died.png")
        catch
            return
        if (result = 1) {
            if WinExist("natro_macro ahk_class AutoHotkey") {
                PostMessage 0x5555, 1, 1
                Send_WM_COPYDATA("You Died", "natro_macro ahk_class AutoHotkey")
            }
            LastDeathDetected := nowUnix()
        }
    }
}

What Happens:

Detects “You Died” screen
Notifies main macro
Waits for respawn
Continues macro operation
Updates death counter in stats

Death Causes:

Mob Damage - Werewolves, spiders, scorpions, mantises
Tunnel Bear - Failed or incomplete kill
Mondo Chick - Failed fight (from natro_macro.ahk:16182)
Stump Snail - Failed fight
Falling - Rare, usually from lag

Deaths are tracked in Statistics. High death counts may indicate:

Wrong field for your level
Need better bees/equipment
Mobs not being killed properly

GUI & Display Issues

GUI Not Appearing

Cause: Off-screen position or wrong monitor Solution:

Reset Position:
- Close macro
- Open settings\nm_config.ini
- Find [Settings] section
- Set GuiX= and GuiY= to empty
- Save and restart macro
Check Monitor:
- If using multiple monitors, GUI may be on other screen
- Move mouse to other monitors to find it
- Drag back to primary monitor

GUI Transparency Issues

Cause: GuiTransparency setting too high Solution:

In GUI: Settings tab → GUI Transparency
Set to 0 for fully opaque
Adjust to preference (0-10)

Status Bar Not Showing

Cause: ShowOnPause disabled or status bar off-screen Solution:

Enable “Show On Pause” in Settings
Check status bar position
Reset position in config file if needed

Gameplay Issues

Macro Not Moving Character

Cause 1: Admin Privileges (See Above)

Most common cause. See “Admin Privileges Issues” section.

Cause 2: Wrong Roblox Window

Symptom: Multiple Roblox windows openSolution:

Close ALL Roblox windows
Close Natro Macro
Start Natro Macro
Let macro launch Roblox
Don’t open additional Roblox windows

Cause 3: Roblox Not Focused

Symptom: Works when Roblox is focused, stops when notSolution:

This is expected behavior for safety
Macro only sends inputs when Roblox is active window
Don’t minimize Roblox while macro runs
Can use another monitor for other tasks

Cause 4: Key Binds Changed

Symptom: Character moves wrong direction or not at allSolution:

In Bee Swarm Simulator, open Settings
Reset controls to default (WASD movement)
Don’t change keybinds while using macro
Verify: W=Forward, A=Left, S=Back, D=Right

Macro Stuck / Not Progressing

Common Stuck Points:

Stuck at Hive

Possible Causes:

Path to field is broken
Hive slot setting wrong
Collision with other players

Solutions:

Check HiveSlot setting (1-6)
Verify field paths exist
Try different field
Restart macro

Stuck in Field

Possible Causes:

Pattern not working
Character collision
Lag/server issues

Solutions:

Try different pattern (Stationary for testing)
Check pattern files exist in patterns/ folder
Verify MoveSpeedNum setting is correct
Test in different field

Stuck at Planter

Possible Causes:

Can’t find planter location
Planter inventory full
Path to planter broken

Solutions:

Manually place one planter to test
Check planter settings (types enabled)
Verify you have planters in inventory
Test path manually

Unable to Detect GUI Offset

Error (from natro_macro.ahk:22519-22525):

Unable to detect in-game GUI offset!
This means the macro will NOT work correctly!

Causes:

Roblox UI changed
Graphics settings too low
Screen recording software interference
Roblox window too small

Solutions:

Graphics Settings:
- In Roblox, set Graphics Quality to at least 4/10
- Don’t use Graphics Level 1 (minimum)
Window Size:
- Don’t minimize Roblox
- Window must be visible on screen
- Avoid very small window sizes
Recording Software:
- Disable overlays (Discord, GeForce Experience, OBS)
- Some screen capture tools interfere with detection
- Test with all overlays disabled
Restart:
- Close Natro Macro
- Close Roblox
- Restart both (macro first)

Configuration Issues

Settings Not Saving

Cause: Config file permissions or corruption Solution:

Check Permissions:
- Right-click settings\nm_config.ini
- Properties → Security
- Ensure you have write permissions
Reset Config:
- Close macro
- Rename nm_config.ini to nm_config.ini.backup
- Restart macro (creates new config)
- Re-apply your settings
File Location:
- If macro is in OneDrive/Dropbox, sync issues can occur
- Move macro to local folder (Desktop, Downloads)

Private Server Not Working

Invalid Server Link Error:

Private Server Invalid

Cause: Incorrect link format Valid Link Formats:

LinkCode Format

https://www.roblox.com/games/1537690962?privateServerLinkCode=ABC123...
                                        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                                        32-character code after this

ShareCode Format

https://www.roblox.com/share?code=ABC123...&type=Server
                             ^^^^^^^^^^^^^^
                             32-character code

Solution:

Copy FULL link from Roblox
Include https:// at start
Don’t truncate or modify link
Test link in browser first

Performance Issues

Macro Running Slow

Causes & Solutions:

High CPU Usage

Symptom: Computer laggy, macro slowSolution:

Close unnecessary programs
Check for background updates
Verify computer meets minimum specs
Lower Roblox graphics settings

Network Lag

Symptom: Delays in movement, disconnectsSolution:

Check internet speed
Use wired connection
Close bandwidth-heavy apps
Try different server/region

Too Many Planters/Buffs

Symptom: Macro takes long time per cycleSolution:

Reduce active planters
Disable some buff boosters
Increase planter check intervals
Optimize field rotation

Macro Actions Too Fast

Cause: MoveSpeedNum set incorrectly Solution:

Calibrate Move Speed:
- Settings → Movement → Move Speed Num
- Default: 28
- Higher number = faster movement
- Adjust based on your actual speed stat
Test:
- Use “Test Walk” button in settings
- Character should walk in square
- Adjust until square is accurate
Speed Boosts:
- If using bear morph or speed boosts, increase value
- If no speed boosts, keep at ~28

Error Messages

Common Error Codes

Macro cannot find Roblox window.

Solution:
- Launch Roblox through macro
- Don't close Roblox manually
- Check Roblox isn't minimized

Getting Help

Before Asking for Help

Complete this checklist:

Read relevant sections of this guide
Check Discord #faq channel
Verify macro is latest version
Test with default settings
Note exact error messages
Record when issue started
List what you’ve already tried

Information to Provide

When asking for help, include:

Error Message - Exact text, screenshot if possible
What You Were Doing - Step-by-step to reproduce
Macro Version - Check Help → About
System Info:
- Windows version
- Screen resolution and scale
- Antivirus software
Attempted Solutions - What you’ve already tried

Support Channels

Discord Server

Best for quick help, active community, and official support.Channels:

#support - General help
#faq - Common questions
#bug-reports - Report bugs

Debug Mode

For advanced troubleshooting:

Enable debug output in settings
Run macro with debug window open
Note any error messages
Share debug log with support

Preventive Maintenance

Regular Checks

Weekly:

Update macro if new version available
Clear temporary files
Verify all paths/patterns working
Check statistics for anomalies

Monthly:

Backup your settings folder
Review and optimize field rotation
Update planter strategy if needed
Check for Bee Swarm Simulator updates

Backup Your Settings

Close Natro Macro
Copy entire `settings` folder
Paste to safe location (Desktop, Cloud)
Label with date: `settings_backup_2024_03_01`
Keep multiple backups

Restore by replacing current settings folder with backup.

Still Having Issues?

If none of these solutions work:

Fresh Install:
- Backup settings folder
- Delete entire Natro Macro folder
- Re-download latest version
- Extract to new location
- Restore settings
Join Discord:
- https://discord.gg/natromacro
- Post in #support with details
- Staff and community can help
Report Bug:
- If you found a genuine bug
- Post in #bug-reports on Discord
- Include steps to reproduce
- Provide screenshots/videos

Never share:

Your Roblox password
Your Roblox cookie
Personal information

Official support will NEVER ask for these!

Get Started

Core Features

Configuration

Guides

Advanced

Troubleshooting Guide

Critical Errors

AutoHotkey32.exe Missing

Admin Privileges Issues

Display Scale (DPI) Issues

Connection Issues

Disconnects

Death Detection

GUI & Display Issues

GUI Not Appearing

GUI Transparency Issues

Status Bar Not Showing

Gameplay Issues

Macro Not Moving Character

Macro Stuck / Not Progressing

Unable to Detect GUI Offset

Configuration Issues

Settings Not Saving

Private Server Not Working

Performance Issues

Macro Running Slow

Macro Actions Too Fast

Error Messages

Common Error Codes

Getting Help

Before Asking for Help

Information to Provide

Support Channels

Discord Server

Debug Mode

Preventive Maintenance

Regular Checks

Backup Your Settings

Still Having Issues?

Build docs developers (and LLMs) love

Get Started

Core Features

Configuration

Guides

Advanced

​Critical Errors

​AutoHotkey32.exe Missing

​Admin Privileges Issues

​Display Scale (DPI) Issues

​Connection Issues

​Disconnects

​Death Detection

​GUI & Display Issues

​GUI Not Appearing

​GUI Transparency Issues

​Status Bar Not Showing

​Gameplay Issues

​Macro Not Moving Character

​Macro Stuck / Not Progressing

​Unable to Detect GUI Offset

​Configuration Issues

​Settings Not Saving

​Private Server Not Working

​Performance Issues

​Macro Running Slow

​Macro Actions Too Fast

​Error Messages

​Common Error Codes

​Getting Help

​Before Asking for Help

​Information to Provide

​Support Channels

Discord Server

​Debug Mode

​Preventive Maintenance

​Regular Checks

​Backup Your Settings

​Still Having Issues?

Build docs developers (and LLMs) love

Critical Errors

AutoHotkey32.exe Missing

Admin Privileges Issues

Display Scale (DPI) Issues

Connection Issues

Disconnects

Death Detection

GUI & Display Issues

GUI Not Appearing

GUI Transparency Issues

Status Bar Not Showing

Gameplay Issues

Macro Not Moving Character

Macro Stuck / Not Progressing

Unable to Detect GUI Offset

Configuration Issues

Settings Not Saving

Private Server Not Working

Performance Issues

Macro Running Slow

Macro Actions Too Fast

Error Messages

Common Error Codes

Getting Help

Before Asking for Help

Information to Provide

Support Channels

Debug Mode

Preventive Maintenance

Regular Checks

Backup Your Settings

Still Having Issues?