SkullBot

Documentation

SkullBot documentation

Step-by-step guides for Discord server owners and moderators. Every document starts with a short answer.

Getting started

Adding the bot, the dashboard and permissions.

Getting started with SkullBotHow to add SkullBot to your Discord server, give it permissions, log in to the dashboard and turn on your first modules in a few minutes.The SkullBot dashboard: tabs and server settingsHow the SkullBot dashboard works: picking a server, the Overview, Moderation, Community, Notifications, Commands & music, AI and Settings tabs, saving changes and Module status.SkullBot permissions and the bot roleWhich Discord permissions SkullBot needs for each module, how role hierarchy works and how to fix a module that does not work using Module status.

Moderation

Punishment commands, warning escalation, spam and raids.

Moderation commands: ban, kick, mute, warn and case historyHow to use the SkullBot moderation commands: /ban with temporary bans, /kick, /mute, /warn, /cases with a numbered action history and the modlog.Warning escalation: automatic punishments after N warningsHow to set up automatic mute, kick or ban in SkullBot after a number of warnings, and how thresholds and time limits work.Spam protection: links, cross-channel spam, filters and the honeypotThe four SkullBot layers against Discord spam: link blocking, cross-channel spam detection, in-channel spam filters and the honeypot trap channel with a configurable deletion window.Raid protection: mass joins of new accountsHow SkullBot raid protection works: detecting mass joins of new accounts, raid mode, actions (alert, mute, kick, ban) and the alert channel.

Community

Welcome messages, levels, roles, verification and tickets.

Welcome messages, auto-roles and the level system (XP)How to set up welcome and goodbye messages, auto-roles for new members and the level system with XP, multipliers and level reward roles in SkullBot.Role menus and verification of new membersHow to set up role menus with buttons (several roles or just one), button verification and voice verification for new members in SkullBot.The ticket system: panel, categories and transcriptsHow to set up tickets in SkullBot: a panel channel with a button, a category, a support role, an open ticket limit and transcripts after closing.Temporary voice channels: join to create your own channelHow to set up a SkullBot trigger channel that gives everyone a separate voice channel with their own name, limit and kicking, and removes it when everyone has left.

Notifications

Streams and videos from YouTube, Twitch and Kick.

Stream and video notifications: YouTube, Twitch and KickHow to set up Discord alerts in SkullBot for a LIVE stream and a new video on YouTube and for a stream on Twitch and Kick (beta), with custom text and a role ping.

Music and AI

Music, command access and AI chat.

Music and command access: DJ role, volume and channel limitsHow music works in SkullBot (commands, queue, radio), how to set a DJ role, a volume limit and default volume, and how to turn command categories off and limit them to channels.AI chat on a Discord server (SkullAI)How the SkullBot AI chat works: the VIP plan, assigning a server, choosing channels and the /ai command, without image generation.

Help

Common questions.

FAQ: common questions about SkullBotAnswers to common questions about SkullBot: permissions, the dashboard, language, modules that do not work, data and privacy, and notifications.

Quick answers

Does SkullBot need the Administrator permission?

Not for the dashboard modules: they need only the permissions of what you enabled, and Module status shows which are missing. The exceptions are the /kick and /mute commands, which check for Administrator. The full list is in the permissions document.

Do dashboard changes apply immediately?

Yes. After saving, the bot uses the new settings right away. Command and automod settings are cached briefly, so the full effect can take up to a minute.

What does "role is above the bot role" mean?

The bot cannot assign a role that sits higher than its own. Drag the bot role higher in Server settings, Roles.

How do I ban for a limited time?

Use /ban with the duration option, for example 7d. Allowed units: m, h, d, w, one year at most.

Does the punishment fire at every later warning?

No. Each rule fires once, at its threshold. For punishments at the 3rd and 6th warning add two rules.

Will the spam filters punish moderators?

No. Administrators and people with Manage Messages are skipped, as are the chosen roles and channels.