Warnings
Active for 12 hours, then auto-expire from the punishment scheduler.
Benefit
Consistent, time-boxed warnings without manual cleanup.
Use case
Flag repeat low-severity behavior like spam or inappropriate language.
Features
Purpose-built moderation tools.
Warden focuses exclusively on structured punishments and moderator workflows. Every feature exists to make professional moderation faster, fairer, and more auditable.
Chat Mutes
Uses the Warden Chat Muted role with predefined reasons and durations.
Benefit
Uniform outcomes across every moderator — no arbitrary timers.
Use case
Cool off toxicity, ping spam, and chat disruption for 30m–7d.
Voice Mutes
Uses the Warden Voice Muted role with voice and stage overwrites, plus an immediate server voice mute.
Benefit
Silences disruptive users instantly and durably.
Use case
Mic spam, screaming, soundboard abuse, or voice trolling.
Bans
Standard Discord account bans with configurable message deletion window.
Benefit
Clear, permanent action for the most severe violations.
Use case
Raiding, scamming, hate speech, ban evasion, and malicious links.
Punishment Timelines
Chronological, read-only audit view combining warnings, mutes, bans, tags, revokes, and expirations.
Benefit
Full user context in one private embed.
Use case
Review a user's full history before deciding on the next action.
Case History
Permanent case records — expired and revoked cases are never deleted.
Benefit
A durable audit trail your team can trust.
Use case
Refer back to any past case by ID months or years later.
Moderator Shift Tracking
Mark In / Mark Out shifts with duration and action totals.
Benefit
Attendance and workload visibility without extra tools.
Use case
Track staff activity and generate shift summaries per moderator.
Punishment Revokes
Owner/Admin/toproles can revoke any active punishment — including bans by user ID.
Benefit
Clean reversal path with a proper audit event.
Use case
Overturn appeals or lift accidental punishments.
Private User Tags
Staff-only notes with severity, private note, and optional evidence URL.
Benefit
Track suspicious behavior without punishing the user.
Use case
Watchlist users with a pattern of borderline behavior.
Structured Logging
Embed logs sent to the configured moderation and shift log channels.
Benefit
Human-readable, staff-visible audit stream.
Use case
Feed staff channels and archive moderation history.
Whitelist Roles
Separate, noncumulative permissions per punishment type: warn, chat mute, voice mute, ban.
Benefit
Grant only the powers a role needs.
Use case
Give trial mods warn-only, seniors full punishment access.
Permission Validation
Panel ownership, role hierarchy, bot permissions, and target validity are rechecked on every step.
Benefit
Prevents mistakes and cross-moderator interference.
Use case
Multiple staff running punishment panels in the same channel.
Automatic Expiration
The scheduler atomically claims due punishments with FOR UPDATE SKIP LOCKED.
Benefit
No stuck mutes, no double-expiration, no race conditions.
Use case
12h warnings, temp mutes, and 30d ad bans lift on time.
Persistent Punishments
Expirations are database-polled, not in-memory timers.
Benefit
Survives restarts, redeploys, and hosting migrations.
Use case
Panels reboot Warden mid-shift with zero data loss.
Deterministic Case IDs
Case IDs like WD000247 are derived from the MySQL identity column.
Benefit
Globally unique, race-condition free, easy to reference.
Use case
Quote a case ID in appeals or reports.
Audit Logs
Every case has a linked event trail: issue, DM, expire, revoke, mismatch.
Benefit
Full forensic detail per case.
Use case
Investigate what happened around a specific incident.
Moderator Activity
Shift summaries count warnings, mutes, bans, revokes, and tags added.
Benefit
Objective staff performance data.
Use case
Review activity fairly during staff evaluations.
Scalable Architecture
MySQL 8, connection pooling forced to UTC, database-backed job claiming.
Benefit
Runs cleanly on shared hosts and dedicated servers alike.
Use case
Small communities and large multi-server networks.
Fast Slash Commands
Slash-command panels are ephemeral — only the invoker sees them.
Benefit
Private staff workflows inside any channel.
Use case
Handle punishments without exposing moderation context.
Prefix Commands
Every slash command has a prefix twin using the fixed > prefix.
Benefit
Keyboard-first workflow for veteran moderators.
Use case
Rapid moderation in staff-only channels.