Configuration

Modes and enforcement

How flags turn into alerts, kicks and bans.

Modes

Mode	What happens
`observe`	Written to `violations.log` only. No alerts, no kicks.
`alert`	Staff alerts, Discord and dashboard. The player never notices.
`kick`	Everything `alert` does, plus a kick at the limit. Kicks count toward auto-ban.

anticheat.mode caps every check. Set it to observe, or run /sentinel observe on, to make the whole plugin log-only.

Violation levels and decay

Each flag adds vl-amount to the player's level for that check. Every decay-interval-ticks (40 by default, 2 seconds) every level drops by decay-rate (1.2). A player who stops doing the suspicious thing falls back to zero on their own.

Blatant escalation

Alert-only movement checks still kick outright cheating. Moving at 2.2 times the limit for three ticks in a row is kicked even when speed is in alert mode. Set blatant-multiplier to 0 in a check's section to turn this off.

Auto-ban

config.yml

anticheat:
  auto-ban:
    enabled: true
    kicks-to-ban: 5
    kick-window-minutes: 90
    ban-duration-hours: 24

Five real kicks inside 90 minutes earn a 24 hour ban. Alerts and observe findings never count. Lift a ban with /sentinel unban <player>.