Infractions plugin

Infraction tracking and moderation commands for Dreamliner.

#Commands

#Punishment commands

#Case management

#Configuration

plugins:
  infractions:
    config:
      ban_delete_message_days: 0
      softban_delete_message_days: 7
      notify:
        warn:
          dm: true
        mute:
          dm: false
      require_reason:            # Per-action: reject the command if no reason is given
        warn: true
        ban: true
      default_duration:          # Fallback duration (ms) when the command's duration option is blank
        tempmute: 600000          # 10m
        tempban: 86400000         # 1d
      escalation:                 # Auto-escalation ladder for repeat offenders
        enabled: true
        count_types: ["warn"]     # Which infraction types count toward the strike total
        window_ms: 0              # 0 = count all-time; otherwise only strikes within this window
        steps:
          - after: 3
            type: mute
            duration_ms: 1800000  # 30m
          - after: 5
            type: ban

Grant can_warn, can_note, can_mute, can_kick, can_ban, can_unban, can_softban, can_view, can_edit_reason, can_edit_duration, and can_delete to a Dreamliner Role on the dashboard's Roles page (or /permissions role grant) — see permissions.md. Editing another moderator's case only requires the same can_edit_reason/can_edit_duration permission as editing your own — there's no separate elevated threshold.

#Auto-escalation

When escalation.enabled is true, Dreamliner counts a member's qualifying infractions (escalation.count_types, within escalation.window_ms if set) after every punishment command. If the new total exactly matches a step's after value, that step's punishment is applied automatically and logged as its own case with reason Auto-escalation: reached N infractions. Steps only fire on an exact match, so keep after values strictly increasing (e.g. 3, 5, 8).

Configure all of this — punishment-specific reason requirements, default durations, and the escalation ladder — from the dashboard's Infractions page, which opens each punishment type into its own settings panel similar to Automod.

#Duration format

Timed actions use Dreamliner duration formats: 30s, 5m, 2h, 1d, 1w.

#Expiration

Timed mutes and bans are checked every minute. When a tempmute or tempban expires, the bot clears the timeout or unbans the user and marks the infraction inactive.

Manual /unmute or /unban also clears active infraction records.

#Case log

When the server's moderation_log_channel_id is set (Dashboard → Logging), each action posts a log line to that channel. Case updates, deletions, and expirations are also logged there.