# 🛡️ AdminAbuseDetector
**让您的服务器安全透明，通过实时管理命令监控！**
AdminAbuseDetector 是一款功能强大的 Bukkit/Spigot 插件，旨在帮助服务器所有者实时监控可疑命令使用情况，从而维护透明度和检测潜在的管理滥用。
## 🚀 主要功能
### 📊 **全面的命令监控**
- 监控关键管理命令：`give`、`effect`、`summon`、`xp`、`gamemode`、`tp`、`teleport`、`kill`、`clear`、`enchant`、`setblock`、`fill`、`weather`、`time`、`difficulty`
- 跟踪来自 **玩家** 和 **控制台** 的命令
- 实时检测，零性能影响
### 🔔 **多渠道通知**
- **Discord 集成**: 将精美的嵌入式通知直接发送到您的 Discord 服务器
- **游戏内警报**: 立即向在线工作人员发送通知
- **控制台日志**: 带有时间戳和命令详情的详细服务器日志
### ⚡ **高级 Discord 功能**
- 丰富的嵌入式消息，带有颜色编码的警报
- 详细信息包括发送者、命令、时间戳和服务器名称
- 异步 webhook 发送以防止服务器卡顿
- 使用表情符号和结构化字段进行专业格式化
### 🔧 **易于配置**
- 简单的 `config.yml` 设置
- 只需添加您的 Discord webhook URL 即可开始使用
- 不需要复杂的权限或设置
## 📋 工作原理
1. **检测**: 插件实时监控所有命令执行
2. **分析**: 检查命令是否匹配监控列表
3. **通知**: 通过多种渠道立即发送警报：
- 带有详细嵌入的 Discord webhook
- 具有 `adminabuse.notify` 权限的工作人员的游戏内消息
- 服务器控制台日志条目
## 🛠️ 安装与设置
1. 下载插件并将其放置在您的 `plugins` 文件夹中
2. 启动/重启您的服务器
3. 编辑 `plugins/AdminAbuseDetector/config.yml`
4. 添加您的 Discord webhook URL：
```yaml
discord:
webhook-url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"
```
5. 重新加载或重启您的服务器
## 🎯 适用对象
- 希望监控工作人员活动的 **服务器所有者**
- 管理多个服务器的 **网络管理员**
- 维护透明度的 **社区服务器**
- 预防不公平优势的 **竞技服务器**
- 优先考虑公平性和责任制的 **任何服务器**
## 📊 监控内容
该插件跟踪以下可能改变游戏规则的命令的使用情况：
- **物品命令**: `give`、`clear`
- **玩家效果**: `effect`、`gamemode`
- **世界操作**: `setblock`、`fill`、`weather`、`time`、`difficulty`
- **实体命令**: `summon`、`kill`
- **玩家命令**: `tp`、`teleport`、`xp`
## 🔒 安全与隐私
- **透明操作**: 没有隐藏功能或后门
- **开源心态**: 干净、可审计的代码
- **基于权限**: 只有工作人员才能收到通知
- **非侵入性**: 不会干扰正常的服务器操作
## 📸 Discord 通知示例
当检测到监控命令时，您将收到带有以下内容的专业 Discord 通知：
- 🚨 **警报标题**: "检测到作弊命令！"
- 👤 **发送者信息**: 玩家姓名和类型（玩家/控制台）
- ⚡ **命令详情**: 执行的确切命令
- 🕐 **时间戳**: 执行命令的时间
- 🖥️ **服务器名称**: 命令使用的服务器
## 🎮 兼容性
- **Bukkit**: ✅ 完全兼容
- **Spigot**: ✅ 完全兼容
- **Paper**: ✅ 完全兼容
- **Minecraft 版本**: 1.8+ (测试到最新版本)
## 🆘 支持
需要帮助？ 有建议？ 发现 bug 了？
- 检查插件文档
- 审查配置示例
- 通过项目页面报告问题
## 📝 权限
- `adminabuse.notify` - 接收命令检测到的游戏内通知 (默认：OP)
---
**⭐ 如果此插件有助于保持服务器的公平性和透明度，请考虑留下评论！**
*AdminAbuseDetector - 因为透明构建信任。*