## **ChatGuardian – 强大的 Minecraft 聊天管理**
ChatGuardian 是一个现代、强大且网络就绪的 Minecraft 聊天管理插件，专为单服务器和大型多服务器网络而设计。 无论您运营一个小型社区还是一个庞大的网络，ChatGuardian 都能帮助您保持聊天干净、公正和安全。
**✨ 关键特性**
高级 Leetspeak 和模糊词语检测
使用智能文本匹配算法检测甚至伪装或伪饰的违规行为。
通过 MySQL 的全局违规跟踪
使用共享数据库在整个网络中同步警告、踢出和禁令。
灵活且可配置的惩罚系统
自定义警告、踢出、临时禁令和永久禁令的阈值，以适应您的社区。
实时 Discord Webhook 集成
直接在您的 Discord 服务器中接收警报，以便立即采取管理员操作。
实时黑名单管理
无需重启服务器即可随时添加或删除禁止使用的词语。
完全可定制的消息和多语言支持
个性化所有面向玩家的消息，以获得无缝且本地化的体验。
**安装与设置**
将插件 JAR 文件放入服务器的 /plugins 文件夹中。
启动服务器一次以生成配置文件。
编辑 config.yml 以启用 MySQL 并调整插件行为。
（可选）编辑 messages.yml 和 blacklist.yml 以进行自定义措辞和黑名单术语。
重启服务器以应用更改。
MySQL 设置（全局违规跟踪）
在 config.yml 中启用并配置 MySQL：
> mysql:
>
> enabled: true
>
> host: localhost
>
> port: 3306
>
> database: chatguardian
>
> username: youruser
>
> password: yourpass
所有违规行为和禁令都将使用此数据库跟踪和共享到所有服务器。
**黑名单 & 词语过滤**
在 blacklist.yml 的 words: list 下添加黑名单中的词语。
智能 Leetspeak 和模糊匹配可确保最大限度地防止伪装的语言。
**⚖️ 惩罚配置**
在 config.yml 中自定义惩罚限制和时长：
> punishments:
>
> enabled: true
>
> warn-limit: 1
>
> kick-limit: 2
>
> tempban-limit: 3
>
> tempban-time: 1h
**Discord 集成**
在 config.yml 中设置您的 Discord webhook URL，以实时接收违规警报。
您还可以设置支持 Discord 邀请链接，该链接将在禁令/踢出消息中显示。
**命令**
> /cg addword 将一个词添加到黑名单
>
> /cg delword 从黑名单中删除一个词
>
> /cg listwords 列出所有黑名单中的词语
>
> /cg reload 重新加载插件配置
>
> /cg violations 查看玩家的违规记录（仅限 MySQL）
>
> /cg clearviolations 清除玩家的违规记录（仅限 MySQL）
>
> /cg bans 列出所有活动禁令（仅限 MySQL）
>
> /cg unban 取消禁令（仅限 MySQL）
**权限**
chatguardian.admin - 授予访问所有管理员命令的权限
chatguardian.bypass - 使用户免受聊天检查
**自定义**
修改 messages.yml 以更改所有插件消息。
在 blacklist.yml 中管理您的黑名单。
在 config.yml 中 support-discord 下设置您的 Discord 邀请。
ChatGuardian 是维护您的 Minecraft 服务器或网络中尊重和安全沟通的终极工具——无论您的玩家群体的规模如何增长。