Skip to content

Discord Integration

Connect your Discord server with Arcadium for enhanced community management.

Overview

Discord integration provides:

  • Player account linking
  • Role synchronization
  • Join/leave notifications
  • Server status updates
  • Discord commands
  • Mod action logging

Setup

1. Create Discord Bot

  1. Visit Discord Developer Portal
  2. Click New Application
  3. Name your bot (e.g., "Arcadium Bot")
  4. Navigate to Bot section
  5. Click Add Bot
  6. Copy Bot Token

2. Configure Bot Permissions

Required permissions:

  • Manage Roles
  • Send Messages
  • Embed Links
  • Read Message History
  • Add Reactions

Permission integer: 268446720

3. Invite Bot to Server

https://discord.com/api/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=268446720&scope=bot

Replace YOUR_CLIENT_ID with your application ID.

4. Configure in Arcadium

  1. Cluster Settings → Integrations → Discord
  2. Paste Bot Token
  3. Enter Server ID (Guild ID)
  4. Configure channels:
    • Notifications channel
    • Mod logs channel
    • Player activity channel
  5. Save configuration

Features

Player Linking

Command:

/link <username>

Players link their game account to Discord profile.

Benefits:

  • Unified identity
  • Cross-platform notifications
  • Role sync

Role Synchronization

Automatic role assignment:

Game Rank → Discord Role
VIP       → @VIP
Moderator → @Game Mod
Admin     → @Admin

Setup:

  1. Discord Integration → Role Mapping
  2. Map game ranks to Discord roles
  3. Enable auto-sync
  4. Roles update on rank change

Notifications

Join/Leave Events:

discord
🎮 PlayerOne joined ARK-Island
👋 PlayerTwo left Rust-Main

Server Status:

discord
🟢 ARK-Island is now online
🔴 Rust-Main has crashed

Mod Actions:

discord
🚫 Admin kicked PlayerThree from Rust-Main
Reason: Griefing

Discord Commands

Available commands:

/status - View server status
/players - List online players  
/link <username> - Link game account
/stats <player> - View player stats

Admin commands:

/restart <server> - Restart server
/broadcast <message> - Send message to all servers

Configuration

Notification Settings

Customize what events trigger notifications:

  • Player joins/leaves
  • Server start/stop
  • Server crashes
  • Mod actions (kicks, bans)
  • Purchase events
  • Rank changes

Channel Mapping

Route different event types to different channels:

#server-status → Server events
#player-activity → Join/leave
#mod-logs → Moderation actions
#purchases → Shop transactions

Mention Settings

Configure @mentions:

  • @here on server crashes
  • @Admins on player reports
  • @Moderators on rule violations

Webhooks

Alternative to bot for simple notifications:

Creating Webhook

  1. Discord channel → Settings → Integrations
  2. Create Webhook
  3. Copy Webhook URL
  4. Paste in Arcadium → Discord Webhook

Limitations:

  • No commands
  • No role sync
  • One-way communication only

Troubleshooting

Bot Not Responding

Check:

  • Bot is online in Discord
  • Bot has correct permissions
  • Bot token is valid
  • Bot is in your server

Roles Not Syncing

Check:

  • Bot role is higher than roles it manages
  • Role mapping configured correctly
  • Auto-sync enabled
  • Player accounts linked

Missing Notifications

Check:

  • Channel IDs correct
  • Bot can send messages in channels
  • Notification type enabled
  • Not rate limited

Best Practices

Security

Token Security

Never share your bot token. Treat it like a password.

  • Regenerate token if exposed
  • Use environment variables
  • Limit bot permissions
  • Regular audit of bot actions

Organization

  • Separate channels for different event types
  • Clear channel purposes
  • Moderation team has access to relevant channels
  • Archive old notifications periodically

Community

  • Announce Discord integration to players
  • Explain linking benefits
  • Provide help channel for issues
  • Respond to bot command questions

Next Steps

Released under the MIT License.