First five minutes

Righteous does almost nothing useful until it has a mute role, a jail role, and somewhere to write logs. ,setup creates those for you, and ,config is where you change everything afterwards. Two commands in that order, and the rest of the bot becomes configurable.

Both need Administrator, on you and on the bot.

Provision the roles and channels

Running it a second time repairs rather than duplicates. An item counts as present only if the stored role or channel still exists, so deleting #welcome means the next run recreates it and stores the new one.

Three variants are worth knowing:

Reach for ,setup update after adding channels to a server that was already set up. New channels don't inherit the mute and jail overwrites on their own.

Open the config panel

,config opens it, and so do the aliases ,settings, ,configuration and ,setting. On slash it's /config panel. Any unrecognised ,config spelling opens it too, so a half-remembered subcommand still lands somewhere useful.

The dropdown at the bottom moves between pages. What each one controls:

Three things about the panel aren't obvious:

It's a normal message in the channel. Anyone who can read the channel sees the panel and its current values, so open it somewhere staff-only. Permissions are checked when a control is used, not when the panel is drawn, so someone without the right permission gets a private refusal rather than a greyed-out button.

Deselecting everything in a dropdown clears that field. Discord populates role and channel dropdowns itself, so there's no "None" option to pick. An empty selection is how you unset a value.

A setting pointing at something you deleted shows as deleted and ignored. That's the panel telling you to set it again, not an error.

Set your prefix

Optional, and worth doing early if you're going to do it at all. People memorise a prefix fast, and changing it later means re-teaching everyone.

Change it on the panel's Overview page, or with ,prefix set <prefix>. That needs Manage Server. ,prefix list shows every prefix the server accepts, and ,prefix reset puts it back to the default. Both need Manage Server too.

Slash commands are unaffected by any of this. /help works whatever your server's prefix is, which makes it the safer thing to put in your own staff instructions.

Turn on what your server needs

None of this is on by default and none of it is required. Start with whichever line describes a problem you actually have.

Welcome, goodbye, boost and join-DM messages have two surfaces. The panel's Messages page edits them all in one place, and each also has its own command — ,welcomemessage, ,goodbyemessage and ,boostmessage. Either way they take the same embed-code syntax as the rest of the bot, so you can write a full embed instead of a line of text.

Common issues

,setup says an item is already present, but you can't see it. The stored role or channel exists and the bot can see it, so you're probably missing View Channel on it. Look in Server Settings → Channels rather than the sidebar.

Setup reports an item as failed. Almost always the bot's own permissions. It needs Manage Roles for the Muted and jailed roles, and Manage Channels for the rest. Grant them and re-run — the successful items are skipped the second time.

An old panel opens on the wrong page. Close it and run ,config again. Reopening rebuilds it from scratch.

Someone with Administrator gets refused by a panel control. A few controls are restricted beyond Administrator, and some need Server Premium. The refusal names which one, and it's private, so only the person clicking sees it.

Where to go next