Themis Anti Cheat - Themis反作弊

💡简介

Themis 是一款专注于准确性、效率和简洁性的反作弊插件。它支持 Spigot 和 Paper 服务端，并提供了真正的基岩版/Geyser 支持，能够对基岩版玩家执行有效的检测。插件配置灵活，允许为每个检测规则自定义处罚动作。目前主要针对移动类作弊，未来将扩展检测范围。

💡重要须知

• 支持的版本：此插件仅适用于 Minecraft 1.17.0 至 1.21.10。
• 基岩版支持：如需支持基岩版玩家，必须在服务端安装 Bukkit/Spigot 版本的 Floodgate（支持 1.0 和 2.0 版本）。
• 寻求帮助：如果遇到任何问题，请加入 Discord 服务器获取支持，而不是留下差评。

✨主要特性

• 真正的基岩版支持：对基岩版玩家执行实际检测，而非简单排除，有效防止绕过。
• 高性能：设计高效，对服务器性能影响极小。
• 灵活配置：可为每个检测规则配置任意数量的处罚动作，包含自定义命令、触发阈值和延迟。
• 兼容性：支持 Spigot 和 Paper，其他服务端分支可能兼容。
• 录像支持：与插件 Anti Cheat Replay 兼容，可在玩家受罚时录制视频作为证据。

🎮可检测的作弊类型

Themis 当前主要检测以下移动类作弊（列表不完整，也可能检测到类似变种）：

• BHop Speed
• Blink
• Boat Fly
• Boat Speed
• Climb / Spider
• Elytra Fly
• Fly
• Jetpack
• KillAura（如果涉及增加攻击距离）
• NoFall
• OnGround Speed
• Reach
• Step
• Timer
• Vanilla Speed
• WaterWalk / Jesus

🔧安装与设置

请严格按照以下步骤操作

前提条件

• 确保服务器运行 Spigot 或 Paper 的 1.17.X、1.18.X、1.19.X、1.20.X 或 1.21.X 版本。
• 从本页面下载 Themis 的 .jar 文件，并将其放入服务器的 plugins 目录。（自 0.17.0 版本起，不再需要 ProtocolLib）

基岩版玩家支持（可选）

如果服务器允许基岩版玩家加入

• 安装 Floodgate（Bukkit 版本），以便 Themis 识别并适配检测基岩版玩家。
• 如果使用 BungeeCord，必须在 Bungee 端的 Floodgate 配置中设置 send-floodgate-data: true。
• 强烈建议在 Geyser 配置中启用 forward-player-ping，否则 Themis 无法测量基岩版玩家的延迟。

完成安装

• 重启服务器以加载所有更改。
• 运行 /themis 命令检查插件是否正常运行。
• （仅针对基岩版）对一个基岩版玩家执行 /themis info [玩家名]，确保 Themis 能正确将其识别为“Bedrock player”。

❓故障排除

问题：Themis 未运行

• 运行 /themis 查看状态。你需要 themis.command.info 权限（默认所有人都有，但权限插件可能禁用了它）。
• 如果命令有效但无检测：请确认测试的作弊类型在支持列表中，并检查你是否拥有 themis.bypass 权限（默认即使 OP 也没有）。可使用 LuckPerms 的 /lp user [用户名] permission check themis.bypass 检查。
• 如果命令无效：运行 /pl 查看插件列表。

- 如果 Themis **未显示**：可能 .jar 文件未放入正确目录，或放入后未重启服务器。

- 如果 Themis **显示为红色**：很可能是不支持的 Minecraft 版本。否则请检查日志文件。

问题：基岩版玩家被误封

• 运行 /themis info [玩家名] 确认 Themis 是否正确将其识别为基岩版玩家。如果没有，说明 Floodgate 设置不正确。请检查 Bungee/Velocity 的 Floodgate 配置中 send-floodgate-data 是否设为 true。

问题：基岩版玩家延迟始终为 0

• 你需要在 Geyser 配置中启用 forward-player-ping 选项。

寻求帮助时

请在 Discord 中提交问题时直接附上日志文件，这将极大加快解决问题的速度。

⭐配置文件说明

配置文件（config.yml）允许你为每个检测规则单独调整所有设置。其中包含一个 default 部分，为所有检测规则定义默认值，你可以在下方各检测规则部分进行覆盖。

主要配置项示例

default:
  enable: true # 是否启用检测
  block: true # 是否阻止作弊行为（如拉回玩家）
  block-threshold: 10.0 # 开始阻止作弊的分数阈值
  actions: # 可配置的处罚动作
    notify: # 动作名称（需唯一）
      execution-threshold: 10.0 # 触发此动作所需的最低分数
      repetition-threshold: 5.0 # 重复触发此动作所需的新违规次数
      repetition-delay: 10.0 # 重复触发此动作的时间延迟（秒）
      commands: # 要执行的命令列表（支持占位符）
        - "themis notify §5[Themis] §4%player_name% §cwas flagged for §4%detection_type% §chacks!\n§c[Score: §4%score% §c| Ping: §4%ping% §c| TPS: §4%tps%§c]"
  bedrock-only: false # 是否仅检查基岩版玩家
  max-ping: -1.0 # 检查玩家的最大延迟（-1 为始终检查）
  min-tps: -1.0 # 执行检查的最低服务器 TPS（-1 为始终检查）
  violation-expiration: 900.0 # 违规记录过期时间（秒，-1 为永不过期）

可配置的检测规则

配置文件包含以下检测规则部分，你可以像覆盖 default 部分一样为它们单独设置参数：

• boat_movement：船体移动检测
• elytra_flight：鞘翅飞行检测
• horizontal_movement：水平移动（速度）检测
• illegal_packets：非法数据包检测
• packet_spoof：伪造数据包检测
• reach：攻击距离检测
• tickrate：计时器/瞬移检测
• vertical_movement：垂直移动（飞行）检测

🎮命令列表

• /themis - 显示 Themis 运行状态及版本信息。
• /themis help - 列出所有命令及其描述。
• /themis info <玩家名> - 显示指定玩家的违规分数及其他信息。
• /themis notifications [on|off] - 切换或显示通知设置。
• /themis notify <消息> - 向拥有 themis.notify 权限的玩家发送反作弊通知（主要用于配置文件中，而非游戏内直接使用）。
• /themis reload - 重载配置文件使更改生效。

🎮权限节点

• themis.bypass - 绕过所有 Themis 检测。（默认：false）
• themis.bypass.[checkName] - 绕过特定检测，将 [checkName] 替换为检测名称（与配置文件中名称一致，例如 themis.bypass.vertical_movement）。（默认：false）
• themis.silent - 使所有 Themis 检测静默运行（即不阻止作弊行为）。（默认：false）
• themis.silent.[checkName] - 使特定检测静默运行。（默认：false）
• themis.notifications - 接收检测通知。（默认：op）
• themis.technical - 接收技术通知（例如更新或检测到的问题）。（默认：op）
• themis.command.base - 允许使用 /themis 命令。（默认：true）
• themis.command.help - 允许使用 /themis help 命令。（默认：true）
• themis.command.info - 允许使用 /themis info 命令。（默认：op）
• themis.command.notify - 允许使用 /themis notify 命令。（默认：false）
• themis.command.reload - 允许使用 /themis reload 命令。（默认：op）