Punishments
Ban, kick, mute, jail, timeout — and every temporary variant.
Warnings
Warn members and escalate automatically at set counts.
Cases & history
Every action is logged with an editable reason and a case number.
Purging
Delete messages by author, content, type or position — 30+ filters.
Channels
Lockdowns, slowmode, hiding, nuking, threads.
Roles
Mass assignment, temp roles, role links, restoring on rejoin.
Before you start
Two things need setting up once, or half the commands won’t work.1
Move mira's role up
Discord will not let a bot moderate anyone whose highest role sits above the bot’s own. Drag mira near the top of the role list — above your staff roles, below nothing that matters.
2
Create the mute and jail roles
mute, jail, imute and rmute need, and creates the missing roles and channel overwrites. Requires Manage Roles and Manage Channels.If you add channels later, re-sync them:Things that apply everywhere
Hierarchy is always enforced
Hierarchy is always enforced
You can’t punish someone whose highest role is at or above your own, and neither can mira. This holds even with fake permissions — it’s checked against the person running the command, not just the bot.The server owner can never be punished by anyone.
Reasons are optional but tracked
Reasons are optional but tracked
Every punishment command takes a trailing reason. If you don’t give one, a default is recorded. Reasons are stored on the case and can be edited afterwards, so a rushed ban can be documented properly later.Frequently-used reasons can be saved as templates:
Silent punishments
Silent punishments
Adding
-s or --silent to a reason suppresses the DM that would otherwise be sent to the punished member.Custom responses
Custom responses
What mira replies with after a moderation command is fully customisable per command, including the DM the member receives:
!invoke variables lists what you can use. Full details on the Cases page.Multiple targets
Multiple targets
Several commands accept more than one member at a time —
massban, voicekick, role multiple. Where they do, separate targets with spaces: