Ledra Docs

Moderation commands

13 commands for kicks, bans, timeouts, warnings and the case log.

All 13 require Moderator level, except /clearwarns which requires Administrator.

Every one replies privately, and every action that changes something creates a case.


/kick#

Remove a member from the server. They can rejoin with a new invite.

Option Required Description
member yes The member to kick
reason no Why (max 400 characters)

Ledra needs: Kick Members · Cooldown: 5 per 30 s

/kick member:@Someone reason:Ignoring staff warnings

/ban#

Permanently ban a user.

Option Required Description
user yes The user — also accepts a user ID
reason no Why (max 400 characters)
delete_days no Delete their messages from the last N days (0–7, default 0)

Ledra needs: Ban Members · Cooldown: 5 per 30 s

/ban user:@Someone reason:Raid account delete_days:1
/ban user:123456789012345678 reason:Pre-emptive ban

Accepting a user ID lets you ban someone who is not on the server yet.


/tempban#

Ban for a limited time. Lifted automatically when it expires — including after a bot restart.

Option Required Description
user yes The user to ban
duration yes e.g. 12h, 7d, 1w — max 1 year
reason no Why
delete_days no Delete recent messages (0–7)

Ledra needs: Ban Members · Cooldown: 5 per 30 s

/tempban user:@Someone duration:7d reason:Repeated spam

Duration formats


/unban#

Lift a ban.

Option Required Description
user yes User ID of the banned user
reason no Why

Ledra needs: Ban Members · Cooldown: 5 per 60 s

/unban user:123456789012345678 reason:Appeal accepted

A banned user cannot be mentioned, so this takes an ID. Get it from the ban list in Server Settings, or from the original case with /case.


/timeout#

Mute using Discord's native timeout. The member stays and can read, but cannot speak or react.

Option Required Description
member yes The member to mute
duration yes e.g. 10m, 2h, 7dmax 28 days
reason no Why

Ledra needs: Moderate Members · Cooldown: 10 per 30 s

/timeout member:@Someone duration:2h reason:Cool down

28 days is Discord's own ceiling. For longer, use /tempban.


/untimeout#

Remove a timeout early.

Option Required Description
member yes The member to unmute
reason no Why

Ledra needs: Moderate Members · Cooldown: 10 per 30 s

Tells you plainly if the member is not timed out.


/warn#

Issue a warning.

Option Required Description
member yes The member to warn
reason yes What the warning is about

Cooldown: 10 per 30 s

/warn member:@Someone reason:Please keep politics in #debate

The reason is mandatory here — a warning nobody can explain later is worse than none. The reply shows their new active warning count.


/unwarn#

Revoke a warning by case number.

Option Required Description
case yes Case number of the warning
reason no Why it is revoked

Cooldown: 10 per 30 s

The case is kept and marked revoked, recording who did it.


/warnings#

List a member's active warnings (up to 25).

Option Required Description
member yes Whose warnings

/clearwarns#

Revoke every active warning of a member at once.

Option Required Description
member yes Whose warnings

Level: Administrator · Cooldown: 5 per 60 s

Asks for confirmation, showing the count first.


/case#

Full details of one case: member, moderator, reason, timestamps, expiry, status, and who resolved it.

Option Required Description
number yes The case number

/modlogs#

Moderation history — the 15 most recent entries.

Option Required Description
member no Restrict to one member; omit for the whole server
/modlogs
/modlogs member:@Someone

/purge#

Bulk delete recent messages in the current channel.

Option Required Description
amount yes How many messages to examine (1–200)
member no Only delete this member's messages

Ledra needs: Manage Messages, Read Message History · Cooldown: 3 per 30 s

/purge amount:50
/purge amount:100 member:@Spammer

amount is how many messages are checked, not how many are deleted. With member: set, amount:100 looks at the last 100 messages and deletes only that member's.

Discord forbids bulk-deleting messages older than 14 days.

Works in text channels and threads.

Moderation guide

Ledra documentation. Everything here describes the hosted bot.