Getting started

Adding SlakBot to your server

Where to find it: slakbot.nl → 'Add to your server' button, or in the panel → '➕ Add bot'

To add SlakBot you need the Manage Server permission on that server. Discord shows which permissions SlakBot asks for. Leave them ticked, or some features won't work. Once added, SlakBot picks a language by itself: Dutch if your Discord server's primary language is Dutch, English otherwise.

Steps

1. Go to slakbot.nl and click 'Add to your server'.
2. In Discord, pick your server from the list.
3. Leave the permissions ticked and click Authorize.
4. Then type /setup in a channel on your server.

Logging in to the panel

Where to find it: panel.slakbot.nl

You log in with your Discord account. SlakBot asks Discord for your username and avatar, your server list and your member info on those servers, such as your roles. It never sees your password or your messages. You can only manage servers where you have the Manage Server permission, or that you own. A moderator role without that permission gives no access to the panel.

Steps

1. Open panel.slakbot.nl. You're sent straight to Discord.
2. Click Authorize in Discord.
3. You now land on 'Your Servers'.

Choosing a server

Where to find it: Panel → Your Servers

'Your Servers' lists the servers where you have Manage Server and SlakBot is already in. Click a server to open its settings. If SlakBot isn't in any of your servers yet, you see your servers here with '➕ Add SlakBot'. Pick one and add SlakBot. When you come back to this tab, that server shows up in the list.

Steps

1. Click the server you want to set up.
2. Want to switch later? Click your server's name at the top left of the panel and pick another one.

Overview

Where to find it: Panel → Overview (the first page when you open a server)

The Overview is your home page. It shows your features by group, each with a dot: On, On, but something is still missing, Off, or The bot has stopped. At the top are the things you need to fix yourself, such as a feature that's on but has no channel yet. If SlakBot is missing the Manage Roles permission, you'll see that here too.

Steps

1. Open your server. You land on Overview automatically.
2. Work through the 'things you need to fix yourself' list from top to bottom.
3. Click the button next to a line to go to the right page.
4. Looking for a setting? Use the search box on the left.

Language / Taal

Where to find it: Panel → Bot & content → Language / Taal

Here you choose whether SlakBot uses Dutch or English on this server. That covers command replies, embeds, welcome messages and livestream alerts. The panel switches to the same language.

Steps

1. Open Language / Taal.
2. Under 'Bot language', pick Nederlands or English.
3. Click 'Save'.
4. Is the panel still in the old language afterwards? Refresh the page.

Appearance

Where to find it: Panel → Bot & content → Appearance

Appearance controls how SlakBot's messages look, not its name or profile picture. Under 'Colors and shape' you pick the card colors and the avatar shape: Round, Rounded or Square. Under 'What each message looks like' you choose Card, Embed or Plain text for each message. A card is an image in your colors, an embed is the ordinary Discord block, and plain text is a single line without formatting.

Steps

1. Open Appearance.
2. Pick the colors.
3. Choose the avatar shape.
4. For each message choose Card, Embed or Plain text: Rank card (/rank), Leaderboard (/top), Welcome message, Level-up alert, Shop (/shop), YouTube alert, Farewell message, Goal bar and Supporter wall.
5. Click Save.

Bot name (/botname)

Where to find it: Discord → /botname

Use /botname to give SlakBot a name that only applies on your server. Anyone with Manage Server can do this. SlakBot remembers the name and puts it back after a restart. A profile picture per server isn't possible: the avatar is the same on every server and only SlakBot's maker can change it.

Steps

1. Type /botname in a channel on your server.
2. Enter the new name under name, up to 32 characters.
3. Press Enter. Only you can see the confirmation.

Commands

/setup

Where to find it: Discord → /setup

/setup is your starting point in Discord. It shows what's already set up for YouTube, Twitch, Welcome and Moderation, with buttons to the panel. Only you can see this message. Three quick-start buttons each turn something on in one click: 'Sample rank card' turns on Leveling, 'Welcome here' turns on welcome messages in this channel, and 'Enable Swarm shield' turns on Anti-Scam.

Steps

1. Type /setup in a channel on your server. For 'Welcome here', do that in your welcome channel.
2. Click '🎛️ Open dashboard', or 📺 YouTube, 🟣 Twitch, 👋 Welcome or 🛡️ Moderation to go straight to that page.
3. Or click a quick-start button.

Commands

/help

Where to find it: Discord → /help

/help lists every SlakBot command you're allowed to use on this server. They're in three groups: For everyone, Moderation and Admin. Commands you don't have permission for are hidden. At the bottom is a link to the panel. Only you can see the reply.

Steps

1. Type /help in a channel on your server.

Commands

Permissions SlakBot needs

Where to find it: Discord → Server Settings → Roles → SlakBot

SlakBot can only do what its role in Discord allows. In every channel where it posts, it needs View Channel, Send Messages, Embed Links and Attach Files. To hand out roles it needs Manage Roles, and the SlakBot role has to sit above those roles. For moderation it needs Manage Messages, Kick Members, Ban Members and Timeout Members. If a permission is missing, that feature stays silent in that channel, because Discord blocks it without a message.

Steps

1. In Discord, open Server Settings → Roles.
2. Drag the SlakBot role above the roles it should hand out or moderate.
3. Click the SlakBot role and turn on the permissions your features need.
4. Is a channel private? Check that channel's Permissions too.
5. Refresh the panel. If everything is right, the warnings are gone.