FAQ

Questions people actually ask

Billing and entitlement on one side, permissions and Discord’s own quirks on the other. Every answer has its own link — paste it straight into a support thread.

Getting started

How do I add Righteous to my server?

Click Add to Discord in the nav or on the homepage, pick your server, and approve the requested permissions. Then run the ,setup command — see the prefix question for which prefix your server uses — or /setup, to walk through first-run provisioning.

#q1-add
What permissions does Righteous need?

It depends on which features you use — moderation commands need the matching Discord permission (Ban Members, Kick Members, etc.), and Anti-Nuke specifically needs View Audit Log to detect anything at all (see the Anti-Nuke question). The bot requests a broad set on invite so most features work immediately, but you can trim per-channel overwrites afterward; a command will tell you what it’s missing if it can’t act.

#q2-permissions
Why isn't Righteous responding to any commands?

The most common cause is that your server isn’t currently whitelisted/entitled — Righteous gates guild access behind an entitlement system, and an un-entitled guild goes quiet rather than posting an error to every channel. Ask an admin, or ask in the support server, to check your server’s status. The second most common cause is a missing bot permission in the channel you’re testing in — check that Righteous can view and send messages there.

#q3-silent
My slash commands aren't showing up, or they're outdated. What do I do?

Global slash-command deploys take about an hour to propagate to every server after they’re pushed — if a command was added or changed recently, wait before assuming something’s broken. If it’s been longer than an hour, try restarting Discord; the client caches command lists.

#q4-missing-slash
I ran a guild-only deploy and now every command shows twice — is that a bug?

No. A guild-scoped deploy instantly registers commands to your one server for testing, on top of whatever the last global deploy already registered there — so while both exist, every command appears twice in that guild. This is inherent to how instant guild-scoped testing works, not a bug, and it clears itself automatically the next time a global deploy runs.

#q5-double
What's Righteous's command prefix?

The default is ,, as in ,help. The bot also answers to the word prefixes jason and righteous (jasonhelp works too). The prefix is per-server and changeable: run ,prefix to set your own, which means a prefix printed anywhere on this site is a default rather than a fact about your server. Every slash command works regardless of prefix, so /help is always available if you’re unsure what yours is set to.

#q6-prefix

Permissions & troubleshooting

Righteous isn't deleting messages, banning or muting — what's wrong?

Check two things: the bot’s role must sit above the roles it’s trying to act on in your role hierarchy, and the bot needs the matching permission (Manage Messages, Ban Members, Moderate Members) either globally or in that specific channel. Righteous checks hierarchy before acting, so it will refuse rather than fail unpredictably.

#q7-cant-act
I armed Anti-Nuke but it never seems to trigger. Why?

Anti-Nuke detects through Discord’s audit log, which means the bot needs the View Audit Log permission — without it, detection silently never fires. There’s no error message for this, because Discord doesn’t tell a bot it lacks a permission it never tried to use; check your permission overwrites and re-invite with the requested scope if it was trimmed.

#q8-antinuke
Can I use fake or custom permissions to let a role use a command without giving it the real Discord permission?

Yes — Righteous has a fakepermission system for exactly this, configured per-server.

Needs an owner decision before launch

How much of the fakepermission system gets documented publicly — the full mechanic here, or a pointer from here to a longer guide under Docs — has not been decided yet. Until it is, this entry stays a pointer rather than a tutorial. Ask in the support server for the current setup steps.
#q9-fakeperms
Does Righteous work in DMs, or without being in a server?

Some Last.fm and Spotify commands are user-installable and work outside a server; most moderation, logging and protection features are guild-only by nature, since there’s no server to protect in a DM. Check the individual command’s page on /commands for its availability.

#q10-dms
A command says it's missing a bot permission but I gave the bot Administrator. What's happening?

Channel-level permission overwrites can still block a bot even with a server-wide Administrator role, if that channel explicitly denies the bot a permission. Check the channel’s permission overwrites, not just the server-wide role.

#q11-admin

Premium & billing

What do I get with Premium, and how much does it cost?

There are three separate tiers — Boosting Premium (free, just boost the server), Self Premium ($2.99/mo or $29.99/yr), and Server Premium ($7.99/mo or $79.99/yr, covering the whole server rather than per-member). The full side-by-side perk breakdown lives on /premium — Discord’s own message size limit means ,donate can’t reliably show every perk in one card, which is the whole reason that page exists.

#q12-tiers
How do I actually buy Premium?

You subscribe with ,donate in the support server, which opens a Stripe checkout; Manage subscription on the same card opens Stripe’s Billing Portal to update your card, see invoices or cancel (plan switching is not offered — cancel and resubscribe to change plan). Buying is Discord-side only, because the checkout is bound to your Discord account. /premium documents what each tier includes; it doesn’t sell it directly.

#q13-buy
I boosted the server or bought Self Premium — why don't I have the perks I expected?

Check which tier a perk is actually under on /premium — Boosting Premium, Self Premium and Server Premium are three different, non-overlapping products, not tiers of the same ladder, so boosting doesn’t grant Self-Premium-only perks and vice versa.

Needs an owner decision before launch

There is no published refund policy yet, and this page will not state one. What happens to Self or Server Premium if a purchase has to be reversed is still an owner decision — /refund-policy is an empty stub for exactly that reason. Until it exists, a billing problem goes to the support server.
#q14-missing-perks
What happens to Server Premium if I leave or transfer the server, or to Self Premium if I leave the server I bought it for?

Server Premium is tied to the guild, not any one member, so it stays with the server regardless of membership changes. Self Premium is tied to the purchasing member’s account, so it follows them, not the server.

Needs an owner decision before launch

Those two sentences describe how an entitlement is attached today. They are not a transfer policy: what happens when a server changes ownership entirely has not been decided, so nothing here should be read as a promise that Server Premium survives a handover. Ask in the support server before transferring a server.
#q15-transfer

Data & privacy

What data does Righteous store about me or my server?

Server configuration (settings, logging preferences, whitelist status), moderation history, and — if you link an account — your Last.fm username and cached listening data.

Needs an owner decision before launch

The exact retention window, and whether there is a formal data-deletion request path, are still owner decisions. /privacy is an empty stub for that reason, and this page will not guess a number in its place. To ask about your own data now, use the support server.
#q16-data
I linked my Last.fm account — can I unlink it, and does Righteous post anything to Last.fm itself?

You can unlink with the account-management command in the Last.fm category. Righteous only reads your Last.fm scrobble data; it never posts, scrobbles or writes back to your Last.fm account.

#q17-lastfm

Support

Something's broken, or I have a question this page doesn't answer. Where do I go?

Join the support server and ask — that’s the fastest path to an actual person, and it doubles as proof the bot and its team are active.

#q18-support
Is Righteous open source? Can I contribute?

No — the bot’s source is closed, and so is this website’s own code. What is public is the documentation: the guides under /docs live in a public repo that takes community pull requests, so a typo, a clearer explanation or a missing example is a normal PR. This FAQ and the rest of the marketing pages aren’t in that repo — they ship with the private site code, so the way to change one of them is to ask in the support server.

#q19-oss
Is Righteous actively maintained — when was it last updated?

Check /blog’s changelog stream — every merge to the bot’s main branch auto-deploys within about two minutes, and the changelog is the dated record of what shipped, rather than a claim made once on this page and never revisited. /status answers the live half of the same question, and renders “unknown” the moment its data goes stale rather than a green tick it can’t justify.

#q20-maintained

Still stuck?

Ask in the support server — fastest path to an actual person.

Join the support server