Skip to Content
DocumentationModeration & Cases

⚖️ Moderation & Audit Cases

Alya offers a complete moderation toolkit with persistent case IDs, customizable warning thresholds, disciplinary escalation, and channel management.


🔨 Moderation Commands

CommandDescriptionSyntax
/banBan a member from the server with optional reason and message purge./ban user:@target reason:Spam
/kickKick a member from the server./kick user:@target reason:Disrespectful
/timeoutMute a member for a specified duration (e.g. 10m, 1h, 1d, 7d)./timeout user:@target duration:1h reason:Caps
/unmuteRemove an active timeout from a member./unmute user:@target
/unbanUnban a user using their Discord user ID./unban id:123456789012345678
/warnIssue a formal disciplinary warning to a member./warn user:@target reason:Self-promotion

📈 Warning Escalation (/warnpunish)

Automate disciplinary escalation when members accumulate multiple warnings:

/warnpunish set count:3 action:timeout duration:1h /warnpunish set count:5 action:kick /warnpunish set count:7 action:ban /warnpunish show /warnpunish clear

When a user reaches the threshold, Alya automatically applies the punishment and documents the triggering case.


📁 Case Audit Trail (/case)

Every disciplinary action is recorded in the database with a unique incremental #ID:

  • /case id:: Inspect the target user, responsible moderator, timestamp, action type, and recorded reason.
  • /caseedit id: reason:: Update the justification or append proof links to an existing case.
  • /casedelete id:: Soft-delete a case (preserves audit integrity).
  • /caserestore id:: Restore a previously deleted case.
  • /clearcase user:: Clear all active disciplinary history for a member upon successful appeal.

🧹 Channel Operations

  • /clear amount:: Bulk delete messages (up to 100 per command, within 14 days).
  • /lock & /unlock: Lock or unlock channel sending permissions for @everyone.
  • /hide & /unhide: Hide or restore channel visibility in the sidebar.
  • /slowmode seconds:: Set message cooldown per user between 0 and 21,600 seconds.
  • /stickynick user: nick:: Lock a member’s nickname to prevent unauthorized changes.
  • /nuke: Clone and recreate the current channel, resetting all message history.
Last updated on