SEARCH Anticheat 1.8 - 1.13 - SEARCH Anticheat 反作弊插件

SEARCH 是一款为 NoCheatPlus 设计的增强插件。它不仅优化了原有的检测机制，还引入了大量新模块与功能，例如封禁波次和高级违规记录，旨在减少误判，为玩家提供更流畅、更完善的游戏体验。

💡核心特性

• 违规记录：SEARCH 可将所有违规记录存储至 MySQL 数据库。此功能允许您随时查询玩家的历史数据，并可在封禁或踢出理由中引用对应的日志 ID。
• 封禁波次：启用后，SEARCH 会将检测到的作弊者暂存于封禁波次中，默认每30分钟统一执行封禁。这增加了作弊者判断被封禁原因的难度。
• 高度可配置：几乎所有设置都可通过配置文件调整，包括通用设置（封禁波次、消息等）及各模块的特定设置。每个模块均可单独禁用，所有操作和命令均可自定义。
• 自动化检测与处罚：配置完成后，SEARCH 可自动检测并阻止作弊行为，并在玩家违规次数达到设定值时自动踢出或封禁玩家。
• 轻量高效：SEARCH 虽功能丰富，但体积小巧。它占用 CPU 资源少，且所有数据库连接均为异步操作。
• BungeeCord 支持：SEARCH 支持与 BungeeCord 联动。它可以跨服同步玩家的违规数据，使所有子服数据保持一致，还能将通知发送至 BungeeCord 或在 BungeeCord 上执行命令。使用此功能需将插件也放入 BungeeCord 服务器的插件目录。
• 录像回放：SEARCH 可在玩家被怀疑作弊时自动创建录像，供后续查看。

✨支持的版本与前置需求

兼容版本

• Spigot 1.8.8, 1.9.4, 1.10, 1.11, 1.12, 1.13

必需前置插件

• ProtocolLib
• NoCheatPlus

可选前置插件（用于录像功能）

• AdvancedReplay

🔧可阻止的作弊类型

SEARCH 在 NoCheatPlus 的基础上，增强了以下作弊行为的检测与阻止能力：

• 数据包滥用（如 Morepackets、Blink 等）
• 水上行走
• 滑翔
• 大多数速度/远跳类型
• 攻击距离延伸
• 杀戮光环或类似功能
• 库存内操作（如打开背包时攻击）
• 多重动作（如 CivBreak、同时进食与攻击等）
• 自动点击器
• 无效的载具移动（如 BoatFly）
• 某些类型的 Ping 欺骗

其他功能

• 可禁用伤害显示、LabyMod 和 WorldDownloader。
• 移除具有无效 NBT 数据、附魔或药水效果的物品。

如果您发现任何可绕过检测的情况，请向开发者报告。

🎮配置指南

几乎所有设置都可在 config.yml 中配置。如需启用违规记录，您还需要设置 mysql.yml。若要禁用某个通知或消息，只需将其留空即可。

主要配置项概览

general 部分

• cancel_points: 当服务器或玩家延迟（TPS 和 Ping）较高时，用于取消检查的阈值点。值越高表示延迟越严重。建议范围在 10 到 90 之间。
• log_violations: 是否将违规记录到 MySQL 数据库。
• kick_message: 玩家被踢出时显示的消息。可使用 {id} 占位符（仅当 log_violations 启用时有效）。
• ban_command: 封禁玩家时执行的命令。可通过 API 覆盖。
• create_replay: 是否自动创建录像（需要 AdvancedReplay）。

ban_wave 部分

• enabled: 是否启用封禁波次。
• interval: 封禁波次之间的间隔时间（分钟）。
• broadcast: 执行封禁波次时是否向所有玩家广播消息。

bungee 部分

• enabled: 是否连接到 BungeeCord 服务器。
• bungee_host: BungeeCord 服务器 IP。
• bungee_port: BungeeCord 套接字服务器端口（非主端口）。
• key: 必须与 BungeeCord 端 config.txt 中的密钥匹配。
• synchronize_data: 是否同步违规数据。

modules 部分

每个模块都包含以下基本设置

• enabled: 是否启用该模块。
• strikes: 触发模块标记所需的违规次数。
• action: 达到违规次数后执行的操作。可选：none（无）、kick（踢出）、reset（重置计数）、reset_kick（重置并踢出）、ban（封禁）。也可使用 custom_actions.yml 中定义的自定义操作。
• message: 触发时发送的通知消息。

部分模块（如 BadPackets、Killaura 等）还有额外的 settings 子项，用于微调检测参数。

可用占位符

在消息中可以使用以下占位符

• {tps} - 服务器 TPS
• {version} - 插件版本
• {name} - 玩家名称
• {ping} - 玩家延迟
• {vl} - 玩家违规等级
• {strikes} - 玩家累计违规次数
• {module} - 模块名称
• {type} - 根据模块而定的类型
• {kills} - （杀戮光环模块）击杀数
• {max_kills} - （杀戮光环模块）最大击杀阈值
• {leftclicks} - （自动点击器模块）左键点击次数/秒
• {rightclicks} - （自动点击器模块）右键点击次数/秒
• {id} - 违规日志的 ID

🔧命令与权限

命令列表

• /search - 显示所有命令概览
• /search info [玩家名] [-all] - 查看玩家或服务器信息
• /search reset <玩家名> [模块名] - 重置玩家的所有或指定模块记录
• /search modules - 显示所有模块
• /search toggle <模块名> - 启用/禁用指定模块
• /search notify - 切换是否接收通知
• /search reload - 重载所有配置
• /search check <日志ID> - 检查指定日志 ID 的详情
• /search bw <List|Run|Remove> - 管理封禁波次（列表/立即执行/移除）
• /search report [玩家名] - 创建用于错误报告的日志文件
• /search watch <录像ID> - 观看已录制的回放

权限节点

• search.command.<命令> - 使用特定命令的权限（例如 search.command.reload）
• search.bypass.<模块> - 绕过指定模块检查的权限
• search.notify - 接收违规通知的权限

⭐API 开发者接口

所有 API 方法均可通过 SEARCHAPI 类访问。

注册操作处理器 (IActionHandler)

您可以自定义玩家被踢出或封禁时的行为。

SEARCHAPI.registerActionHandler(new IActionHandler() {
    @Override
    public void onKick(PlayerData pd, ViolationLog log) {
        Player player = pd.getPlayer();
        // 当玩家应被踢出时调用
    }
    @Override
    public void onBan(PlayerData pd, ViolationLog log) {
        Player player = pd.getPlayer();
        // 当玩家应被封禁时调用
    }
});

注册玩家处理器 (IPlayerHandler)

您可以自定义哪些玩家可以绕过特定检查。

SEARCHAPI.registerPlayerHandler(new IPlayerHandler() {
    @Override
    public boolean canBypass(PlayerData pd, ModuleType type) {
        Player player = pd.getPlayer();
        // 如果该玩家应绕过此检查，则返回 true
        return false;
    }
});

❓链接与依赖

• ProtocolLib: https://www.spigotmc.org/resources/protocollib.1997/
• NoCheatPlus: https://ci.md-5.net/job/NoCheatPlus/
• AdvancedReplay (可选): https://www.spigotmc.org/resources/advancedreplay-1-9-1-12.52849/