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