[MC插件] ClientDetectorPlus | 26.x.x Support | v1.0.6 – 评分 4.2/5.0

插件详细介绍

🚀 插件简介

ClientDetectorPlus（版本 1.0.6）是一款专为 Minecraft 服务器设计的客户端检测与管理插件，由作者 Loving11ish 开发。在 SpigotMC 上获得了 4.2/5.0 的评分，累计下载量已超过 27,301 次。该插件通过检测玩家客户端发送的特定数据包，帮助服务器管理员识别并管控不合规的客户端或模组，从而维护游戏公平性。

🛠️ 核心功能

• 客户端检测 👁️ – 自动识别玩家使用的客户端类型，并对被禁止的客户端执行预设惩罚。
• 客户端/模组控制 🔧 – 针对受支持的客户端或模组，你可以精细管理玩家能否使用它们。
• 高级警报系统 🚨 – 灵活配置通知方式，让管理组成员第一时间获知可疑客户端行为。
• ViaVersion 兼容 🌐 – 完美配合 ViaVersion 插件，支持不同版本客户端无缝接入。
• Geyser 支持 📱 – 如果你的服务器允许基岩版玩家加入，也能对它们进行检测。

⚙️ 工作原理

当玩家加入服务器时，其客户端会向服务器发送一个 PlayInCustomPayload 数据包（即插件消息）。ClientDetectorPlus 通过 PacketEvents API（GitHub 仓库）拦截该数据包，并解析其中包含的客户端标识信息。大多数客户端（包括第三方启动器）都会在此时暴露自己的身份。但某些“伪装”客户端可能伪造数据包以冒充原版客户端，这种欺骗手段无法完全阻止——不过插件仍能检测出大部分异常。

📖 命令一览

所有命令均以 /cdp 为前缀，方便管理：

• /cdp list <java|bedrock> – 打开 GUI 界面，显示所有在线 Java 版或基岩版客户端信息。
• /cdp lookup <玩家> – 查看指定在线玩家的客户端详细数据。
• /cdp lockdown <enabled|disabled> – 启用或禁用服务器锁定模式（阻止所有未通过检测的玩家进入）。
• /cdp tempwhitelist <add|remove> <玩家> – 临时添加或移除玩家至检测白名单（插件重载后恢复为配置文件中的默认设置）。
• /cdp reload – 热重载所有配置文件，无需重启服务器。

🔐 权限节点

通过权限系统，你可以让不同身份的管理员拥有不同的操作范围：

• clientdetectorplus.* – 拥有全部功能（包含管理功能），默认授予 OP。
• clientdetectorplus.update – 接收插件更新通知。
• clientdetectorplus.notify.* – 接收客户端检测警报。
• 其他子权限可细化到特定命令（如 clientdetectorplus.command.list 等）。

📦 配置与依赖

⚠️ 重要提示： ClientDetectorPlus 依赖 PacketEvents 插件才能运行，请确保在安装前已将 PacketEvents 放入 plugins 文件夹。插件配置基于 YAML 格式，支持热重载。此外，若你同时使用 ViaVersion，无需额外配置即可正常检测不同版本客户端；对于 Geyser（基岩版接入），插件也可自动识别基岩版玩家。

💡 使用场景

适合需要严格客户端规范的服务器，例如：

• 纯净生存服、小游戏服、竞技型服务器等。
• 防止玩家使用作弊客户端（如 Wurst、Ares 等）进入。
• 结合锁定模式（Lockdown），在异常事件期间临时拒绝所有未经白名单的玩家。
• 配合指令和权限，让管理层快速获取玩家客户端信息并采取行动。

🔗 兼容性

• Minecraft 版本： 支持 1.8.x ~ 1.20.x（基于 PacketEvents 的兼容范围）。
• API 平台： Spigot/Paper 及衍生服务端。
• 其他插件： 已测试与 ViaVersion、Geyser 协同工作，无冲突。
• 开发版本： 作者还提供最新开发构建（Dev Build），适合愿意尝试新功能并自行承担风险的服务器管理员。