AntiCheat Replay - 回放系统

💡简介

本插件可记录被反作弊系统处罚的玩家行为，并允许您在事后回放录像。即使服务器上只有作弊者一人，您也能获得其作弊的视频证据。本插件支持 Folia 服务端。

🎮支持的反作弊

• 付费版反作弊：
• Gladiator
• Vulcan
• Spartan/Vacan
• Matrix
• GodsEye
• Kauri
• Sparky
• Intave
• Verus
• Reflex
• Negativity v2
• AstroAC

• 免费版反作弊：
• Themis
• FlappyAC
• AntiCheatReloaded (最新开发版)
• LightAntiCheat
• AntiHaxerman
• Negativity v1

如需支持其他反作弊，欢迎提出请求。

✨功能特性

• 当玩家被反作弊处罚时，自动录制其游戏过程。
• 支持 Discord 集成，可在创建录像时向指定频道发送消息。
• 提供开发者 API，方便其他插件监听相关事件。

🔧前提要求

• 服务器必须安装并运行一个受支持的反作弊插件以及 BetterReplay。
• 反作弊必须配置为会对作弊者执行处罚（如封禁、踢出）。如果玩家从未被处罚，则不会生成录像。

反作弊初始设置

• Vulcan：在 Vulcan 配置文件中，将 enable-api 设置为 true。
• Soaroma：在 Soaroma 配置文件中，将 enableAPI 设置为 true。
• Sparky：在 Sparky 配置文件中，将 API.Events 设置为 true。

BetterReplay 配置建议

为了获得最佳效果，请按以下指南配置 BetterReplay：

• 启用 MySQL 存储：本插件可能会生成大量录像文件（取决于作弊者数量）。根据录像时长，这可能占用相当大的存储空间，使用数据库管理更为高效。

⭐配置说明

以下是默认配置的核心部分

Intave:
  Punish-Commands:
    - ban
    - kick
    - intave

General:
  Report-Cooldown: 3
  Always-Save-Recording: false
  Save-Recording-On-Disconnect: false
  Overwrite: false
  Check-Update: true
  Nearby-Range: 30
  Recording-Length: 2
  Notify-Staff: true

Vulcan:
  Disabled-Recordings:
    - timer
    - strafe

Themis:
  Disabled-Actions:
    - notify

Grim:
  Punish-Commands:
    - ban
    - kick

Discord:
  Enabled: true
  Red: 0
  Green: 255
  Blue: 0
  Webhook: Enter webhook here
  Avatar: https://i.imgur.com/JPG1Kwk.png
  Username: VulcanReplay
  Server-Name: Server

关键配置项说明

• Nearby-Range: 30：设置录制时捕捉附近玩家的范围。注意：实际范围是设定值的一半（例如30格，则会在X、Y、Z轴正负方向各取15格）。
• Recording-Length: 2：录像长度（分钟）。从开始录制到此刻才会生成最终录像文件。
• Disabled-Recordings (Vulcan)：列出您不希望触发录像的检测类型（必须小写）。

❓使用方法

大部分命令和权限由 BetterReplay 处理。AntiCheatReplay 主要添加了重载和举报命令。

常用命令

• /replay list：列出所有录像。
• /replay play <recording>：播放指定录像。
• /replay delete <recording>：删除指定录像。
• /replayreload：重载 AntiCheatReplay 配置（需要权限 vulcanreplay.reload）。
• /report <player>：手动举报玩家并为其创建录像（需要权限 AntiCheatReplay.report）。

权限列表

• vulcanreplay.reload：允许重载插件配置。
• AntiCheatReplay.report：允许使用 /report 命令。
• AntiCheatReplay.report-notify：接收玩家被举报的通知。
• AntiCheatReplay.recording-notify：接收新录像创建的通知。
• AntiCheatReplay.reportImmune：使持有者免疫被他人举报。

💡已知问题

• 录像中不会显示除玩家以外的任何生物或实体。您可能会看到玩家似乎被“空气”攻击而受伤，这实际上可能是怪物造成的。

🔧重要声明

本插件应作为辅助工具，与反作弊系统提供的日志结合使用。它不应作为判定玩家作弊的唯一证据。

🎮开发者 API

AntiCheatReplay 提供了多个可监听和取消的事件：

• RecordingStartEvent (录像开始事件)
• RecordingSaveEvent (录像保存事件)

这两个事件都包含以下方法

public Player getPlayer() { }
public String getReplayName() { }

• PlayerReportEvent (玩家举报事件)

包含以下方法

public Player getReporter() { }
public Player getTarget() { }
public String getReason() { }

❓支持与反馈

如需报告错误或获取支持，请加入我们的 Discord 服务器。