Discord Bot Setup

The Railroader Modding Hub uses a Discord bot to verify user roles and send mod update notifications to your server. This guide will help you add the bot to your Discord server and configure it.

Add Bot to Your Server

Click the button below to add the Railroader Modding Hub bot to your Discord server. You'll need "Manage Server" permission.

Add Bot to Server

What Does the Bot Do?

The Railroader Modding Hub bot provides two main features:

  • Role Verification: Checks user roles to determine which mods they can access. When users log in to the modding hub, the bot verifies their roles in servers where it's present.
  • Update Notifications: Sends automatic notifications to designated channels when new mods are uploaded or existing mods are updated.

Bot Permissions

When you add the bot, it will request the following permissions:

  • View Channels: Required to see which channels exist for notifications
  • Manage Webhooks: Needed to create webhooks for sending mod update notifications
  • Send Messages: Used to send command responses and notifications
  • Embed Links: Used to format notification messages with rich embeds
  • Use Slash Commands: Enables the /subscribe, /unsubscribe, and /list-subscriptions commands

Privacy Note: The bot does not read your messages or perform any moderation functions. It only checks role memberships and sends notifications via webhooks when configured.

Setting Up Mod Update Notifications

Once the bot is added to your server, you can configure it to receive mod update notifications.

Subscribe to Notifications

Use the /subscribe command to enable notifications in a channel:

  1. Navigate to the channel where you want to receive notifications
  2. Type /subscribe and press Enter
  3. Choose a subscription type:
    • All: Get notified about every mod update
    • Public: Only receive notifications for public mods (no role requirements)
    • Role-specific: Only notify about mods requiring specific roles in your server

Note: Only users with server ownership or "Manage Channels" permission can use the /subscribe command.

Unsubscribe from Notifications

To stop receiving notifications in a channel, use /unsubscribe in that channel.

View Active Subscriptions

Use /list-subscriptions to see all active notification subscriptions in your server.

Notification Examples

When a mod is uploaded or updated, subscribed channels will receive a notification like this:

🔔 New Mod Update Available!

Example Train Mod v1.2.0
Download Example Train Mod
📦 Version
1.2.0
👤 Uploaded By
ModAuthor
📝 What's New
Added new locomotive models and improved physics simulation.
Railroader Modding Hub
Today at 12:34 PM

Note: The notification includes the mod name, version, uploader, changelog (if provided), and a direct link to download the mod.

Using Roles for Mod Access

Mod authors can restrict their mods to users with specific Discord roles. Here's how it works:

  1. Mod author creates a mod and sets required roles from your server
  2. The bot must be present in your server to verify roles
  3. When users log in to the modding hub, the bot checks their roles
  4. Users with the required roles can access and download the mod

Tip: This is useful for Patreon supporters, server boosters, beta testers, or community members with special access.

Troubleshooting

Bot Not Responding to Commands

  • Make sure the bot has been added to your server
  • Verify the bot has permission to view the channel
  • Check that slash commands are enabled in your server settings
  • Try typing / to see if bot commands appear

Not Receiving Notifications

  • Verify you've subscribed to notifications using /subscribe
  • Check that the bot has permission to send messages in the channel
  • Ensure the bot has "Embed Links" permission
  • Use /list-subscriptions to verify your subscription is active

Role Verification Not Working

  • Make sure the bot is present in your Discord server
  • The bot can only see roles in servers where it's been added
  • Try logging out and back in to the modding hub to refresh role data
  • Role and server changes can take up to 15 minutes to refresh due to caching
  • If you just added the bot or changed roles, wait up to 15 minutes and try again

Need More Help?

Visit our Contact page for additional support.