
ChatPurity
一个非常强大的聊天净化MOD,具有广泛的配置选项和强大的检测功能,包括白名单、黑名单、同音字检测、单字符检测、替换等多种功能 A very powerful chat purification mod with extensive configuration options and strong detection features, including whitelist, blacklist, homophone detection, single character detection, repla
About this Mod
中文:
ChatPurity 聊天过滤
一个专为中国 MC 社区设计的服务器聊天净化模组,超多配置、超强检测,包括白名单、黑名单、谐音、单字检测、替换等功能。
白名单支持精确匹配、包含匹配、正则表达式,还能把敏感词替换成三星堆,或者像某服务器把 L 变成 love。
还有:
词组检测;
拼音检测:guang 告;
谐音字检测:镐高这种同音字;
防刷屏;
等等
模组配置
配置文件在 config/chatpurity/ 下面,改完输入 /chatpurity reload 热重载,不用重启服务器。
命令
所有命令需要 OP 权限。
基础命令
/chatpurity help 显示帮助
/chatpurity reload 重载配置
白名单管理
/chatpurity whitelist add <词> 添加白名单
/chatpurity whitelist remove <词> 移除白名单
/chatpurity whitelist list 列出白名单
黑名单管理
/chatpurity blacklist add <词> [模式] 添加黑名单
/chatpurity blacklist remove <词> 移除黑名单
/chatpurity blacklist list 列出黑名单
检测模式
默认:包含检测,只要包含指定词就屏蔽
homophone:同音词检测,检测同音词、同音字
pinyin_abbr:拼音缩写检测,检测拼音首字母
pinyin_full:完整拼音检测,检测完整拼音
exact_match:精确匹配,只检测完全相同的词或重复词
OP权限控制
op1:OP1及以下会被屏蔽,OP2/3/4可发送
op2:OP2及以下会被屏蔽,OP3/4可发送
op3:OP3及以下会被屏蔽,OP4可发送
op4:所有人都会被屏蔽
模式可组合使用,用冒号分隔,如 homophone:pinyin_abbr:pinyin_full
替换词管理
/chatpurity replacement add <原词> <替换词> [模式] 添加替换规则
/chatpurity replacement remove <原词> 移除替换规则
/chatpurity replacement list 列出替换规则
模式与黑名单相同
禁言管理
/chatpurity mute add <玩家> <时间> 禁言玩家
/chatpurity mute remove <玩家> 解除禁言
/chatpurity mute list 列出被禁言玩家
时间单位:s(秒)、min(分钟)、h(小时)、d(天)、-1(永久)
English:
ChatPurity Chat Filter
A server-side chat purification mod designed specifically for the Chinese MC community, with extensive configuration and powerful detection, including whitelist, blacklist, homophone, single-character detection, replacement, and other features.
The whitelist supports exact match, contain match, regular expressions. You can also replace sensitive words with ***, or change "L" to "love" like some servers do.
Also includes:
Phrase detection;
Pinyin detection: guang 告;
Homophone detection: same-sounding characters like 镐 and 高;
Anti-spam;
etc.
Mod Configuration
Configuration files are under config/chatpurity/. After editing, type /chatpurity reload to hot-reload without restarting the server.
Commands
All commands require OP permissions.
Basic Commands
/chatpurity help Show help
/chatpurity reload Reload configuration
Whitelist Management
/chatpurity whitelist add
/chatpurity whitelist remove
/chatpurity whitelist list List whitelist
Blacklist Management
/chatpurity blacklist add
/chatpurity blacklist remove
/chatpurity blacklist list List blacklist
Detection Modes
Default: Contain detection, block if the message contains the specified word
homophone: Homophone detection, detects homophone characters and words
pinyin_abbr: Pinyin abbreviation detection
pinyin_full: Full pinyin detection
exact_match: Exact match, only detect exactly identical or repeated words
OP Permission Control
op1: OP1 and below will be blocked, OP2/3/4 can send messages
op2: OP2 and below will be blocked, OP3/4 can send messages
op3: OP3 and below will be blocked, OP4 can send messages
op4: Everyone will be blocked
Modes can be combined, separated by colons, e.g. homophone:pinyin_abbr:pinyin_full
Replacement Management
/chatpurity replacement add
/chatpurity replacement remove
/chatpurity replacement list List replacement rules
Modes are the same as blacklist
Mute Management
/chatpurity mute add
/chatpurity mute remove
/chatpurity mute list List muted players
Time units: s(seconds), min(minutes), h(hours), d(days), -1(permanent)
Available Versions
How to Install ChatPurity on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.11).
Install Mod
Open the mod browser in the dashboard and search for "ChatPurity". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.11, 1.21.10, 1.21.9 (+16 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
ChatPurity server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.11). You can switch loaders with one click in the panel.
Is ChatPurity compatible with fabric?
ChatPurity officially supports fabric for Minecraft 1.21.11, 1.21.10, 1.21.9. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with ChatPurity – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if ChatPurity consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install ChatPurity with just one click on your server.