Natro Macro logoNatro MacroDownload

Guide

Natro Macro Discord Bot and Webhook Setup

Connect Natro Macro to Discord for live status, screenshots, pings and hourly honey graphs, then control the macro from your phone with ? commands.

Natro Macro Discord bot sending status updates and hourly reports to a Discord channel
On this page
  1. Webhook vs Bot Mode: Which Natro Macro Discord Setup Do You Need?
  2. Open the Natro Macro Discord Settings Window
  3. How to Set Up Natro Macro Webhook Mode
  4. How to Set Up the Natro Macro Discord Bot (Remote Control)
  5. The Command Whitelist (Added in v1.1.0)
  6. Every Natro Macro Discord Command
  7. Hourly Reports and StatMonitor Graphs
  8. Natro Macro Discord Screenshots: What Each Toggle Captures
  9. Discord Pings: Get Alerted When Something Breaks
  10. Reading the Status Log Colors
  11. Night Detection Announcement
  12. Natro Macro Discord Bot Not Working? Quick Fixes
  13. Get More From Natro Macro Remote Control
  14. FAQ

Natro Macro can report everything it does to a Discord channel: every status change, screenshots of rare events, pings when something breaks, and an hourly graph of your honey. Switch to bot mode and the same channel becomes a remote control, so you can pause, rejoin, check planters or change a setting from your phone. Everything lives on the Status tab under Discord Integration, and this guide walks through all of it with the real field names and limits from the source code.

You need Natro Macro already installed and running (see how to install Natro Macro), a Discord account, and a Discord server where you have permission to manage channels. A private server with one channel just for your macro is the cleanest setup.

Webhook vs Bot Mode: Which Natro Macro Discord Setup Do You Need?

The Discord settings window has two modes, and the choice decides what you can do. A webhook is a one-way pipe: the macro posts into a channel, but cannot read anything back. A bot logs in with a token, so it can post and read the commands you type.

FeatureWebhook modeBot mode
Status log messagesYesYes
Event screenshots and pingsYesYes
Hourly reports (StatMonitor)Yes, to the webhook channelYes, to the Report Channel (or Main Channel)
Remote control with ? commandsNoYes, read from the Main Channel
Separate channel for reportsNoYes
What you pasteWebhook URLBot Token + channel IDs + user/role ID
Setup timeAbout 2 minutesAbout 10 minutes

Our advice: start with a webhook if you only want to watch your macro. Move to bot mode once you want to fix problems while away from the PC, for example rejoining after a disconnect or harvesting a smoking planter you held with Disable Auto-Harvest on the Planters tab.

Open the Natro Macro Discord Settings Window

Go to the Status tab and click Change Discord Settings in the Discord Integration box. A dark, Discord-styled window opens on top of the macro. A few things about it are not obvious the first time:

  • Switching modes: click the Discord logo in the top-left corner of the window's blue title bar. The title changes between webhook and bot mode, and bot mode adds the channel ID fields and the command whitelist.
  • The master switch: the red/green toggle next to Webhook URL (or Bot Token) turns the whole integration on. While it is red, everything below is greyed out and nothing is sent.
  • Paste buttons, not typing: each field has a paste icon that reads your clipboard. Copy the value in Discord first, then click paste. The macro checks the format and shows the value in orange when accepted.
  • Validation: webhook URLs must look like https://discord.com/api/webhooks/... (canary and ptb links also work); a bot token must be 50 to 83 characters; channel and user IDs must be 17 to 20 digits. A wrong clipboard shows "No valid Webhook URL found in Clipboard!", "Invalid Channel ID!" or "Invalid User ID!".
  • Copy button: the copy icon next to the URL/token puts the saved value back on your clipboard, handy when you move to a new PC.

Changes save the moment you click; there is no separate Save button. Close the window with the X in the title bar.

How to Set Up Natro Macro Webhook Mode

  1. Create a channel. In your Discord server, make a text channel such as #natro-log. Keep it private if other people are in the server, because screenshots show your game.
  2. Create the webhook. Open the channel's settings (gear icon), go to Integrations, then Webhooks, and click New Webhook. Give it a name and avatar you like.
  3. Copy the URL. Click Copy Webhook URL. Treat this link like a password: anyone holding it can post into your channel.
  4. Paste it into Natro Macro. In Change Discord Settings, make sure the window is in webhook mode, then click the paste icon next to the URL box.
  5. Turn the toggle green. Click the switch next to Webhook URL. The rest of the window becomes active.
  6. Pick screenshots and pings. Choose which events send images and which ping you (both explained below), then close the window.
  7. Start the macro. Press F1. Within seconds you should see a startup message in the channel.

How to Set Up the Natro Macro Discord Bot (Remote Control)

Bot mode was added in v0.9.2 and is what people mean by "Natro Macro remote control". It takes three parts: a bot account in Discord, a few IDs, and the whitelist.

1. Create the bot in the Discord Developer Portal

  1. New application. Open the Discord Developer Portal, click New Application and name it (for example "My Natro").
  2. Get the token. In the Bot section click Reset Token and copy it. Discord shows it only once. Never share it or post it in a screenshot.
  3. Enable Message Content Intent. On the same Bot page, turn on Message Content Intent. Natro Macro reads your commands from the text of recent messages, and without this intent the bot sees empty messages.
  4. Invite the bot. Under OAuth2, use the URL generator with the bot scope and give it View Channels, Send Messages, Embed Links, Attach Files and Read Message History. Open the generated link and add the bot to your private server.

2. Copy the channel and user IDs

Turn on Developer Mode in Discord (User Settings, Advanced). Now right-click any channel and choose Copy Channel ID, or right-click your own name and choose Copy User ID. Roles get Copy Role ID in Server Settings, Roles.

3. Paste everything into Natro Macro

  • Bot Token: switch the window to bot mode (Discord logo, top-left), paste the token, and turn the toggle green.
  • Main Channel ID: tick the box and paste the ID of the channel where you will type commands. Status messages go here too.
  • Report Channel ID (optional): tick and paste a second channel if you want hourly reports and the Daily Honey LB screenshot kept apart from the busy status feed. If it is left empty, reports fall back to the Main Channel.
  • User ID (Commands): paste your own user ID, or a role ID with & in front of it (for example &123456789012345678) to let everyone with that role control the macro.

Restart the macro after the first setup, then type ?help in the Main Channel. The bot checks the channel for new commands roughly every half second, so replies are close to instant.

Natro Macro settings illustration

The Command Whitelist (Added in v1.1.0)

Before v1.1.0, anyone who could type in your Main Channel could send commands. Natro Team published this as security advisory GHSA-ph9r-2qjm-ghvg ("Discord RC Commands Vulnerability"): because commands like ?send, ?download and ?restart act on your PC, a stranger in the channel could have done real damage. Version 1.1.0 added the User ID (Commands) field to lock commands to one user or one role.

Fill the whitelist in. In the current source, an empty User ID (Commands) field means no whitelist is active, so every member who can post in the Main Channel can run commands. With it set, anyone else gets the reply "Only <@your-id> can use commands". Also keep the bot in a server only you (or people you trust) can read, and reset the token in the Developer Portal if it ever leaks.

If you are on a version older than v1.1.0, update first. The Natro Macro update guide shows how to move your settings across, and the changelog lists both v1.1.0 security fixes.

Every Natro Macro Discord Command

The default prefix is ?. Change it with ?prefix [new]; it can be 1 to 3 characters and cannot be empty. Square brackets mean a required value, round brackets an optional one. Typing an unknown command returns "is not a valid command! Use ?help for a list of commonly used commands."

Everyday commands (?help)

CommandWhat it does
?helpLists the useful commands. Add advanced, set or priority for more lists.
?startStarts the macro, same as F1.
?pause / ?unpausePauses or resumes, same as F2.
?stop / ?reloadStops and reloads Natro Macro, same as F3.
?screenshot / ?ssUploads a screenshot of all monitors.
?ss mode [all/window/screen]Sets what ?ss captures: all monitors, the active window, or your main screen only.
?close [window]Closes a window, for example ?close Roblox.
?rejoin (delay)Closes Roblox and rejoins after an optional delay.
?keep / ?replaceKeeps or replaces an amulet when the prompt is on screen.
?logUploads your debug_log.txt.
?planters / ?timersShows planter and timer overviews (sub-commands below).
?prefix [prefix]Changes the command prefix.

Advanced commands (?help advanced)

CommandWhat it does
?set [setting] [value]Changes a macro setting. ?help set lists every settable variable by section: Boost, Collect, Gather, Planters, Quests, Settings, Status, Blender, Shrine.
?get [setting]Returns the current value of a setting.
?set priority ... / ?get priorityChanges or reads the main loop priority order (see ?help priority).
?set bugrun on/offTurns every bug run monster on or off at once.
?send [keys]Sends keystrokes with AutoHotkey's Send.
?click [options]Clicks with AutoHotkey's Click; ?click mode changes how.
?activate [window] / ?minimize [window]Brings a window to the front or minimizes it.
?shiftlock [on/off]Toggles Shift Lock in Roblox.
?upload [filepath]Uploads a file from your PC (limit 10 MiB since v1.1.0).
?download [directory]Saves the file attached to your message into a folder on your PC.
?finditem [item]Finds an item in your inventory and sends a screenshot (added v1.0.1).
?debugUploads a debug report, the same one F6 copies.
?restartRestarts your computer. Use with care.

Planters, timers, shrine, blender and Memory Match

CommandSub-commands
?planter / ?plantersOverview with planter, field, nectar, time left and glitter. Then harvest [n] (alias release), add [h:m:s] [n], sub [h:m:s] [n], clear [n], smoking [n], screenshot [n].
?timers (also ?timer, ?time)reset [var], add [h:m:s] [var], sub [h:m:s] [var], ready.
?shrineready [n], clear [n] for the Wind Shrine slots.
?blenderready [n], clear [n] for the Blender slots.
?mm / ?memorymatchenable [game], disable [game], ignore [item] (game); games are Normal, Mega, Night, Extreme and Winter.

A few settings are deliberately blocked from ?set, including the Main Channel ID and the Discord mode, so a typo cannot cut off your own remote control. Advanced users can add their own commands in settings\personal_commands.ahk, which the status script includes on load.

Most useful combo when you are away: ?ss to see what is happening, ?rejoin if the game froze, and ?planters to check timers before deciding on ?planter harvest 2.

Hourly Reports and StatMonitor Graphs

Hourly reports come from StatMonitor (version 2.3 in the current build), a helper script that runs next to the macro. When you start, it posts a Startup Report that says when hourly reports will begin (they line up with the top of each hour) and lists your StatMonitor version, Windows version, OCR status, Natro Macro version, gather fields, consumables, planters and hive slot.

Every hour after that you get one image with these sections:

  • Honey: Honey Earned, HONEY/SEC, Hourly Average, plus LAST HOUR and SESSION graphs.
  • BUFF UPTIME and BUFFS: haste, melody, red/blue/white boost, focus, bomb combo, balloon aura, clock, jbshare, baby love, inspire, bear, pollen mark, honey mark, festive mark, pop star, all five nectars, blessing, bloat, guiding, mondo, reindeer fetch and tide blessing.
  • BACKPACK and PLANTERS: how full your bag ran and what your planters are doing.
  • STATS: total boss, bug and Vicious kills, quests done and disconnects.

In bot mode the report goes to the Report Channel if you set one, otherwise to the Main Channel. In webhook mode it goes to the webhook's channel. These graphs have a fan in high places: the Natro Team credits note that Onett, the creator of Bee Swarm Simulator, has praised the StatMonitor graphs.

Honey is read with Windows OCR. If the Startup Report says "OCR Status: Disabled", your honey graphs will be empty. The macro's message points to a Knowledge Base guide on the official Discord: install a supported language (English works) as a secondary Windows language, then restart the macro. Our troubleshooting guide covers this too.

Natro Macro Discord Screenshots: What Each Toggle Captures

The Screenshots switch turns image attachments on; the boxes under it choose the events. Screenshots are of the Roblox window.

ToggleSends a screenshot when
CriticalAny message that also pings you (errors, disconnects and the other ping events).
AmuletAn amulet prompt or amulet result appears.
MachineSomething is collected, such as a dispenser or Beesmas machine.
BalloonThe macro converts your balloon.
ViciousA Vicious Bee kill completes.
DeathYour character dies.
PlanterA planter is detected, held or screenshotted (great for smoking planters).
HoneyThe Daily Honey LB (leaderboard) report.
Honey UpdateA live honey/pollen image while gathering and converting, which edits the same Discord message instead of spamming new ones.

Night detection always attaches a screenshot when screenshots are on. If your channel gets too busy, Machine and Honey Update are the usual first ones to turn off.

Discord Pings: Get Alerted When Something Breaks

The right column of the window handles pings. Turn on its switch, paste your User ID (or a role ID with &), and tick the events that should mention you:

  • Critical Error: any status of type Error.
  • Disconnect: you dropped from the server.
  • Game Frozen: repeated character resets that suggest Roblox has hung.
  • Phantom: a phantom planter was detected.
  • Unexpected Death: your character died.
  • Emergency Balloon: the balloon has gone too long without converting.

The macro also pings for an obtained amulet and, with Planter screenshots on, for a held planter, since both usually need you to decide something. Pair pings with Discord's mobile notifications for that channel and you will rarely lose a night of gathering to a silent disconnect. For reconnect itself, set a private server link as shown in the settings and hotkeys guide.

Reading the Status Log Colors

Every status message is a colored embed, and the color tells you the category at a glance: red for errors, deaths, disconnects and phantom planters; purple for bosses and attacks (Tunnel Bear, King Beetle, Vicious Bee, Snail, Coco Crab, Mondo, Commando); blue for planters; yellow for interruptions, reports and warnings; light green for gathering; yellow-brown for converting; green for successes like boosts, loot and collections; orange for starting quests; white for startup and utility messages.

A small easter egg: set all three gather fields to fields of the same color and Natro Macro asks "You found an easter egg! Enable Rainbow Webhook?", which cycles every embed through the rainbow. Fun once, harder to read every day.

Night Detection Announcement

Separate from your own log, the Misc tab has a Discord tool called Night Detection Announcement. It sends a message to a different webhook (often a friends' server) when night is detected in your private server, with a link so others can join and fight the Vicious Bee. It takes a Name, an optional Ping ID and the Webhook, and it requires Kill Vicious Bee to be on in the Collect/Kill tab.

Natro Macro Discord Bot Not Working? Quick Fixes

  • No messages at all: the toggle next to Webhook URL/Bot Token is red, or the webhook was deleted in Discord. Paste a fresh URL.
  • Bot posts but ignores commands: check that the window is in bot mode, the command is typed in the Main Channel, the prefix matches, and Message Content Intent is on.
  • "Only <@id> can use commands": the whitelist does not match you. Paste your own user ID, or add & before a role ID.
  • Images missing: the Screenshots switch is off, or the bot lacks Attach Files permission in that channel.
  • Empty honey graphs: OCR is disabled; add a supported Windows language.
  • Still stuck: run ?debug (or press F6) and take the report to the official Natro Macro Discord at discord.gg/natromacro, or check open issues on GitHub.

Get More From Natro Macro Remote Control

Once Discord is set up, Natro Macro stops being something you babysit. A sensible daily setup: webhook or bot with Critical, Amulet and Planter screenshots, pings for Disconnect and Critical Error, a separate Report Channel for hourly graphs, and the whitelist always filled in. From there, the features overview shows what else each tab can do, and the FAQ answers the questions we hear most.

Frequently asked questions

What is the difference between webhook and bot mode in Natro Macro?

Webhook mode only posts into one channel: status messages, screenshots, pings and hourly reports. Bot mode logs in with a bot token, so it can also read your messages. That lets you run remote control commands like ?pause, ?rejoin and ?planters from the Main Channel, and send hourly reports to a separate Report Channel.

Why does the Natro Macro bot not respond to my commands?

Check four things. The settings window must be in bot mode, not webhook mode. You must type in the Main Channel whose ID you pasted. The prefix must match (default ?). Message Content Intent must be on in the Discord Developer Portal. If the bot answers "Only <@id> can use commands", your whitelist ID does not match your account.

How do I whitelist a role instead of a user for Natro Macro commands?

Copy the role ID in Discord (Server Settings, Roles, right-click the role, Copy Role ID with Developer Mode on). Put an ampersand in front of it, like &123456789012345678, copy that whole string, and paste it into the User ID (Commands) field. Everyone holding that role can then control the macro. The whitelist exists since v1.1.0.

Is it safe to use Natro Macro remote control?

It is safe when you set it up properly. Run v1.1.0 or newer, which fixed the remote control vulnerability, always fill in the User ID (Commands) whitelist, keep the bot in a private server, and never share your bot token. Commands such as ?send, ?download and ?restart act on your real PC, so treat access like a password.

Why are my Natro Macro hourly report honey graphs empty?

StatMonitor reads honey with Windows OCR. If no OCR-supported language is installed, the Startup Report shows "OCR Status: Disabled" and the honey graphs stay empty. Add a supported language such as English as a secondary Windows language, then restart Natro Macro. Buff and stat sections still work without OCR.

Can I change the Natro Macro command prefix?

Yes. Type ?prefix followed by the new prefix, for example ?prefix !. The prefix can be one to three characters and cannot be empty. The new prefix is saved to your settings file, so it survives restarts. If you forget it, the current prefix is stored under the Status section of settings\nm_config.ini.

Keep reading