Server Setup Guide

Configuring Skipper Bot

Everything runs through one command: /config, an interactive dashboard for setting up every feature on your server. This guide walks you through it from first launch to fine-tuning each module. Want a step-by-step guide for a specific feature? Pick a module from the sidebar.

Overview

Skipper Bot is configured entirely from an in-Discord dashboard. There are no text-based setup commands to memorise, you run /config, and navigate menus, modals, and dropdowns to turn features on and tune them.

Features are grouped into modules. Each module (Welcomer, Leveling, Tickets, …) is independent: you enable the ones you want and ignore the rest. Modules are organised into six categories so the dashboard stays tidy.

Good to know

Skipper is made to reply with the least bloat possible, so your chats don't flood with long bot responses.

One command

/config opens the whole dashboard.

6 categories

Moderation, Community, Engagement, Automation, Support, Miscellaneous.

41 modules

Each can be enabled, disabled, and individually configured.

Role-gated

Only admins and the roles you choose can open it.

The config wizard (first run)

The very first time you run /config on a server, the bot detects there are no settings yet and launches the Config Wizard. Only a member with the Administrator permission can start it.

Run /config. A modal titled “Config Wizard” pops up.
Choose access roles. Pick up to 3 roles that should be allowed to open and edit the config later. (Admins always have access regardless.)
Choose an update channel. Select a text or announcement channel where the bot will post update messages and error notifications. The bot checks it has View Channel, Send Messages and Embed Links there.
Submit. The wizard saves your settings and confirms with a summary. From now on, running /config opens the full dashboard instead of the wizard.

Your server timezone is auto-filled from your personal timezone (if you've set one via the timezone command). You can change it later under Settings Timezone.

Navigating the panel

After setup, /config opens the home page. It has three parts:

1 Info banner

Shows who last accessed the panel, which roles have access, the update channel, and a badge if there are unresolved errors.

2 Info menu (top dropdown)

Global tools that aren't tied to a single feature, Settings, Custom bot profile, Backup, History, Errors, Transfer, and Compact view.

3 Category menu (bottom dropdown)

Pick a category (Moderation, Community, …) to drill into its modules. A Search option lets you jump straight to a module by name.

Moving around

Control	What it does
Category dropdown	Opens the list of modules in that category. A ✅/❌ shows whether each is enabled.
Module select	Opens that module's own settings page.
Search	Type a module name (fuzzy-matched) to open it directly.
Back	Returns to the previous page (e.g. the category list).
Home	Jumps back to the main dashboard.

The panel is tied to the person who opened it. Only the member who ran /config can click its buttons and menus. Run the command yourself to get your own panel.

Enabling & configuring a module

Every module follows the same pattern, so once you've configured one you know them all.

Open the module from its category (or via Search).
Enable it. The first menu option toggles the module on (✅) or off (❌). A module must be enabled before its settings take effect.
Adjust settings. Pick options from the module's dropdown. Each opens a channel picker, role picker, or a modal to type values.
Done. Changes save instantly, there's no separate “save” button. A green confirmation appears for each change.

Disabling a module keeps your settings: they're stored and restored if you re-enable it later, so toggling off won't wipe your configuration.

Settings & info menu

The top dropdown on the home page holds server-wide tools:

Item	Purpose
Settings	Core server settings, config access roles, update channel, feedback channel, server timezone, and Family-Friendly mode.
Custom	Give the bot a custom nickname, avatar, and banner just for your server.
Backup	DMs you a JSON hard-copy of your entire config. Useful before big changes.
History	An audit log of who changed what in the config and when.
Errors	Recent error logs the bot recorded for your server, with a “Mark as read” button.
Transfer	Info on migrating level or economy data from another bot into Skipper.
Compact Config	Collapses module lists on the home view so categories show as single lines, handy once you know your way around.

Module categories

Click a category to expand its modules. Each module has its own settings page inside /config, and its own step-by-step guide here. Modules in orange have a full guide written; the rest are documented in the tables below and full guides are on the way.

Moderation

Module	What it does
Moderation	Core moderation systems and settings.
Logging	Log channels for audit events (joins, edits, deletes, mod actions, and more).
Channel Restricts	Restrict which commands or behaviours are allowed per channel.
Honeypot	A bait channel that auto-removes spam bots and compromised accounts.
Backups	Server backup system.

Community

Module	What it does
Welcomer	Welcome & leave announcements, DMs, auto-roles, and role restore.
Giveaways	Create and manage giveaways.
Suggestions	Member suggestion board with voting.
Birthdays	Track and announce member birthdays.
Thanks	Reputation reward system for thanking members.
Boosters	Perks, announcements, and automatic roles for boosters, vanity reps, and tag wearers.
Custom Roles	Let eligible members create personal custom roles.
Social Notifier	Announce new posts/streams from social media.
Counting	A counting channel game.
Reaction Roles	Let members pick their own roles by reacting to a message.

Engagement

Module	What it does
Leveling	XP and levels for chatting, with role rewards.
Economy	Server currency, shop, jobs, games, and more.
Highlights	Highlight-react system for noteworthy messages.
Achievements	Achievement-based reward system.
Daily Quiz	A daily quiz for members.
Stats	Server statistics tracking and display.

Automation

Module	What it does
Auto-threads	Automatically create threads on messages in chosen channels.
Auto-reacts	Automatically react to messages matching rules.
Auto-responders	Trigger-and-response auto replies.
Wildcards	Wildcard (pattern-based) auto responses.
Sticky Messages	Keep a message pinned to the bottom of a channel.
Reminders	Scheduled, repeating messages posted to a channel automatically.
Bump Reminder	Reminders to bump the server via DISBOARD.

Support

Module	What it does
Tickets	Full ticketing system for support requests.
Apply	Application forms (e.g. staff applications).
Modmail	Members DM the bot to reach staff privately.
Help	Settings for the help command.

Miscellaneous

Module	What it does
Embeds	Build and store reusable server embeds.
AI	AI assistant features.
Massreact	The massreact message command.
Hierarchy	Role hierarchy system, refreshed every 5 minutes.
Snipe	Recover recently deleted/edited messages.
TTS	Voice-channel text-to-speech.
Music	Voice-channel music player.
Translate	Message and image translation.
Waifu	The server's custom waifus from the waifu command.

Tips & troubleshooting

Situation	What to do
“Only server admins can start the config wizard”	The first setup must be done by someone with the Administrator permission.
“You do not have permissions to access the config”	You're not an admin and your roles aren't in the access list. Ask an admin to add your role under Settings Access.
“You must enable the module first”	Toggle the module on (✅) before editing its settings.
Buttons don't respond	The panel only works for the person who opened it. Run `/config` yourself.
Bot can't post in a channel	Make sure the bot has View Channel, Send Messages, and Embed Links there.
Want a safety net before big edits	Use Backup to DM yourself a JSON copy of the whole config first.

Need a hand? Join the support server or visit skipperbot.xyz.