FAQ

How to punish someone, hand out roles, run a giveaway, fix levels and find your way around.

​

Getting started

​

How do I add Criminal?

Use the invite link. You need Manage Server, and Criminal’s role must sit above any role it should hand out or remove.

​

What should I set up first?

Four commands cover most servers:

/setup mute
/setup jail
/config channel log-channel #mod-logs
/config toggle automod enabled:True

That gives you mute and image-mute roles, a jail channel, one place for every log entry, and AutoMod. Everything is re-runnable.

​

How do I find a command?

/help groups every command by category, and /help <command> shows one command’s options and who can use it. If something isn’t in /help, it isn’t available in your server.

​

Can I use comma commands?

Yes · set the prefix once with /config text prefix ,. Then ,ban @user spamming works like /ban, and ,help lists the prefix versions.

​

Moderation

​

How do I punish someone?

Want	Use
Remove a message	Delete it, or /purge 50 --user @user for a range
Cool someone down	/mute @user 10m or /imagemute @user 1h
Stop them posting at all	/jail @user 1h
Kick or ban	/kick @user reason · /ban @user reason
Ban and wipe recent messages	/mod softban @user
Log it without action	/warn @user reason

Every action creates a numbered case. /mod case <id> shows one, /mod modlogs @user shows a member’s history, and /mod warnings @user lists active warnings.

​

How do I stop spam and raids?

Turn on AutoMod, then enable just the rules you need:

/config toggle automod enabled:True
/automod filter rule:"server invites" enabled:True
/automod action action:"delete and warn"

For bot raids, arm a honeypot channel with /honeypot edit · anyone who posts in it is punished automatically. Staff with Manage Messages are always exempt.

​

Someone deleted a message · can I see it?

/snipe shows the most recent deleted message in the channel, and /editsnipe the last edit. Both are per channel and in memory only, so they’re gone after a restart.

​

Roles

​

How do members pick their own roles?

Two options, both persistent:

• Reactions · /reactionrole add binds an emoji to a role. Use mode:add for verification so un-reacting can’t remove access, or mode:toggle for interest roles.
• Buttons and menus · /embed can add role buttons and select menus to a message, which is cleaner for a public “click to get access” panel.

Boosters can share their own colour with /boosterrole share.

​

Criminal says it can’t give a role · why?

The role is above Criminal’s own top role. Drag Criminal’s role higher in Server Settings → Roles and try again. /vanity status and /levelreward set warn about this before you save.

​

Levels and rewards

​

How does levelling work?

Each message earns a random 15–25 XP, once per 60 seconds per member. The curve is 50 × level^1.6, so level 10 takes about 2,000 XP. /level draws your rank card, /ranks shows the top 100.

Turn it on and give levels a home:

/config toggle levels enabled:True
/config channel levelup-channel #level-ups

Rewards are roles at a level: /levelreward set 10 @Active. Roles above Criminal’s top role are refused up front.

​

Why didn’t I get XP for a message?

XP has a 60-second cooldown, so fast chatting doesn’t stack. Bots never earn XP, and leveling must be enabled before messages start counting.

​

Engagement

​

How do I run a giveaway?

/giveaway start prize:"Nitro" duration:3d winners:3

Duration caps at 60 days and winners at 25. Members enter with the button on the post; /giveaway end closes early, /giveaway reroll picks new winners. Needs Manage Server.

​

How do suggestions work?

Set a channel, then members post with /suggest:

/config channel suggestion-channel #suggestions

Each suggestion gets up/down voting, and staff close it with /suggestion approve, deny or implemented. /suggestion list shows what’s still open.

​

What is the Sob Board?

A starboard for the crying emoji. Set a channel and a threshold:

/config channel starboard-channel #sob-board
/config number starboard-threshold 3

A message needs that many 😭 reactions to be reposted. NSFW channels and channels @everyone can’t see are skipped.

​

How do vanity roles work?

Criminal reads custom statuses, not bios. Set a keyword and a role, and anyone advertising it gets the role:

/config toggle vanity enabled:True
/config role vanity-role @Advertiser
/config text vanity-keyword /yourinvite

Only online members are checked · run /vanity rescan after changing the keyword.

​

How do social feeds work?

/social add platform:YouTube account:@handle channel:#updates follows a creator. A server can follow up to 30 accounts, checks run every 2–10 minutes, and only posts made after you followed are announced · the newest three after downtime, never the whole backlog.

​

Limits and privacy

​

What are the limits?

Thing	Limit
Giveaway winners	25
Giveaway duration	60 days
Social follows per server	30
Sob Board threshold	Set per server, default 3
Embeds per message	10
Buttons per row	5

​

What does Criminal store about members?

Per server: settings, moderation cases, levels and XP, suggestions and votes, giveaway entries, starboard mappings, vanity eligibility and name history. Deleted message text is kept for 7 days in the log channel, and the snipe cache is in memory only.

​

How does someone clear their own data?

/clearnames deletes a member’s own name history. Everything else belongs to the server’s records, so the server owner decides. Last.fm links are private by default and can be unlinked with /lastfm remove.

​

Something is broken

Check Troubleshooting first · most issues are a missing role, an unset channel or a module that’s still off. If that doesn’t cover it, ask in the support server with the command you ran and the reply you got.