Documentation

Setting up SAFE

Everything you need to get SAFE running on your server — from inviting the bot to configuring each module. The whole thing is done inside Discord.

1. Invite SAFE

Click Add to Server anywhere on this site, choose your server, and approve the permissions. You'll need Manage Server on that server to add a bot.

Slash commands can take up to an hour to appear the first time Discord registers them globally. If /setup doesn't show right away, give it a little time and refresh Discord.

2. Permissions

SAFE only requests what it needs to do its job. For everything to work, make sure its role sits above the members it has to action, and that it keeps these permissions:

  • Manage Channels & Manage Roles — for tickets and lock/unlock
  • Kick Members, Ban Members, Moderate Members — for moderation commands
  • Manage Messages — for reports and /clean
  • View Channels, Send Messages, Embed Links, Attach Files, Read Message History

3. The /setup panel

Run /setup in your server. You need Discord's Administrator permission, or a SAFE rank with the Configure Bot permission. A private panel opens with a dropdown — pick any category to configure it. Every change saves instantly and is recorded in your audit log.

Staff ranks

SAFE doesn't use a single "staff role." Instead you build ranks that map a role to a set of permissions. A member gets the combined permissions of every rank-role they hold. Server admins always have everything.

In /setup → Staff Ranks, add a rank in three quick steps: pick the role, choose its permissions, then name it. Available permissions include Ban, Kick, Timeout, Warn, Manage Tickets, Manage Reports, View/Manage Cases, Manage Incidents, Review Appeals, Staff Tools and Configure Bot.

Channels

Under /setup → Channels, tell SAFE where things should go: general log, mod log, ticket transcripts, message log, reports, incidents, appeals and the audit log. Anything you leave unset falls back to your General Log, so you can start with just one channel and split things out later.

Tickets & panel

Open /setup → Tickets & Panel to edit your ticket types, the panel's title and intro text, and limits like cooldown and close delay. When you're ready, use Deploy Panel to post the support panel into a channel.

  • Open — members pick a type from the panel dropdown; a private channel is created.
  • Claim / Elevate — staff claim a ticket or elevate it to senior staff.
  • Close — closing saves a full HTML transcript to your ticket-log channel.

Moderation & cases

Moderation commands do the action and keep the paper trail. Each one checks the caller's rank permissions, performs the action, opens a numbered case, posts it to your mod-log, and DMs the member.

/ban    @user  reason  [duration]   → permanent or temporary
/kick   @user  reason
/timeout @user 2h  reason
/warn   @user  reason
/note   @user  note               → private staff note, no DM
/unban  user_id  reason

Review history with /cases @user, view a single case with /case 42, and edit or remove cases with /case-edit / /case-delete (needs Manage Cases). Temporary bans lift themselves automatically when they expire.

Audit logs

In /setup → Audit Logs, set an audit channel and toggle exactly which events get logged: message edits/deletes, joins/leaves, bans, role and channel changes, mod actions — and every settings change made through /setup.

Incidents

Use /incident open to start tracking a live situation with a severity level. The incident post has buttons to assign, add an update, escalate and resolve. List active ones with /incident list.

Appeals

When a member is banned, timed out or warned, SAFE DMs them an Appeal button (this works even after a ban, because it's a direct message). They fill in your custom questions; the appeal lands in your appeal channel with Approve / Deny buttons. Approving a ban appeal can automatically unban them if you enable it in /setup → Appeals.

Premium

All of SAFE's features are free. Premium only unlocks cosmetic branding — custom banners, accent colour and footers. Redeem a key with /redeem, or through /setup → Premium. Check status anytime with /premium.

Command reference

CommandWhat it doesNeeds
/setupConfigure every part of the botConfigure Bot
/redeemActivate a premium keyConfigure Bot
/premiumShow premium statusAnyone
/ban /unbanBan or unban a userBan
/kickKick a memberKick
/timeout /untimeoutMute / unmute a memberTimeout
/warn /noteWarn a member / add a noteWarn
/cases /caseView moderation historyView Cases
/case-edit /case-deleteEdit or remove a caseManage Cases
/incidentOpen / list / resolve incidentsManage Incidents
/appealAppeal an action against youAnyone
/historyA member's full SAFE historyStaff Tools
/slowmode /lock /unlock /cleanChannel toolsStaff Tools
/nick /role /sayMember & utility toolsStaff Tools
Right-click → Report MessageReport a message to staffAnyone
Still stuck? Check the FAQ for the most common questions.