Getting Started
Add sushii to your server and get set up
Invite sushii
Add sushii to your server and keep every permission it asks for. sushii needs View Audit Log to record bans, kicks, and timeouts done through Discord, and its role has to sit above any role it assigns or acts on.
Open the settings panel
Run /settings in any channel. This opens a panel with five tabs: Overview,
Logging, Moderation, Automod, and Welcome.
Each row shows its current state and flags anything that needs attention. Click Edit to change a setting, or Turn on / Turn off for simple switches. Changes save as soon as you make them.
The Overview tab sums up each tab and lists anything that needs attention, such as a log channel that was deleted, a channel sushii is missing permissions in, or a join message that's on with no channel picked.
Set up a mod log channel
If you plan to use sushii for moderation, the most important first step is pointing it to a private moderation log channel:
Picking a channel turns the log on. Clearing the channel turns it off.
sushii posts every moderation case there, including bans, kicks, and timeouts done through Discord itself.
Turn on the features you want
From /settings you can also set up:
- Logging — message edits and deletes, member joins and leaves, and removed reactions, each in its own channel
- Moderation — whether sushii DMs members when they're timed out, kicked, or banned, extra text for those DMs and for warnings, and whether other servers can see your server name and ban reasons in
/lookup - Automod — scam image detection, spam detection, and an alerts channel for automod actions
- Welcome — custom join and leave messages sent to a channel
Level roles, role menus, schedule channels, and tags have their own commands, listed at the bottom of the Overview tab.
You don't have to set everything up at once. Come back to /settings whenever
you're ready to add more.
Setting up XP & Leveling
XP earning is on by default once members start chatting. To reward members for
reaching certain levels, use /levelrole:
Optionally set remove_level if you want the role removed when the member
reaches a higher tier (role progression).
To stop XP from being earned in specific channels or by specific roles:
See the XP & Levels guide for more detail.
Setting up role menus
Role menus let members self-assign roles from an interactive message. They are
configured with /rolemenu, not /settings.
This opens an interactive builder where you can add roles, set descriptions and
emoji, and cap how many roles a member can pick at once. When you're done, use
/rolemenu send to post it to a channel.
Sending feedback
The /settings and /permission-audit panels have a Feedback button at
the bottom, and unexpected errors titled Something went wrong have a Send
feedback button. Either one opens a short form that goes straight to the sushii team. You can
send up to 3 per hour.
Where to go next
- Moderation Guide — cases, commands, and when to use sushii vs. native Discord moderation
- XP & Levels — setting up level roles and blocking XP in specific channels
- Tags — creating custom commands for FAQs and server info
- All Features — a full list of everything sushii can do