Troubleshooting
The bot does not answer, a message is not sent, a command is missing.
- /crossban, /snapshot or the prefix answer “OriusBot Pro feature”: what now?The management commands reserved for Pro (synced ban, channel backup, command prefix) and what the message means.
- A member reached the warning threshold but wasn’t sanctioned: why?The reasons an automatic warning sanction doesn’t fire: module off, threshold at 0, expired or revoked warnings, role hierarchy.
- A new or renamed command doesn’t show up: do I need to update something?OriusBot itself sends the commands to Discord; you just need to refresh Discord. How to see what changed.
- How do I contact OriusBot support, and what should I tell them?Where to ask for help, what information to give to be helped quickly, and when to use /report-dev instead of support.
- How do I know which permissions the bot is missing on my server?Use /audit health to list the eight permissions the bot needs, what breaks when one is missing, and understand the “I’m missing a permission” messages.
- How do I place the bot role above the roles to give (hierarchy)?Step by step in Discord: drag the OriusBot role above the roles it has to assign, and check the “Manage Roles” permission.
- How do I report a bug or suggest an idea with /report-dev?The /report-dev command sends a bug, an idea or an improvement to the OriusBot team, in three simple questions.
- How do I run a health check on my server (/audit health)?Reading the report: bot permissions, key modules enabled, broken configurations (deleted channel or role) and extra commands deployed.
- My announcements or birthdays go out at the wrong time: how do I fix it?A one- or two-hour shift almost always comes from the server’s timezone. How to check and fix it.
- My command prefix is rejected or doesn’t respond: what should I check?The rules the prefix symbol must follow (1 to 5 characters, forbidden ones, “!” reserved), the Pro requirement and what to check when nothing responds.
- My log channel stays empty: what should I check?The five reasons nothing arrives in a log channel: no channel, log switched off, ignored role, deleted channel, bot without write access.
- OriusBot does not answer my commandsThe checks to make, in order, when a command gets no answer or Discord shows “The application did not respond”.
- OriusBot shows as offline or greyed out on my server: what do I do?Telling apart an absent bot, an offline bot and an online but silent bot, and knowing when to wait or alert support.
- OriusBot’s “/” commands don’t show up in DiscordWhen I type “/”, no OriusBot command appears: the order of checks, from the most common cause to the rarest.
- The bot says “Invalid duration”: how do I fix my command?The most common causes of a rejected duration (missing unit, extra text, zero, too long) and the right way to write it.
- The panel shows “Could not load this data” or stays empty: what should I do?What to try, in order, when a panel page won’t load: retry, reload, log in again, contact support.
- What do “A source could not be read” and “items shown out of” mean in To do?The two warnings on the To do page: an incomplete queue because of an unreadable source, or a truncated list when there are too many items.
- What do the “command disabled”, “not allowed in this channel” and “slow down” messages mean?The five refusals tied to a command’s state (disabled, channel, cooldown, usage limit, daily limit), their symbol and where to set them.
- What do the /bump replies mean (“Already bumped”, “not listed yet”)?The three possible /bump replies: no listing, 4-hour delay in progress, temporary error.
- What do the error messages mean when I connect my Twitch channel?The messages shown when you return from Twitch (authorization refused, link expired, invitation-only access…) and what to do for each.
- What to do when Discord shows "The application did not respond" or "Interaction failed"?Discord's error message after a command: try again, check the bot's status, report the problem.
- Why can’t the bot ban, kick or mute someone (role hierarchy)?The “Unable to moderate this user (role higher than or equal to mine)” message: what the role hierarchy is and how to move the bot’s role up, step by step.
- Why can’t the bot moderate my Twitch chat?The bot can talk without being able to moderate until the permission is granted: how to give it by reconnecting the channel.
- Why does /role or /nick fail on some members or some roles?The two conditions that make /role and /nick fail: the bot's role must be above the role given and the member, and the Manage Roles / Manage Nicknames permissions.
- Why does a command only work in some channels?A command can be limited to certain channels or delayed by the administrator; Discord can also hide it per channel.
- Why does my RSS feed not announce any article?Invalid or private address, unreadable feed, first article not announced, channel: the points to check.
- Why does OriusBot tell me I don't have permission to use a command?A command is refused: missing Discord permission, role blocked by the administrator, or role hierarchy.
- Why does the bot leave the voice channel by itself?The two automatic departures: channel empty of listeners, or queue finished.
- Why does the bot not write in my announcement channel (Twitch, YouTube, RSS)?The causes when an alert does not show in the chosen channel: deleted channel, non-text channel, missing bot permissions.
- Why does the bot say music is temporarily unavailable?The “Music is temporarily unavailable” message, YouTube interruptions and what you can try in the meantime.
- Why does the Coach ask me to reconnect my channel (missing permissions)?Some data (followers, viewers present, channel points, predictions, hype trains) needs permissions that Twitch has you grant.
- Why does the command tell me I don’t have permission?The reasons for a “You don’t have permission to use this command” refusal: blocked role, unauthorized role, missing Discord permission, and how to fix it step by step.
- Why does the live alert arrive a little late (and only once)?The bot checks Twitch at regular intervals: what explains a slight delay, and why there is never two announcements for the same live.
- Why does the music not start?All the /play refusal messages and their fixes: no voice channel, permissions, full channel, module starting, search unavailable.
- Why does the panel say “Twitch channel not found” when I add a channel?Which name to enter, what “Channel found”, “Did you mean” and “Unable to verify” mean, and why adding is still possible.
- Why does the Twitch live alert not arrive on my server?The checks to do in order when a channel goes live without an announcement: channel name, channel, bot permissions, quota and normal delay.
- Why does the YouTube announcement arrive several minutes after upload?The bot reads channels’ public feed about every 5 minutes: a delay is normal, and the older video is not announced when adding.
- Why doesn’t a sanction show up in /modlogs, or why is its reason cut off?What /modlogs and /case really contain: actions made through the bot, the last 15, a reason truncated at 300 characters.
- Why doesn’t a sanctioned member receive the bot’s private message?Sanctions notify the member by DM when possible; if their DMs are closed or block the bot, the sanction still applies, with no error.
- Why doesn’t my custom Twitch command trigger?Name already used by a built-in command, command disabled, access level too strict, cooldown running: the causes and their fixes.
- Why doesn’t my server listing appear in the public list?Listing saved but not published, invalid invite, 18+ server hidden, or server excluded from the list.
- Why doesn’t the bot answer in my Twitch chat?The three conditions shown in “Overview” (access open, moderation allowed, bot active) and how to fix each one.
- Why doesn’t YouTube post my new video in Discord?The possible reasons when a recent video isn’t announced: delay, first video after adding, wrongly entered channel, channel permissions.
- Why don’t I see any server in the Twitch area’s Discord link?The conditions for a server to appear: linked Discord account, owner or administrator, OriusBot present and the “Manage Server” permission.
- Why don't OriusBot's slash commands appear when I type /?The most common causes when "/" shows no OriusBot command: channel permission, integration, missing Discord permission, bot offline.
- Why is the role not mentioned in my alerts?The role to mention is optional, is chosen from the list and only notifies its members: how to check and fix it.
- Why isn’t my recurring Twitch message showing?The four reasons: channel offline, quiet chat, interval not elapsed, message disabled.
- Why won’t /record start?All the refusal messages of /record start: missing permission, voice channel, music playing, empty channel, recording limit.
- Why won’t my embed publish (“Sending failed”)?The two error messages of the Embed designer and the permissions to give the bot in the channel.