# CleanerX
CleanerX 是一个高级插件，旨在过滤和替换不当语言，使用审查的替代方案或完全删除它们，从而确保干净和尊重的游戏环境。它允许您配置自动执行命令，例如，对反复使用冒犯性语言的玩家进行惩罚，当达到指定的违规次数后。该插件还阻止在聊天中发送链接，如果需要，您可以使用简单的命令清除聊天。
## 🔹 特性
- ✅ 根据配置，进行部分或完全的词语审查
- ✅ 能够阻止不受欢迎的链接
- ✅ 通过命令将自定义词语添加到黑名单中，无需重启服务器
- ✅ 通过命令将自定义词语添加到白名单中，无需重启服务器
- ✅ 基于配置自动执行命令——推荐与 PunisherX 集成
- ✅ 能够使用命令清除聊天
- ✅ 插件更新通知，并可以选择启用自动更新
- ✅ 广泛的配置文件以进行灵活的设置。 检查默认设置 [在此](https://github.com/SyntaxDevTeam/CleanerX/blob/main/src/main/resources/config.yml)
- ✅ 通过 `messages_xx.yml` 文件提供多语言支持
## ⚙️ 技术信息
- 🟢 **专为最新的 Minecraft 版本 1.20.6–1.21.4+ 设计**
- 🟢 **针对 Paper 及其分支（Pufferfish, Purpur, Leaves）进行了优化**
- 🟢 **需要 Java 21 或更高版本**
- 🟢 **使用 Kotlin 编写——Java 的一种现代、富有表现力且更安全的替代方案**
如果您有任何问题，您可能在我们的 [Discord](https://discord.gg/Q343kjA2YP) 上找到答案。
## 🛠️ 命令和权限
| 命令 | 权限 | 描述 |
|---------------------------------------|--------------------------|----------------------------------------------------|
| `/whitelistx ` | `cleanerx.cmd.whitelist` | 添加、删除或显示白名单中的词语 |
| `/blacklistx ` | `cleanerx.cmd.blacklist` | 添加、删除或显示黑名单中的词语 |
| `/cleanx` | `cleanerx.cmd.clean` | 清除游戏内的聊天 |
| `/cleanerx help` 或 `/crx help` | `cleanerx.cmd.crx` | 显示可用的命令列表 |
| `/cleanerx reload` 或 `/crx reload` | `cleanerx.cmd.crx` | 重新加载配置文件。 |
| `/cleanerx version` 或 `/crx version` | `cleanerx.cmd.crx` | 显示插件信息 |
## 📥 下载
- **最新的稳定版本可在 Hangar 上获取：** [](https://hangar.papermc.io/SyntaxDevTeam/CleanerX)
- **您也可以从以下位置构建最新的开发版本：** [](https://github.com/SyntaxDevTeam/CleanerX)
## 🚀 安装
1. 从发布部分下载插件的最新版本。
2. 将 JAR 文件放入服务器的 `plugins` 文件夹中。
3. 启动您的 Minecraft 服务器。
4. **配置：**
打开 `config.yml` 文件以自定义设置，例如禁止词语列表或完全审查模式。
## 📞 联系
如果您有任何问题或需要支持，请随时在我们的 [Discord](https://discord.gg/Q343kjA2YP) 上联系我们，或向我们发送直接消息。
## 📜 许可
此插件采用 **MIT 许可** 提供。 您可以在 LICENSE 文件中找到详细信息。
---
**感谢您使用 CleanerX！ 希望它能满足您的期望。 😊**
---