Docs

Guides

How the bigger systems actually work. The command reference tells you what a command takes. These tell you why you would use it.

Getting started

Invite the bot, run the first setup, and find out whether your server is entitled.

IntroductionWhat Righteous does, what it needs from you, and which guide to read first.Inviting the botAdd Righteous with the right scopes and permissions, place its role so it can act, and confirm it arrived.First five minutesProvision the roles and channels Righteous expects, then open the config panel and turn on what your server needs.Access and the whitelistWhy Righteous isn't open to every server, what a server without access sees, and how to get access for yours.

Protection

Anti-nuke, anti-raid, the message filters and the trap channel.

Protection overviewUnderstand the four systems that defend a server, what each one watches, and the order to set them up in.AntinukeArm rules against channel deletes, admin grants and vanity theft, then prove they will actually fire.AntiraidPunish a burst of joins, gate young accounts, and lock the server down until the wave passes.Message filtersBlock links, invites, banned words, music files and mass pings per channel, and choose what happens to whoever posts them.Trap channelSet up a channel nobody should ever post in, and punish the self-bots and spam accounts that do.

Last.fm

Link an account, then charts, crowns, WhoKnows and history sync.

Last.fm overviewUnderstand what the Last.fm system does, which tier each feature needs, and which guide to read next.Setup and now playingLink your Last.fm account, post what you're playing, and restyle the card until it looks like yours.WhoKnows and crownsRank your server by artist, album and track, hand out crowns, and post a recurring listening recap.Charts and statsRender a cover collage, read your top artists and albums, and break your library down by genre, country and hour of the day.History, sync and exportCopy your full scrobble history into the bot, ask questions with dates in them, and download the whole thing as a CSV.

Everything else

guides that do not sit under one system

Common issuesWork back from the symptom you can see to the cause behind it, across permissions, role hierarchy, prefixes and protection that never fires.

Something missing or wrong?

These pages live in their own repository, separate from the site.