Newfies Chat Guard

<h1 data-start="115" data-end="136">Newfie&rsquo;s Chat Guard</h1> <p data-start="138" data-end="312"><strong data-start="138" data-end="150">Summary:</strong><br data-start="150" data-end="153" />Server-side mute + chat filter for Vintage Story. Timed/permanent mutes, offline support, word/regex filtering (block / censor / auto-mute). No client install.</p> <h2 data-start="314" data-end="325">Features</h2> <ul data-start="326" data-end="710"> <li data-start="326" data-end="426"> <p data-start="328" data-end="426">Timed &amp; permanent mutes (<code data-start="353" data-end="358">10m</code>, <code data-start="360" data-end="364">2h</code>, <code data-start="366" data-end="370">1d</code>, <code data-start="372" data-end="376">3w</code>, <code data-start="378" data-end="384">perm</code>), auto-expire, persist across restarts.</p> </li> <li data-start="427" data-end="472"> <p data-start="429" data-end="472">Offline targeting by name; stored by UID.</p> </li> <li data-start="473" data-end="561"> <p data-start="475" data-end="561">Configurable chat filter: word list and regex, actions: block, censor, or auto-mute.</p> </li> <li data-start="562" data-end="655"> <p data-start="564" data-end="655">Normalization options: case-insensitive, simple leetspeak folding, punctuation stripping.</p> </li> <li data-start="656" data-end="710"> <p data-start="658" data-end="710">Clear player feedback on attempted chat while muted.</p> </li> </ul> <h2 data-start="712" data-end="758">Commands (require privilege <code data-start="743" data-end="757">newfies.mute</code>)</h2> <ul data-start="759" data-end="1023"> <li data-start="759" data-end="847"> <p data-start="761" data-end="847"><code data-start="761" data-end="792">/mute &lt;player&gt; &lt;duration|off&gt;</code> &mdash; e.g., <code data-start="801" data-end="806">10m</code>, <code data-start="808" data-end="812">2h</code>, <code data-start="814" data-end="818">1d</code>, <code data-start="820" data-end="824">3w</code>, <code data-start="826" data-end="832">perm</code>, or <code data-start="837" data-end="844">off/0</code>.</p> </li> <li data-start="848" data-end="909"> <p data-start="850" data-end="909"><code data-start="850" data-end="868">/unmute &lt;player&gt;</code> &mdash; works for online or offline players.</p> </li> <li data-start="910" data-end="1023"> <p data-start="912" data-end="1023"><code data-start="912" data-end="923">/mutelist</code> &mdash; shows active mutes and remaining time.<br data-start="964" data-end="967" /><strong data-start="967" data-end="977">Units:</strong> <code data-start="978" data-end="981">s</code>, <code data-start="983" data-end="986">m</code> (default if omitted), <code data-start="1009" data-end="1012">h</code>, <code data-start="1014" data-end="1017">d</code>, <code data-start="1019" data-end="1022">w</code>.</p> </li> </ul> <h2 data-start="1025" data-end="1041">Configuration</h2> <ul data-start="1042" data-end="1642"> <li data-start="1042" data-end="1128"> <p data-start="1044" data-end="1128"><strong data-start="1044" data-end="1060">Config file:</strong> <code data-start="1061" data-end="1111">VintagestoryData/ModConfig/NewfiesChatGuard.json</code> (auto-created)</p> </li> <li data-start="1129" data-end="1220"> <p data-start="1131" data-end="1220"><strong data-start="1131" data-end="1146">Mute store:</strong> <code data-start="1147" data-end="1203">VintagestoryData/ModConfig/NewfiesChatGuard.mutes.json</code> (auto-managed)</p> </li> <li data-start="1221" data-end="1642"> <p data-start="1223" data-end="1241"><strong data-start="1223" data-end="1239">Key options:</strong></p> <ul data-start="1244" data-end="1642"> <li data-start="1244" data-end="1293"> <p data-start="1246" data-end="1293"><code data-start="1246" data-end="1278">Moderation.EnableBadWordFilter</code> (true/false)</p> </li> <li data-start="1296" data-end="1343"> <p data-start="1298" data-end="1343"><code data-start="1298" data-end="1322">Moderation.BannedWords</code> (array of strings)</p> </li> <li data-start="1346" data-end="1399"> <p data-start="1348" data-end="1399"><code data-start="1348" data-end="1372">Moderation.BannedRegex</code> (array of regex strings)</p> </li> <li data-start="1402" data-end="1462"> <p data-start="1404" data-end="1462"><code data-start="1404" data-end="1430">Moderation.BadWordAction</code> (<code data-start="1432" data-end="1439">block</code> | <code data-start="1442" data-end="1448">mute</code> | <code data-start="1451" data-end="1459">censor</code>)</p> </li> <li data-start="1465" data-end="1512"> <p data-start="1467" data-end="1512"><code data-start="1467" data-end="1496">Moderation.AutoMuteDuration</code> (e.g., <code data-start="1504" data-end="1509">15m</code>)</p> </li> <li data-start="1515" data-end="1554"> <p data-start="1517" data-end="1554"><code data-start="1517" data-end="1543">Moderation.BadWordNotice</code> (string)</p> </li> <li data-start="1557" data-end="1642"> <p data-start="1559" data-end="1642"><code data-start="1559" data-end="1587">Moderation.CaseInsensitive</code>, <code data-start="1589" data-end="1609">NormalizeLeetspeak</code>, <code data-start="1611" data-end="1629">StripPunctuation</code> (true/false)</p> </li> </ul> </li> </ul> <h2 data-start="1644" data-end="1654">Install</h2> <ol data-start="1655" data-end="1796"> <li data-start="1655" data-end="1708"> <p data-start="1658" data-end="1708">Place the zip in your <strong data-start="1680" data-end="1690">server</strong> <code data-start="1691" data-end="1698">Mods/</code> folder.</p> </li> <li data-start="1709" data-end="1733"> <p data-start="1712" data-end="1733">Restart the server.</p> </li> <li data-start="1734" data-end="1796"> <p data-start="1737" data-end="1796">Grant the <code data-start="1747" data-end="1761">newfies.mute</code> privilege to your moderator group.</p> </li> </ol> <h2 data-start="1798" data-end="1828">Compatibility &amp; Performance</h2> <ul data-start="1829" data-end="2053"> <li data-start="1829" data-end="1879"> <p dat