Browse documentation

VIRCON

Moderation

Enforcement tools

Moderation stack

Bans, kicks, warnings, strikes, and appeal workflows for consistent server management.

Action types

Warnings

Non-punitive flags for minor infractions. Visible in history.

Kicks

Temporary removal from the server. Member can rejoin.

Bans

Permanent removal. Cached and enforced on rejoin attempts.

Strikes

Formal records tied to incidents and evidence.

Core features

  • Log every action with safe reason capture and audit trail.
  • Reply to logs to override, edit, or revert moderation reasons.
  • Reply with RR to reset action buttons on moderation embeds.
  • Interactive buttons on logs for quick unban or re-kick.
  • Ban cache with automatic enforcement and sync on join.
  • Appeal workflows tied to incidents and evidence vaults.

Moderation workflow

How actions flow through the system from staff to record.

1

Action taken

Staff member issues warn, kick, or ban with a reason.

2

Log created

Embeds in designated channel with action details and buttons.

3

Database entry

Record stored with timestamp, actor, reason, and metadata.

4

History tracked

Member history updated for future reference and appeals.

5

Cache updated

Bans cached for quick lookup on rejoin attempts.

Database schema

Fields stored for each moderation action.

action_id

Unique moderation action identifier.

guild_id

Server scope for the action.

actor_id

Discord ID of the staff member.

target_id

Discord ID of the member affected.

action_type

warn, kick, ban, or strike.

reason

Staff-provided description of the action.

timestamp

When the action was taken.

appeal_linked

Link to related incident or appeal.

override_history

Edits and reversions tracked.

Quick start

Common tasks and their commands.

  1. 1.Use ,ban <user> <reason> to ban a member with a note.
  2. 2.Reply to the log message to edit the reason or override.
  3. 3.Check ,userhistory <user> to see all moderation actions.
  4. 4.Link bans to incidents for appeal workflows.
  5. 5.Use staff leaderboards to track active moderators.

Related systems

Moderation works alongside trust scoring, incidents, and appeals.