Infractions

Warn, mute, kick and ban with commands that keep a numbered case for everything, DM the member, log it for your team and can escalate repeat offenders automatically.

  • Beginner
  • 14 min read
  • 9 steps
  • Updated 13 November 2026

By the end, you'll have

  • Your moderators warning, muting, kicking and banning with commands, every action saved as a case
  • Punishment DMs, required reasons and default durations set up the way your server works
  • A moderation log, the Cases page for reviewing history, and optional automatic escalation

Before you start

Infractions is the heart of moderation in Dreamliner. Every warning, mute, kick and ban becomes a case: a permanent, searchable record of what happened, who did it and why. That history is what lets your team spot repeat offenders, explain decisions and let members appeal.

Every action is a case

Numbered, searchable and editable, in Discord and on the dashboard.

Members are told

A DM explains what happened and why, sent before a kick or ban so it still arrives.

Repeat offenders escalate

Optional ladder: three warnings become a mute, five become a ban.

Step 1 · about 1 min

Turn Infractions on

Enable the plugin so the commands work.

Infractions starts switched off, so the moderation commands don't work until you turn it on.

  1. Open your server on the dashboard, open Moderation in the sidebar and click Infractions.
  2. Switch on Enabled at the top of the page and press Save in the save bar.
The dashboard sidebar with Infractions selected, and the Enabled switch at the top of the Infractions page
Infractions is under Moderation in the sidebar (1). The Enabled switch is at the top of its page (2).

While you're on the plugin, a Cases item appears under it in the sidebar. That's where your moderation history lives (step 7).

Step 2 · about 1 min

Check Dreamliner can actually punish

Avoid the most common reason a mute or ban fails.

Discord has to allow each action for both the moderator and Dreamliner:

ActionDreamliner and the moderator both need
Mute / unmuteModerate Members (Discord's timeout permission)
KickKick Members
Ban, tempban, softban, unbanBan Members
Warn, noteNothing extra

Step 3 · about 3 min

Learn the moderation commands

Know which command to use for what.

Each command takes the member, an optional reason, and sometimes a duration. Run any of them and you get a reply titled with the case number.

CommandWhat it does
/warnRecords a warning and DMs the member. Nothing else happens to them.
/noteA private staff note on someone's record. Never DMs them.
/muteTimes them out using Discord's timeout, for up to 28 days. Ends by itself.
/unmuteEnds a timeout early.
/kickRemoves them from the server. They can rejoin with an invite.
/banBans permanently, optionally deleting up to 7 days of their messages. Works on people who already left.
/tempbanBans for a set time, then Dreamliner unbans them automatically.
/softbanBans and immediately unbans, to wipe their recent messages. Acts like a kick.
/unbanUnbans by user ID.

Step 4 · about 3 min

Configure each punishment type

Set required reasons, default durations and the DM members get.

Under Punishment types there's a row for Warn, Mute (timeout), Kick, Softban, Tempban and Ban. Each row shows its current setup, like "Reason required", "DMs member" or a default duration. Press Configure on a row to change it:

SettingWhat it doesDefault
Require a reasonThe command refuses to run without a reason.Off
Default duration (minutes) / (hours)Mute and Tempban only. Used when a moderator leaves the duration out.None
DM the memberSends them a message about the action.On
Custom DM messageYour own wording instead of the standard message, up to 400 characters.Standard message
The Punishment types section listing Warn, Mute, Kick, Softban, Tempban and Ban, each with a Configure button
Every punishment type has its own Configure button (1).

Custom DM messages can use {action}, {guild}, {reason}, {mod} and {expires}. Press Done, then Save.

The Configure punishment window for Mute, with Require a reason, Default duration, DM the member and Custom DM message
Configuring Mute (timeout): require a reason, set a default duration and choose the DM.

Step 5 · about 2 min

Set the shared options

Decide how much message history bans delete, and where cases are logged.

In the General section:

SettingWhat it doesDefault
Ban delete history (days)How many days of messages /ban and /tempban delete when the moderator doesn't choose (0–7).0
Softban delete history (days)How many days /softban deletes (0–7).7
Moderation log channelPress Open Logging settings to choose where cases are posted.Not set

Step 6 · about 3 min

Escalate repeat offenders automatically (optional)

Turn repeated warnings into mutes or bans without anyone having to remember.

Under Automation, press Configure on Auto-escalation. It's a ladder: when someone's case count reaches a number, Dreamliner applies the next punishment for you.

  1. Switch on Enabled.
  2. Under Strikes, pick what Counts toward strikes. Warns only is the usual choice.
  3. Set Count within (minutes) to only count recent cases. For example, 43,200 minutes is 30 days. Use 0 to count every case ever.
  4. Under Steps, press Add step for each rung: the number of Strikes, the Punishment and, for mutes and tempbans, how long.
  5. Press Done and Save.
StrikesPunishmentExample
3Mute60 minutes
5Tempban24 hours
7BanPermanent
The auto-escalation ladder window with what counts as a strike, the counting window and the steps
The escalation ladder: what counts as a strike, the counting window, then the steps.

Step 7 · about 2 min

Review and edit cases

Find any case, fix a reason, attach evidence, or share it.

Click Cases under Infractions in the sidebar. Every warn, mute, kick and ban is listed with its case number, type, target, moderator, reason, date and status.

  • Search by case number, reason text or a user ID, or open Filters to narrow by type, status, member or moderator.
  • Click a case to see everything about it: the reason (editable), when it expires, and the member's last 20 messages captured as evidence.
  • Press Upload screenshot to attach proof (PNG, JPEG, GIF or WebP, up to 8 MB).
  • Press Make public to get a shareable link to the case, handy for appeals or transparency. Unpublish takes it down again.
The Cases page with a search box, the Filters button and a table of cases
Search cases (1) or narrow them down with Filters (2).

The same is possible in Discord:

CommandWhat it does
/infraction viewShows one case.
/infraction searchFinds up to 15 cases by number, user ID or reason, optionally filtered by type.
/infraction reasonChanges a case's reason.
/infraction durationChanges how long an active mute or ban lasts, counted from when it was given.
/infraction deleteDeletes a case. Only possible in Discord.
/evidence addSaves a member's recent messages (up to 50) as evidence.

Step 8 · about 2 min

Decide who can do what

Give each team exactly the moderation powers it needs.

Each command has its own permission, granted to Dreamliner Roles on the Roles page. Out of the box:

Built-in roleGets by default
ModeratorWarn, note, mute and unmute, kick, view cases, edit reasons, edit durations
AdminBan, tempban, unban, softban, delete cases
MemberNone
Give admins both roles
The Admin role only adds the ban-level powers. Link your admin Discord role to Moderator as well, so admins can warn and mute too.
Evidence is off for everyone
Nobody gets /evidence add by default. Tick it on Moderator if you want moderators to capture messages by hand.

Remember Admin Bypass: the owner and anyone with Administrator or Manage Server can always use everything. See Set up staff permissions.

Step 9 · about 2 min

Test it on a spare account

See the whole flow from a member's side.

  1. As a moderator, run /warn on a test account with a reason. You get a reply with the case number.
  2. Check the test account's DMs for the warning message, and your moderation log channel for the case.
  3. Run /mute with 2m, then watch the timeout end by itself. The case closes automatically.
  4. Open InfractionsCases on the dashboard and find both cases.

You're set up

What you just did

  • Turned Infractions on and checked Dreamliner can moderate
  • Configured reasons, durations and DMs for each punishment, plus where cases are logged
  • Set up escalation if you wanted it, learned the Cases page and gave each team the right powers

Punished members deserve a way to ask for a second look. Appeals adds an Appeal button to every punishment DM and a review queue for your team.

Common questions

"I cannot moderate that member (role hierarchy)"

Dreamliner's role is at or below the member's highest role. Move Dreamliner's role above them in Server Settings → Roles.

"No duration given and no server default is configured"

Add a duration to the command (like 10m), or set a default under Punishment types → Mute (timeout) → Default duration.

The member didn't get a DM.

They probably have DMs from server members turned off. The action still happened, and your log records that the DM failed. People who aren't in the server never get DMs.

Can I punish someone who already left?

Yes for bans, warnings and notes: use their user ID. They won't get a DM, since they're not a member any more.

Do warnings expire?

Warnings stay on record. For escalation, use Count within (minutes) so only recent cases count toward the next step.

Is any of this paid?

No. Every command, the Cases page, evidence and escalation are free.

Read next