Introduction
What Righteous does, what it needs from you, and which guide to read first.
Righteous is a general-purpose Discord bot. Protection, moderation, Last.fm, tickets, voice channels, music and logging all live in the same app, configured from the same panel. This page is the short version: what's in it, how to talk to it, and what it needs from you before any of it works.
See what it covers
Righteous is one bot doing several jobs rather than a single-purpose tool. If you already run a dedicated logging bot or a dedicated music bot, the overlap is real and worth knowing about now.
| Area | What you get | Start here |
|---|---|---|
| Moderation | Ban, kick, timeout, jail, scoped mutes, channel control, punishment history | Moderation commands |
| Protection | Per-action anti-nuke rules, join-rate and alt-account gates, a trap channel, word and link filters | ,antinuke, ,antiraid, ,trap, ,filter |
| Server setup | Roles and channels provisioned for you, then a panel for everything else | ,setup, ,config |
| Logging | Per-category log channels, ignore lists, webhook delivery | ,log |
| Community | Tickets, giveaways, starboard and clownboard, autoroles, levels | ,ticket, ,giveaway, ,levels |
| Voice and music | Join-to-create voice channels with their own panel, plus a full player | ,voicemaster, Music commands |
| Last.fm | Now-playing cards, charts, crowns, server listening stats | ,lastfm |
Economy, images, roleplay and the info commands round out the rest. They're all in the command reference, grouped by category.
Run a command two ways
Every command has a prefix form. Most of the ones you'll use for setup also have a slash form.
Slash commands are the safer instruction to follow. Type / in any channel, pick the command, and
Discord shows you the options as you fill them in. Nothing about a slash command changes from server
to server.
The prefix form is faster once you know it. The default prefix is ,, so ,help and /help do the
same thing. Any server can change its prefix, so a command written ,setup here might be !setup
in yours. /prefix list reports what your server
answers to, and changing it needs Manage Server. Both are covered in
First five minutes.
Examples on this site use the default
Every command written with a comma is showing you the default prefix, not a fact about your server. The slash form is the one that's true everywhere.
Look up a command
,help <command> answers inside Discord. It takes a subcommand too, so
,help antinuke rule goes straight to the leaf.
The command reference is the same information as a linkable page. Each command gets its permissions, its cooldown, its aliases, every subcommand, and whether a slash form exists. Guides link into it constantly, so you can read a walkthrough and check exact syntax without leaving the page.
Know what it needs from you
Three things, in this order.
Manage Server, in the server you're adding it to. That's Discord's requirement for adding any bot, not something Righteous imposes.
Access for that server. Righteous isn't open to every server. One that hasn't been granted access doesn't keep the bot, and it leaves again within seconds of joining. This catches people out at the worst possible moment, so it has its own guide.
Administrator, for the first-run commands. Both
,setup and ,config
require it, on you and on the bot. Everything else asks only for the Discord permission matching
what it does.