Newfie’s Chat Guard

Summary:
Server-side mute + chat filter for Vintage Story. Timed/permanent mutes, offline support, word/regex filtering (block / censor / auto-mute). No client install.

Features

• Timed & permanent mutes (10m, 2h, 1d, 3w, perm), auto-expire, persist across restarts.

• Offline targeting by name; stored by UID.

• Configurable chat filter: word list and regex, actions: block, censor, or auto-mute.

• Normalization options: case-insensitive, simple leetspeak folding, punctuation stripping.

• Clear player feedback on attempted chat while muted.

Commands (require privilege newfies.mute)

• /mute <player> <duration|off> — e.g., 10m, 2h, 1d, 3w, perm, or off/0.

• /unmute <player> — works for online or offline players.

• /mutelist — shows active mutes and remaining time.
  Units: s, m (default if omitted), h, d, w.

Configuration

• Config file: VintagestoryData/ModConfig/NewfiesChatGuard.json (auto-created)

• Mute store: VintagestoryData/ModConfig/NewfiesChatGuard.mutes.json (auto-managed)

• Key options:

  • Moderation.EnableBadWordFilter (true/false)

  • Moderation.BannedWords (array of strings)

  • Moderation.BannedRegex (array of regex strings)

  • Moderation.BadWordAction (block | mute | censor)

  • Moderation.AutoMuteDuration (e.g., 15m)

  • Moderation.BadWordNotice (string)

  • Moderation.CaseInsensitive, NormalizeLeetspeak, StripPunctuation (true/false)

Install

1. Place the zip in your server Mods/ folder.

2. Restart the server.

3. Grant the newfies.mute privilege to your moderator group.

Compatibility & Performance

• Server-side only; clients do not need the mod.

• Compatible with most chat mods (if multiple consume chat, load order decides).

• Lightweight: dictionary lookups plus optional regex checks. Keep regex patterns concise.

Troubleshooting

• “Player not found”: names must match exactly (case-insensitive).

• Filter too aggressive: switch action to censor, or disable leetspeak/punctuation normalization.

• Regex not triggering: test regex externally; invalid patterns are safely ignored.

Author: Newfie
Tags: server, moderation, chat, mute, filter, regex, SMP, admin, QoL