# AnvilWatch
**AnvilWatch** 是一个轻量级的 Minecraft 审核插件,它监控并控制通过铁砧进行的物品重命名。专为服务器管理员设计,它确保所有重命名操作都被记录,并根据可配置的禁用词列表自动阻止不当名称。
## 功能
- 将所有通过铁砧完成的物品重命名记录到日志文件中
- 阻止包含禁用词(不区分大小写)的物品名称
- 当发生重命名时,向所有在线管理员发送警报(具有正确的权限)
- 支持基于权限的可信任用户的绕过
- 提供一组管理员命令来管理禁用词和插件行为
- 在不重启服务器的情况下实时重新加载禁用词列表
## 为什么使用 AnvilWatch?
玩家使用冒犯性、不当或具有破坏性的名称重命名物品是 Minecraft 服务器上常见的问题。AnvilWatch 提供了一种简单有效的方法:
- 使用可定制的词语过滤器自动防止这些重命名
- 保持所有重命名事件的详细日志,用于审核和问责
- 实时通知工作人员重命名尝试发生
- 使用命令在游戏中轻松管理过滤器和设置
## 命令
| 命令 | 描述 |
|--------|-------------|
| `/anvilwatch help` | 显示可用命令的列表 |
| `/anvilwatch reload` | 从 `BannedWords.txt` 重新加载禁用词列表 |
| `/anvilwatch add ` | 将一个词添加到禁用词列表中 |
| `/anvilwatch remove ` | 从禁用词列表中删除一个词 |
| `/anvilwatch log ` | 切换用户的游戏内重命名日志消息 |
**别名:** `/anw`
**用法:** `/anvilwatch `
## 权限
| 权限 | 描述 | 默认值 |
|------------|-------------|---------|
| `anvilwatch.admin` | 接收重命名警报并使用插件管理命令 | `op` |
| `anvilwatch.bypass` | 允许在没有词语过滤器限制的情况下重命名物品 | `false` |
## 配置
- **禁用词列表:** 在插件文件夹中的 `BannedWords.txt` 文件中管理。
- **日志文件:** 重命名事件写入插件目录中的日志文件。
- **无需服务器重启:** 游戏中对禁用词列表的更改会立即更新。通过配置文件添加的禁用词可以使用 `/anvilwatch reload` 应用。
## 兼容性
- **Minecraft 版本:** 1.21.*
- **API 版本:** 1.21
- **依赖:** 无
## 快速开始
1. 将插件 JAR 文件放入服务器的 `plugins/` 文件夹中。
2. 启动您的服务器以生成配置和 `BannedWords.txt`。
3. 无论是手动在文件或游戏中添加禁用词使用 `/anvilwatch add `。
4. 将 `anvilwatch.admin` 权限分配给值得信赖的工作人员。
5. 监控日志文件和游戏内警报,当玩家重命名物品时。