Discord & Modmin

Discord lets your program post updates automatically — gate opens, visitor arrivals, crashes, Dodo codes. Your team can see everything without asking. If you have helpers who post to Facebook, they can grab codes straight from Discord.

Make sure islands are set up in SDT first — see Getting Started for connection, anchors, and opening the gate.

Webhooks vs Bot

There are two ways to send messages to Discord:

Start with webhooks. Add a bot later if you need DMs or a queue.

Visitor requests and reports from your website appear in SDT’s Inbox (header). Discord is for channel posts, DMs, and the queue — see Getting Started and Super Dodo Terminal for where each lives.

Setting Up Webhooks

In Discord

1. Pick (or create) the channel you want notifications in (e.g. #live-status, #dodo-codes)
2. Right-click the channel > Edit Channel > Integrations > Webhooks
3. Click New Webhook, name it (e.g. "Island Bot"), then Copy Webhook URL

In Super Dodo Terminal

1. Open the island's detail panel
2. Go to Host Menu > Discord Bot Settings (or the Discord button)
3. Paste the webhook URL into the matching field
4. Turn on the events you want:
   • Gate opened / closed
   • Visitor arrived / departed
   • Gate crashed / recovered
   • Freeze started / stopped
   • Timer events
5. Save

When you open or close the gate, messages appear in your Discord channel automatically.

Event Assets

You can attach images to Discord notifications (like a custom graphic when the gate opens):

1. In the Discord settings, find Event Assets
2. For each event, set an image URL or browse for a local file
3. Save — images appear in Discord embeds alongside your messages

Customizing Messages

You can edit the text for each event. Use placeholders that get replaced with real data:

Setting Up a Discord Bot

A bot unlocks more features: DMs, commands, role assignments, and the queue system.

Creating the Bot

1. Go to discord.com/developers/applications
2. Click New Application, give it a name
3. Go to the Bot section, click Add Bot
4. Important: Enable these Intents:
   • Message Content Intent
   • Server Members Intent
5. Click Reset Token and copy the token — keep it secret!

Inviting the Bot to Your Server

1. Go to OAuth2 > URL Generator
2. Select scopes: bot, applications.commands
3. Select permissions: Send Messages, Read Message History, Ban Members, Manage Messages
4. Copy the generated URL, open it, and add the bot to your server

Configuring in SDT

1. Open the island's Discord Bot Settings
2. Go to the Setup tab
3. Enter your Bot Token and Server ID (Guild ID)
4. Test the connection

Getting Your Server ID

1. In Discord: User Settings > Advanced > turn on Developer Mode
2. Right-click your server name
3. Click Copy ID

Per-Island Bot Settings

Each island has its own Discord bot configuration with several tabs:

Queue System

The queue system manages visitor flow through Discord. Visitors join a queue, get notified when it's their turn, and receive the Dodo code via DM.

How It Works

1. Visitor reacts with a plane emoji or types !join in the queue channel
2. Bot confirms their position via DM
3. When a spot opens, visitor receives the Dodo code
4. They have a set time to arrive (AFK timeout)
5. When they leave, the next person is notified automatically

Queue Settings

User Commands

What Visitors See

The queue embed in Discord shows the queue status, how many people are waiting, how many are on the island, and the next few names in line. It updates automatically.

If the Gate Crashes

When you get a new Dodo code after a crash, the queue system automatically updates the code and DMs it to everyone who was notified or on the island. Queue positions stay intact.

Modmin Server

Modmin (Moderator + Admin) is a private Discord server for your hosting team. Discord becomes your team dashboard.

Why Use One?

Without it, hosts are constantly asking each other for codes and status. With it, every Dodo code posts automatically, crashes trigger alerts, and helpers grab codes to post to Facebook — all in one place.

Recommended Channel Structure

📋 INFORMATION
├── #welcome-rules
├── #host-roster
└── #announcements

🏝️ ISLAND STATUS
├── #island-1
├── #island-2
└── #island-3

🎫 DODO CODES
├── #active-codes
└── #code-history

🚨 ALERTS
├── #gate-alerts
├── #visitor-alerts
└── #strike-alerts

💬 TEAM CHAT
├── #general
└── #scheduling

Setting It Up

1. Create a Discord server — Private, invite-only
2. Create channels with webhooks for the automated ones
3. Each host configures SDT with the same webhook URLs — all posts go to the same channels
4. Invite your team — Hosts, helpers, and admins only

Roles

Non-Hacked Helper Workflow

Helpers who don't have hacked Switches can still help:

1. Watch the #active-codes channel
2. When a code appears, grab it
3. Grab the boarding pass image from #event-assets
4. Post to Facebook group

This lets you scale your team without everyone needing a hacked Switch.

Unified Bot (HostHelper)

If you manage many islands (or a team), setting up a separate bot for each island is tedious. HostHelper's Unified Bot solves this:

1. In HostHelper, go to the Unified Bot tab
2. Enter one Bot Token and one Guild ID
3. Click Save & Push to SDT
4. SDT applies this bot to all your islands

One bot, all islands. Much simpler for large operations.

Facebook Host Mode

For hosts who post to Facebook groups:

• Set up templates in SDT for gate open, close, crash, and recovery posts
• Optionally generate a boarding pass image with the Dodo code printed on it
• Helpers can grab the image and post directly to Facebook

This lives in SDT under Host Menu > Facebook Host Mode.

What's Next

• Getting Started — SDT setup before webhooks and bots
• Island detail panel — Host menu, visitor list, Discord settings per island
• HostHelper — Unified bot tab

Security Tips

• Never share webhook URLs publicly — anyone with the URL can post to that channel
• Never share bot tokens — treat them like passwords
• Rotate tokens if a team member leaves
• Use role permissions to limit who sees what
• Keep the Modmin server invite-only

Troubleshooting

Webhook Not Sending

• Verify the URL is correct (starts with https://discord.com/api/webhooks/)
• Check the channel still exists
• Try creating a new webhook

Bot Not Connecting

• Verify the token is correct (copy it fresh from the Developer Portal)
• Make sure the bot is in your server
• Check the Server ID
• Make sure Intents are enabled (Message Content + Server Members)

DMs Not Sending

• The player must be linked to their Discord ID (right-click in visitor list > Link Discord ID)
• The bot must share a server with the user
• The user may have DMs disabled (nothing you can do about that)

Queue Not Working

• Make sure the bot has Add Reactions and Read Message History permissions
• Check that the queue channel ID is correct
• Verify the join method (reaction, command, or both) matches what users are trying to do