Default moderation.yml

Last updated Oct 28, 2026

Default moderation.yml

Shipped defaults from SoapsAdmin 1.7.7. After first run, this file lives in plugins/SoapsAdmin/.

Updating the jar does not overwrite your live copy. Use this page to compare or reset.

See also: Config Reference · Moderation

# Punishments, freeze, reports, warn escalation, item blacklist
# Jail rooms → jails.yml · Modules → modules.yml

staff:
  broadcast-punishments: true
  silent-prefix: "<gray>[Silent] </gray>"

freeze:
  # hard = no move · soft = look around
  mode: hard
  block-chat: true
  block-commands: true
  command-whitelist:
    - "/sa"

moderation:
  ip-ban-enabled: false
  mute-block-commands: true
  mute-command-whitelist:
    - "/msg"
    - "/r"
    - "/reply"
  # When staff omit a reason on /sa kick|ban|mute|warn (and temp* / banip)
  default-reasons:
    kick: "Kicked by staff"
    ban: "Banned by staff"
    mute: "Muted by staff"
    warn: "Warned by staff"
    banip: "IP banned by staff"

alt-detection:
  # Shared networks that should not flag alts
  trusted-ips: []

# Exact warn-count match; each threshold fires once
# Types: kick, tempmute, tempban, mute, ban
warn-escalation:
  enabled: true
  auto-reason-prefix: "[Auto] "
  silent: false
  thresholds:
    2:
      type: kick
      reason: "Warning threshold reached (2)"
    3:
      type: tempmute
      duration: "1h"
      reason: "Excessive warnings (3)"
    5:
      type: tempban
      duration: "1d"
      reason: "Excessive warnings (5)"
    10:
      type: ban
      reason: "Excessive warnings (10)"

reports:
  cooldown-seconds: 60

# /sa qp <template> | types: kick, ban, tempban, mute, tempmute, warn
templates:
  hacking:
    type: ban
    reason: "Unfair Advantage / Hacking"
  chat-spam:
    type: tempmute
    duration: "1h"
    reason: "Chat Spam"
  toxicity:
    type: tempmute
    duration: "3h"
    reason: "Toxic Behavior"
  advertising:
    type: mute
    reason: "Advertising"
  exploiting:
    type: tempban
    duration: "7d"
    reason: "Exploiting"
  minor-offense:
    type: warn
    reason: "Minor Rule Violation"

item-blacklist:
  enabled: false
  # blacklist = listed blocked | whitelist = only listed allowed
  mode: blacklist
  scan-on-join: true
  scan-on-pickup: true
  scan-on-craft: true
  scan-on-inventory-click: true
  notify-player: true
  exempt-creative: false
  log-to-console: true
  items:
    - BARRIER
    - COMMAND_BLOCK
    - COMMAND_BLOCK_MINECART
    - CHAIN_COMMAND_BLOCK
    - REPEATING_COMMAND_BLOCK
    - STRUCTURE_BLOCK
    - STRUCTURE_VOID
    - JIGSAW
    - DEBUG_STICK
    - BUNDLE
    - LIGHT
    - BEDROCK
    - SPAWNER
    - END_PORTAL_FRAME
    - KNOWLEDGE_BOOK
    - PETRIFIED_OAK_SLAB

Still stuck? Ask about this page