Discord Integration - Natro Macro

Natro Macro includes powerful Discord integration that enables remote monitoring, notifications, and even remote control of your macro through Discord webhooks or bot tokens.

Integration Modes

Natro Macro supports two Discord integration modes:

Webhook Mode (Mode 0)

Advantages:

Easiest to set up
No bot creation needed
Works with any webhook-enabled channel

Limitations:

One-way communication only (macro → Discord)
No remote commands
Cannot read messages

Bot Mode (Mode 1)

Advantages:

Full two-way communication
Remote command support
Channel-specific messaging
Read message history

Limitations:

Requires bot creation and token
More complex setup
Needs proper permissions

Both modes support screenshots, embeds, and file uploads. Choose based on whether you need remote control.

Setup Instructions

Webhook Mode Setup

Create Webhook

In Discord:

Right-click your target channel
Select Edit Channel → Integrations
Click Create Webhook
Name it (e.g., “Natro Macro”)
Copy the webhook URL

Configure Macro

In Natro Macro Status tab:

Set Discord Mode to Webhook
Paste webhook URL in Webhook field
Check Discord Check to enable

Configure Screenshots (Optional)

Enable screenshot types:

Critical SS - Critical errors
Amulet SS - Amulet drops
Machine SS - Dispenser collections
Balloon SS - Balloon spawns
Vicious SS - Vicious Bee kills
Death SS - Character deaths
Planter SS - Planter collections
Honey SS - Honey milestones

Bot Mode Setup

Create Discord Bot

Go to Discord Developer Portal
Click New Application
Name your application
Go to Bot tab
Click Add Bot
Click Reset Token and copy the token
Enable required intents:
- Message Content Intent
- Server Members Intent (if using UIDs)

Invite Bot to Server

Go to OAuth2 → URL Generator
Select scopes:
- bot
Select permissions:
- Send Messages
- Attach Files
- Read Message History
- Add Reactions
Copy generated URL and open in browser
Select your server and authorize

Get Channel IDs

Enable Developer Mode in Discord:

User Settings → Advanced → Developer Mode
Right-click your main channel → Copy ID
Right-click your report channel → Copy ID (optional)

Configure Macro

In Natro Macro Status tab:

Set Discord Mode to Bot Token
Paste bot token in Bot Token field
Paste channel ID in Main Channel ID
Check Main Channel Check
(Optional) Configure Report Channel ID
Check Discord Check to enable

Configuration Options

Status Tab Settings

; In nm_config.ini [Status]
DiscordMode=0              ; 0=Webhook, 1=Bot
DiscordCheck=1             ; 0=disabled, 1=enabled
Webhook=https://...        ; Webhook URL (Mode 0)
BotToken=MTk...            ; Bot token (Mode 1)

; Channels (Mode 1 only)  
MainChannelCheck=1
MainChannelID=123456789
ReportChannelCheck=1
ReportChannelID=987654321

; Screenshots
ssCheck=1                  ; Master screenshot enable
ssDebugging=0              ; Debug mode screenshots
CriticalSSCheck=1          ; Critical errors
AmuletSSCheck=1            ; Amulet drops
MachineSSCheck=1           ; Dispensers/machines
BalloonSSCheck=1           ; Balloons
ViciousSSCheck=1           ; Vicious Bee
DeathSSCheck=1             ; Deaths
PlanterSSCheck=1           ; Planters
HoneySSCheck=0             ; Honey updates
HoneyUpdateSSCheck=1       ; Honey milestones

; Ping Settings
criticalCheck=1            ; Enable pings
discordUID=123456789       ; Your Discord user ID
discordUIDCommands=456789  ; User ID for commands
CriticalErrorPingCheck=1
DisconnectPingCheck=1  
GameFrozenPingCheck=1
PhantomPingCheck=1
UnexpectedDeathPingCheck=0
EmergencyBalloonPingCheck=0

; Commands (Mode 1)
commandPrefix=?            ; Command prefix character

Easter Egg Feature

WebhookEasterEgg=0         ; Fun Easter egg messages

Enable WebhookEasterEgg for occasional fun messages mixed with regular updates.

Discord Library (Discord.ahk)

The macro uses a custom Discord class for API interactions:

Core Functions

SendEmbed()

Sends rich embed messages with optional images:

; From Discord.ahk:11-34
static SendEmbed(message, color:=3223350, content:="", pBitmap:=0, channel:="", replyID:=0)
{
    payload_json := '
    {
        "content": "' content '",
        "embeds": [{
            "description": "' message '",
            "color": "' color '"
            ' (pBitmap ? (',"image": {"url": "attachment://ss.png"}') : '') '
        }]
        ' (replyID ? (',"allowed_mentions": {"parse": []}, "message_reference": {"message_id": "' replyID '"}') : '') '
    }'
    
    return this.SendMessageAPI(postdata, contentType, channel)
}

Parameters:

message - Main message text (in embed description)
color - Decimal color code (default: 3223350 = teal)
content - Optional content text above embed
pBitmap - Optional bitmap pointer for screenshot
channel - Channel ID (Bot mode only)
replyID - Message ID to reply to

Color Codes:

3223350 - Default teal
16711731 - Red (errors)
16776960 - Yellow (warnings)
65280 - Green (success)
7036559 - Purple (bosses)

SendFile()

Sends file attachments:

; From Discord.ahk:36-89
static SendFile(filepath, replyID:=0)
{
    ; Supports: PNG, JPEG, JPG, BMP, GIF, WEBP, TXT, INI
    ; Folders are zipped automatically
    ; Max size: 10MB (10,485,760 bytes)
}

Features:

Automatic folder zipping
MIME type detection
File size validation
Error handling

SendImage()

Sends bitmap as PNG image:

; From Discord.ahk:91-98
static SendImage(pBitmap, imgname:="image.png", replyID:=0)
{
    params := []
    params.Push(Map("name","files[0]","filename",imgname,
        "content-type","image/png","pBitmap",pBitmap))
    this.CreateFormData(&postdata, &contentType, params)
    this.SendMessageAPI(postdata, contentType)
}

All image functions use GDI+ bitmaps. Screenshots are captured with Gdip_BitmapFromScreen() and sent directly without saving to disk.

Bot Mode Functions

GetRecentMessages()

Reads recent channel messages:

; From Discord.ahk:180-197
static GetRecentMessages(channel)
{
    static lastmsg := Map()
    
    try
        messages := JSON.parse(this.GetMessageAPI(
            lastmsg.Has(channel) ? ("?after=" lastmsg[channel]) : "?limit=1", 
            channel))
    catch
        return []
    
    if (messages.Has(1))
        lastmsg[channel] := messages[1]["id"]
    
    return messages
}

Use Case: Check for new commands from users

GetCommands()

Parses commands from messages:

; From Discord.ahk:133-145  
static GetCommands(channel)
{
    Loop (n := (messages := this.GetRecentMessages(channel)).Length)
    {
        i := n - A_Index + 1
        content := Trim(messages[i]["content"])
        if (SubStr(content, 1, StrLen(commandPrefix)) = commandPrefix)
            command_buffer.Push({
                content: content,
                id: messages[i]["id"],
                url: messages[i]["attachments"].Has(1) ? messages[i]["attachments"][1]["url"] : "",
                user_id: messages[i]["author"]["id"]
            })
    }
}

Returns: Array of command objects with:

content - Full message text
id - Message ID for replies
url - Attachment URL if present
user_id - Author’s Discord ID

EditMessageAPI()

Edits previously sent messages:

; From Discord.ahk:228-256
static EditMessageAPI(id, postdata, contentType:="application/json", channel:="")
{
    url := (discordMode = 0) 
        ? (webhook "/messages/" id) 
        : (this.BaseURL "/channels/" channel "/messages/" id)
    
    wr := ComObject("WinHttp.WinHttpRequest.5.1")
    wr.Open("PATCH", url, 1)
    if (discordMode = 1)
    {
        wr.SetRequestHeader("User-Agent", "DiscordBot (AHK, " A_AhkVersion ")")
        wr.SetRequestHeader("Authorization", "Bot " bottoken)
    }
    wr.SetRequestHeader("Content-Type", contentType)
    wr.Send(postdata)
    return wr.ResponseText
}

Use Case: Update status messages with current progress

Notification Types

Screenshot Notifications

When enabled, the macro captures and sends screenshots for:

Critical Errors

; Triggered on critical failures
if (CriticalSSCheck)
    discord.SendEmbed("Critical Error: " errorMsg, 16711731, , pBitmap)

Color: Red (16711731)

Amulet Drops

; Sent when boss drops amulet
if (AmuletSSCheck)
    discord.SendEmbed("Amulet from " bossName, 65280, , pBitmap)

Color: Green (65280)

Machine Collections

; Dispenser/Blender collections
if (MachineSSCheck)
    discord.SendEmbed("Collected " machineName, 3223350, , pBitmap)

Color: Teal (3223350)

Balloon Spawns

; Emergency or rare balloons
if (BalloonSSCheck)
    discord.SendEmbed("Balloon spawned", 16776960, , pBitmap)

Color: Yellow (16776960)

Vicious Bee Kills

; Vicious Bee defeated
if (ViciousSSCheck)
    discord.SendEmbed("Vicious Bee killed", 7036559, , pBitmap)

Color: Purple (7036559)

Deaths

; Character death
if (DeathSSCheck)
    discord.SendEmbed("Death detected", 16711731, , pBitmap)

Color: Red (16711731)

Ping Notifications

When critical events occur, the macro can ping you:

; Ping on critical error
if (CriticalErrorPingCheck && discordUID)
    discord.SendEmbed(errorMsg, 16711731, "<@" discordUID ">")

Ping Types:

Critical Error - Major failures requiring attention
Disconnect - Lost connection to Roblox
Game Frozen - Game stopped responding
Phantom - Phantom Bee detected
Unexpected Death - Death in safe area
Emergency Balloon - Rare/valuable balloon

Too many pings can be annoying. Enable only the most important ones.

Status Updates

Regular status reports sent to Discord:

Session Start - Macro started
Gather Complete - Field gathering finished
Boss Kill - Boss defeated
Planter Collected - Planter harvested
Disconnect/Reconnect - Connection status
Honey Milestones - Honey thresholds reached

Remote Commands (Bot Mode)

When using Bot Mode, you can send commands from Discord:

Command Format

?command [arguments]

Default prefix is ?, configurable via commandPrefix setting.

Available Commands

The macro checks for commands in the main channel:

; Command processing (conceptual)
command_buffer := []
discord.GetCommands(MainChannelID)

for cmd in command_buffer {
    if (cmd.user_id = discordUIDCommands) {
        ; Parse and execute command
        ; Reply to message with results
    }
}

Security: Only the user specified in discordUIDCommands can execute commands.

Common Commands

?status - Get current macro status
?stats - View statistics
?ping - Check if macro is responsive
?screenshot - Request screenshot
?planters - Check planter timers
?bosses - View boss cooldowns

Command availability depends on macro version and configuration. Check your version’s documentation for complete command list.

Statistics Reporting

The macro can send periodic statistics:

; Example stats embed
statsMsg := '
Session Runtime: 5h 30m
Total Honey: 50.5B
Boss Kills: 3
Planters Collected: 12
Disconnects: 0
'
discord.SendEmbed(statsMsg, 3223350)

Includes:

Runtime (session and total)
Honey collected
Boss kills
Bug kills
Planter collections
Quest completions
Disconnections

Night Announcements

Special feature for announcing in-game night time:

[Status]
NightAnnouncementCheck=1
NightAnnouncementName=@everyone
NightAnnouncementPingID=
NightAnnouncementWebhook=https://...

Use Case: Notify your server when night time begins (for night Memory Match, Vicious Bee, etc.)

; Night announcement
if (NightAnnouncementCheck && isNightTime)
    discord.SendEmbed(
        "Night time has begun!",
        7036559,
        NightAnnouncementPingID ? ("<@" NightAnnouncementPingID ">") : NightAnnouncementName,
        ,
        ,
        
    )

Best Practices

Start Simple

Begin with Webhook mode
Enable only essential screenshots (Critical, Death)
Add more features gradually

Channel Organization

Use separate channels for main updates and reports
Main: Status updates, completions
Report: Errors, deaths, critical events
Consider a third channel for statistics/hourly updates

Screenshot Management

Enable screenshots for events you want to review
Disable routine screenshots to reduce spam
Use ssDebugging only when troubleshooting
Honey SS can generate many messages - enable sparingly

Ping Settings

Only enable pings for truly critical events
Use a dedicated Discord account for testing
Consider Do Not Disturb hours
Test ping functionality before extended runs

Remote Commands

Set discordUIDCommands to your user ID only
Never share your bot token
Use a dedicated bot (don’t reuse other bots)
Test commands in a private server first

Troubleshooting

Messages Not Sending

Webhook Mode:

Verify webhook URL is correct and complete
Check webhook hasn’t been deleted in Discord
Ensure channel still exists
Test webhook manually with curl or online tool

Bot Mode:

Verify bot token is valid
Check bot is in the server
Verify channel IDs are correct
Ensure bot has Send Messages permission
Check bot isn’t rate-limited

Screenshots Not Uploading

Check file size (max 10MB)
Verify ssCheck is enabled
Ensure specific SS type is enabled (e.g., CriticalSSCheck)
Check Gdip_All.ahk is loaded correctly
Verify bitmap creation is successful

Commands Not Working

Verify Bot Mode is active (DiscordMode=1)
Check discordUIDCommands matches your user ID
Get your user ID: Enable Developer Mode, right-click yourself, Copy ID
Ensure command prefix is correct (default ?)
Verify bot has Read Message History permission
Check bot has Message Content intent enabled

Rate Limiting

Discord API has rate limits:

; From Discord.ahk:126
wr.SetTimeouts(0, 60000, 120000, 30000)

Connect: 60 seconds
Send: 120 seconds
Receive: 30 seconds

Solutions:

Reduce message frequency
Disable less important notifications
Batch updates instead of individual messages
Use embed edits instead of new messages

Permission Errors

Bot needs these permissions:

Send Messages
Attach Files
Read Message History
Add Reactions (optional)
Manage Messages (optional, for edits)

Fix:

Go to Discord Developer Portal
Select your application
Go to OAuth2 → URL Generator
Regenerate invite with correct permissions
Re-invite bot to server

Advanced Features

Custom Embeds

You can customize embed colors and content:

; Custom color example
successColor := 65280      ; Green
warningColor := 16776960   ; Yellow
errorColor := 16711731     ; Red
bossColor := 7036559       ; Purple

discord.SendEmbed("Custom message", successColor)

File Attachments

Send config files or logs:

; Send config file
discord.SendFile("settings\nm_config.ini")

; Send debug log
discord.SendFile("settings\debug_log.txt")

; Send folder (auto-zipped)  
discord.SendFile("settings")

Debugging Mode

ssDebugging=1

Enables extra screenshots for troubleshooting:

Every major state change
Navigation waypoints
Detection failures
Timing issues

Debug mode generates many messages. Only enable when actively troubleshooting.

Security Considerations

Protect Your Tokens

Never share your webhook URL or bot token
Don’t commit config files to public repositories
Regenerate tokens if compromised
Use environment variables for sensitive data (advanced)

Command Security

Only set discordUIDCommands to trusted user IDs
Commands can control your macro - be careful who has access
Consider requiring a secondary password for critical commands

Configuration Reference

Full Status Section

[Status]
; Connection
DiscordMode=0
DiscordCheck=0  
Webhook=
BotToken=

; Channels (Bot Mode)
MainChannelCheck=1
MainChannelID=
ReportChannelCheck=1
ReportChannelID=

; Screenshots
ssCheck=0
ssDebugging=0
CriticalSSCheck=1
AmuletSSCheck=1
MachineSSCheck=1
BalloonSSCheck=1
ViciousSSCheck=1
DeathSSCheck=1
PlanterSSCheck=1
HoneySSCheck=0
HoneyUpdateSSCheck=1

; Pings
criticalCheck=0
discordUID=
discordUIDCommands=
CriticalErrorPingCheck=1
DisconnectPingCheck=1
GameFrozenPingCheck=1
PhantomPingCheck=1
UnexpectedDeathPingCheck=0
EmergencyBalloonPingCheck=0

; Commands
commandPrefix=?

; Night Announcements
NightAnnouncementCheck=0
NightAnnouncementName=
NightAnnouncementPingID=
NightAnnouncementWebhook=

; Other
WebhookEasterEgg=0

API Reference

Base URL: https://discord.com/api/v10/ Endpoints Used:

POST /channels/{channel}/messages - Send message
GET /channels/{channel}/messages - Get messages
PATCH /channels/{channel}/messages/{id} - Edit message
GET /channels/{channel} - Get channel info
GET /guilds/{guild}/members/{user} - Get member info

Headers:

; Bot Mode
User-Agent: DiscordBot (AHK, {version})
Authorization: Bot {token}
Content-Type: application/json

For complete API documentation, see Discord API Reference.

Get Started

Core Features

Configuration

Guides

Advanced

​Integration Modes

​Webhook Mode (Mode 0)

​Bot Mode (Mode 1)

​Setup Instructions

​Webhook Mode Setup

​Bot Mode Setup

​Configuration Options

​Status Tab Settings

​Easter Egg Feature

​Discord Library (Discord.ahk)

​Core Functions

​SendEmbed()

​SendFile()

​SendImage()

​Bot Mode Functions

​GetRecentMessages()

​GetCommands()

​EditMessageAPI()

​Notification Types

​Screenshot Notifications

​Critical Errors

​Amulet Drops

​Machine Collections

​Balloon Spawns

​Vicious Bee Kills

​Deaths

​Ping Notifications

​Status Updates

​Remote Commands (Bot Mode)

​Command Format

​Available Commands

​Common Commands

​Statistics Reporting

​Night Announcements

​Best Practices

​Troubleshooting

​Messages Not Sending

​Screenshots Not Uploading

​Commands Not Working

​Rate Limiting

​Permission Errors

​Advanced Features

​Custom Embeds

​File Attachments

​Debugging Mode

​Security Considerations

​Configuration Reference

​Full Status Section

​API Reference

Build docs developers (and LLMs) love

Integration Modes

Webhook Mode (Mode 0)

Bot Mode (Mode 1)

Setup Instructions

Webhook Mode Setup

Bot Mode Setup

Configuration Options

Status Tab Settings

Easter Egg Feature

Discord Library (Discord.ahk)

Core Functions

SendEmbed()

SendFile()

SendImage()

Bot Mode Functions

GetRecentMessages()

GetCommands()

EditMessageAPI()

Notification Types

Screenshot Notifications

Critical Errors

Amulet Drops

Machine Collections

Balloon Spawns

Vicious Bee Kills

Deaths

Ping Notifications

Status Updates

Remote Commands (Bot Mode)

Command Format

Available Commands

Common Commands

Statistics Reporting

Night Announcements

Best Practices

Troubleshooting

Messages Not Sending

Screenshots Not Uploading

Commands Not Working

Rate Limiting

Permission Errors

Advanced Features

Custom Embeds

File Attachments

Debugging Mode

Security Considerations

Configuration Reference

Full Status Section

API Reference