Docs/Discord Bot

Discord Bot

The SimSweep Discord Bot manages Patreon tier sync and giveaway or trial keys in the SimSweep Discord server.


The SimSweep Discord Bot manages Patreon tier sync and giveaway or trial keys in the SimSweep Discord server.


What It Does

The bot handles two main things:

  1. Patreon role sync - When someone subscribes through Patreon, the bot assigns the correct Discord role (Decrypt or Override) based on their pledge tier.
  2. Giveaway and trial key management - Staff can generate tier-specific keys for giveaways, manual trials, or support cases outside the normal Patreon flow.

Commands

/key

Staff only

Generates a tier-specific giveaway or trial key. Keys can be tagged as "decrypt" or "override" at creation time, so the bot knows which tier to grant when the key is redeemed.


Role Sync

The bot listens for Patreon webhook events and automatically assigns Discord roles based on pledge tier:

  • Decrypt ($5/mo or $48/yr) - Gets the Decrypt role
  • Override ($10/mo or $96/yr) - Gets the Override role

When a subscription lapses or is cancelled, the role gets removed.


Setup

The bot runs as a Node.js service. It's configured with:

  • Discord bot token
  • Guild (server) ID
  • Role IDs for each tier
  • Patreon webhook secret

It's deployed and managed separately from the main app. Most users never interact with it directly. It just keeps your Discord role in sync with your subscription.