Moderation Commands
Warn, kick, ban, timeout, and note commands, plus case history, mod logs, and an escalating punishment ladder.
On this page
Overview
Java Lava's core moderation commands respect Discord's role hierarchy. A moderator can never action someone with an equal or higher role than them, including Java Lava's own role. This is always on and isn't configurable.
Every action is recorded as a case with a moderator, target, reason, and timestamp, viewable and editable from the dashboard's Cases tab or with /cases. An optional escalating punishment ladder can automatically apply harsher actions (mute, kick, ban) once a member crosses a set number of strikes within a rolling window.
The Moderation page also lets you customize exactly which event categories (bans, kicks, message edits, role changes, etc.) get posted to your mod log and which channel each one goes to.
Setup
- 1
Enable the Moderation module
Toggle Moderation on from the Overview page or the Moderation page's own header toggle.
- 2
Set your mod-log channel
From the Mod Log tab, choose which channel receives action logs, then enable the specific event categories you want posted there.
- 3
Configure the punishment ladder (optional)
Define strikes 1 through N and what action fires at each (warn → mute → kick → ban), plus a strike-expiry window so old infractions stop counting.
- 4
Set DM-on-punishment behavior
Choose whether targets get DMed when punished, and whether that DM includes the reason.
Examples
Illustrative mockups of what moderation commands posts in Discord. They are not a live capture, but they match the real thing.
A ban action posted to the mod log
🔨 Member Banned
Member
@Spammer123 (`812345678901234567`)
Moderator
@Valenvyre
Reason
Repeated advertising after two warnings
Case #42 • Today at 3:04 PM
Configuration options
| Option | Description |
|---|---|
Respect Role Hierarchy Default: Always on | Moderators can never action someone with an equal or higher role than themselves, or higher than Java Lava's own role. Always on, not configurable. |
Mod Log Channel | Channel where moderation actions are posted automatically. |
Mod Log Event Categories Default: Ban/kick/mute, message deletes, message edits, member joins on | Which categories post to the mod log: message edits/deletes, member joins/leaves, role changes, ban/kick/mute, nickname changes, and voice activity. Each is independently toggleable with its own destination channel. |
DM on Punishment Default: On | Whether the target is DMed when a punishment ladder action fires against them. |
DM Includes Reason Default: On | Whether the punishment DM includes the moderator's stated reason. |
Escalating Punishment Ladder | A sequence of strike thresholds, each mapped to an action (warn, mute with duration, kick, or ban). |
Strike Expiry Default: 30 days | Number of days after which a strike stops counting toward the punishment ladder. |
Timeout Duration Presets | Quick-select durations for /timeout: 5 minutes, 10 minutes, 1 hour, 1 day, 1 week. |
Permissions
Bot permissions required
Who can configure this
Anyone with the dashboard's Owner or Admin access tier (Staff Access page), or Editor tier for day-to-day config changes
Commands
Click any command to copy it.