Bot

Bot

Parent section: Core Components

The SDAC bot is the Discord-facing interface. It handles guided submissions, server setup, polls, guessing games, moderation actions, backups, diagnostics, release notifications, and emergency controls.

For first-time Discord setup, see Bot Setup.

User Commands

Common user-facing commands include:

• /commands - shows user command help.
• /submit - starts the guided submission flow.
• /guess - submits an answer for an active guessing game.
• /hint - shows the available hint for the current game.
• /activegame - shows the active guessing game in the channel.
• /polls - lists active polls.
• /votepoll - votes in an active poll.
• /animeactivities, /animeprofile, /animeprofileview, /animeleaderboard, /animechallenge - experimental anime-related activities. These should remain marked as experimental because they may be removed in a future update.

Guided Submissions

The /submit flow asks the user for a category, content, and confirmation. Submissions can include media or text depending on server settings. When approval is disabled, accepted submissions are reposted to the configured submission/category channel. When approval is enabled, staff review the submission before reposting.

Submissions are tracked in the database with user, guild, category, media, status, votes, and moderation metadata. Media should live under media/ and should not be committed to Git.

Categories And Channels

Server staff configure where submissions go:

• /setsubmit sets the default submission channel.
• /clearsubmit clears the default submission channel.
• /setcategory creates or updates a category.
• /editcategory renames or moves a category.
• /deletecategory deletes a category.
• /categories lists current configuration.
• /settings summarizes bot settings.

No channels or categories should be assumed by default in config.json.

Guessing Games

The bot supports guessing games started from Discord or from the website-managed library:

• /startgame starts a guessing game.
• /startlibrarygame starts a random/saved library game where available.
• /schedulegame, /scheduledgames, /cancelscheduledgame manage scheduled games.
• /setguesstimeout sets wrong-guess cooldowns.
• /setgamesettings configures default game behavior.
• /setgamesummarychannel and /cleargamesummarychannel control where summaries post.
• /sethint, /revealhint, /hint, /correct, /cancelgame manage active games.

Game data includes answers, aliases, hints, scores, monthly leaderboards, seasons, streak achievements, and top 10 snapshots.

Polls

Polls can be created and managed from Discord and from the dashboard:

• /createpoll creates a poll.
• /polls lists active polls.
• /votepoll records a vote.
• /closepoll closes a poll.

Polls should respect server scope and admin permissions.

Setup And Diagnostics

Setup commands help server owners configure SDAC without editing files manually:

• /setup opens the setup wizard.
• /setupstatus shows progress.
• /setupchecklist shows setup and production checklist items.
• /setuptest runs a setup test.
• /diagnose checks database, folders, channels, permissions, bot runtime state, public URL, and command sync.
• /checkpermissions checks channel permissions.
• /repairpermissions shows missing permissions and a repair link.
• /repository shows the configured repository information.

Admin And Moderation Commands

Admin commands include:

• /admincommands - shows staff command help.
• /setadminrole and /removeadminrole - grant/remove Discord roles that can manage SDAC.
• /setapproval - configures approval-before-repost.
• /setlimit - sets per-server safety limits.
• /setmoderation - configures blocked words, allowed media types, new-user approval, and spoiler approval.
• /removesubmission and /submissioninfo - inspect or remove submissions.
• /reasonpresets - shows standard action reasons.
• /supportbundle - creates a small diagnostic support bundle.

Operations Commands

Operational commands include:

• /setnotification - routes admin alerts to a channel.
• /seterrorchannel and /clearerrorchannel - route system error notifications.
• /setweeklychannel, /clearweeklychannel, /setweeklytime, /setweeklyday, /settimezone - control weekly posts.
• /setbranding - sets server branding.
• /setfeature - toggles features like submissions, games, approval queues, weekly posts, gallery visibility, and cross-server visibility.
• /setdigest - configures notification digests.
• /sdacpanic - pauses or resumes SDAC activity in a server.
• /sdacreset - restarts the bot process from Discord when allowed.

Backups From Discord

Server backup commands include:

• /backupguide - shows provider setup steps.
• /backupsetup - configures provider settings.
• /setserverbackup - sets a server-specific external backup target.
• /backupnow - creates a backup and optionally uploads it.
• /backupstatus and /serverbackupstatus - show backup status.

Supported rclone-backed providers include Google Drive, OneDrive, Dropbox, Mega, S3, Backblaze B2, Box, and SFTP. Do not put provider secrets in the wiki.

Release Notifications

The bot can announce official updates to configured Discord channels. When release notification behavior changes, verify:

• The server has update notifications enabled.
• The notification channel is configured.
• The latest official release is detected correctly.
• latest-experimental also works when it should point at the most recent official update.

Experimental Anime Activities

Anime-related games and activities are experimental. Keep visible warnings that they might be deleted in the future until they are promoted to stable features.