SAC Stats Bot Setup

Add the monitor and configure a status channel

1. Add the bot

Use the Add Stats Bot link above and review the requested permissions in Discord before authorizing. The current invite requests permission value 8 (Administrator). Only add bots you trust, and keep the bot's role below trusted staff roles.

2. Create a status embed

Run /setup and select the text channel where the status message should appear. You may also choose an optional role or user to notify when the monitored bot changes status. The bot updates this message during its status checks.

/setup channel:#bot-status ping_role:@Moderators

3. Automatic status updates and database

The bot checks the monitored bot automatically and updates the configured embed. It synchronizes configuration, maintenance mode, and status history with the shared Supabase bot_documents table when SUPABASE_URL and a server-only SUPABASE_SERVICE_ROLE_KEY (or SUPABASE_SECRET_KEY) are configured. SQLite remains a local durable copy; on Railway set DB_PATH to a file on a mounted persistent volume so local data survives redeployments.

Copy the variable names from the Stats Bot .env.example into the hosting provider's secret/environment settings. Do not commit real credentials or put the Supabase key in browser code.

4. Stop tracking

Run /remove to delete the status embed and stop tracking for this server. The server owner, an administrator, or an existing delegated manager can manage the tracker.

Troubleshooting

  • If status does not appear, check that the bot can view and send messages and embed links in the selected channel.
  • If a role/user notification is missing, confirm the chosen target still exists and can be mentioned.
  • If database writes fail, confirm the configured SQLite database path is writable and the Railway volume is mounted.
← Stats Bot OverviewCommand Reference →