GlobalReplay

插件

· 作者 bentianjia

带隔离只读回放世界的连续纸式重放记录器

0 本站下载 0 关注 更新于 5 个月前

最新 0.1.0 · 1.21.11 · Paper

一键开服(送7天)

推荐配套插件

为了获得最佳的重放 NPC 体验,建议安装 GlobalReplay 并与 PacketEvents 配合使用。PacketEvents 支持客户端假人重放 NPC 的 UUID/名称/皮肤还原。如果没有 PacketEvents,GlobalReplay 仍可运行,但重放 NPC 将使用盔甲架作为备用标记。

GlobalReplay

GlobalReplay

简介

GlobalReplay 是一款基于 Paper API 的 Minecraft 服务器插件,它在后台静默记录真实玩家的活动,并允许管理员在隔离的平行世界中重放历史时刻。

  • 插件名称:GlobalReplay
  • 作者:bentianjia
  • 命令前缀:/replay
  • Java 版本:Java 21
  • 目标服务端:Paper 1.20-1.21.11
  • 所需时间格式:yyyy-MM-dd_HH:mm

示例时间相关命令:

/replay enter overworld 2024-01-15_23:00
/replay goto 2024-01-15_23:47

功能特性

持续后台录制

GlobalReplay 会自动记录所有真实玩家,无需管理员手动启动录制会话。

  • 玩家位置与朝向(采用动态采样):
    • 空闲状态玩家:每 10 秒记录一帧
    • 移动中玩家:每秒记录一帧
    • 战斗中的玩家:每个游戏刻(tick)记录一帧
  • 方块变化,包括破坏、放置和爆炸
  • 玩家交互行为,包括左键攻击挥动、右键交互、进食、拾取/丢弃物品、快捷栏切换、背包点击以及容器打开/关闭操作
  • 容器与背包的变化,在变化发生时以物品快照形式存储
  • 玩家死亡与重生事件
  • 维度转移事件,包含来源维度、目标维度以及转移前后的位置信息
  • 玩家加入与退出服务器事件
  • 服务器启动与停止时间戳,用于在回放中作为离线断点

自动消息语言

面向玩家的消息会尽可能使用其 Minecraft 客户端的语言。

支持的语言:

  • 阿拉伯语
  • 中文
  • 英语
  • 法语
  • 俄语
  • 西班牙语

其他客户端语言将回退至英语。控制台消息统一使用英语。

LZ4 存储与自动清理

回放数据按世界或维度拆分,随后以每小时一个 .replay.lz4 分片的形式存储:

plugins/GlobalReplay/recordings/
  主世界/
    2024-01-15_22.replay.lz4
    2024-01-15_23.replay.lz4
  下界/
  末地/
  <自定义世界名称>/
  • 回放数据首先写入内存缓冲区。
  • 缓冲的数据每间隔可配置的时间,会以 LZ4 算法进行批量压缩并刷入磁盘。
  • 在服务器关闭期间,剩余的缓冲数据会被强制刷盘。
  • 旧的回放文件由可配置的自动清理策略进行管理。
  • 每个 .replay.lz4 分片覆盖一小时(60 分钟)的回放数据。
  • 当打开回放时,可能会在 plugins/GlobalReplay/temp/ 目录下写入解压缩后的缓存文件。
  • 原始的 .replay.lz4 录制文件会保留;仅在退出回放后五分钟未再使用时,才会删除临时的解压缩缓存。

智能假人与 NPC 排除

GlobalReplay 旨在仅记录真实玩家。它在启动时扫描已加载的插件,并自动启用支持的排除模块。

被排除的实体和账户包括:

  • 通过 NPC 元数据检测到的 Citizens2 NPC
  • 通过 Shopkeepers API 标记检测到的 Shopkeepers 实体
  • 通过 MythicMobs 实体标签检测到的 MythicMobs 实体
  • 通过特殊实体名前缀检测到的 Carpet 假人
  • 通过插件元数据检测到的 NPCLib 实体
  • 拥有 globalreplay.exempt 权限的账户
  • 标记为 globalreplay_npc=true 的回放 NPC
  • 来自 recording.excluded-entity-names 的手动排除项
  • 来自 recording.excluded-entity-uuids 的手动排除项

新生成的实体会通过 EntitySpawnEvent 进行检查,因此运行时生成的 NPC 和假实体也会被跳过。

隔离的平行世界

管理员可以进入回放会话,而不会影响实时服务器世界。

  • 每位管理员都会获得一个单独的临时平行世界实例。
  • 多名管理员可以同时回放相同的录制文件,且各自拥有独立的时间线。
  • 解压缩和回放加载是异步进行的。
  • 玩家传送和游戏状态更改会在主服务器线程上执行。
  • 管理员进入平行世界时,其坐标和旋转角度与在原世界中一致,而不是被传送到世界出生点。
  • 管理员的原始位置、游戏模式和物品栏会在进入时保存,并在退出时恢复。
  • 进入回放世界后,播放将自动开始。

只读回放保护

平行世界在设计上是只读的。

  • BlockBreakEvent 会被取消。
  • BlockPlaceEvent 会被取消。
  • InventoryClickEvent 会被取消。
  • InventoryDragEvent 会被取消。
  • EntityDamageEvent 会被取消。
  • 其他改变世界的行为均被阻止。
  • 容器可以被打开以供检查,但其内容无法被修改。

基于 NPC 的播放

GlobalReplay 将已记录的玩家还原为回放 NPC。

  • 安装 PacketEvents 后,可用于创建跨版本的假人实体。
  • 保留玩家 UUID。
  • 按 UUID 请求 Mojang 皮肤纹理并注入回放 NPC。
  • 恢复显示名称,包括 LuckPerms 前缀、颜色及格式。
  • 回放 NPC 在运行时使用独立的客户端实体 UUID,同时保持记录玩家的真实可见名称,因此实时玩家与其回放 NPC 可同时存在。
  • 回放 NPC 根据记录的坐标和旋转角度逐帧移动。
  • 回放 NPC 模拟记录的移动、相机旋转、左键点击、右键点击、进食、拾取/丢弃物品、手持物品变化、背包点击以及容器开合操作。
  • 回放 NPC 带有 globalreplay_npc=true 标签,以便录制器忽略它们。
  • 可使用旁观者模式进入 NPC 身体,以该玩家的第一人称视角进行观看。

离线断点

如果在回放时间线期间服务器处于离线状态,GlobalReplay 会显示灰色断点,并向管理员发送如下通知:

[GlobalReplay] Server was offline for X minutes

安装

  1. 安装 Java 21。
  2. 运行兼容 1.20-1.21.11 的 Paper 服务器。
  3. 将 PacketEvents 安装到服务器 plugins 文件夹中,以实现带有皮肤的完整假人回放 NPC。若未安装 PacketEvents,GlobalReplay 仍可启动并使用盔甲架作为备用标记。
  4. 将 GlobalReplay 插件 jar 文件安装到服务器 plugins 文件夹中。
  5. 确保服务器能够下载插件库,因为 GlobalReplay 通过 plugin.yml 声明了 org.lz4:lz4-java。
  6. 首次启动服务器以生成 plugins/GlobalReplay/config.yml。
  7. 检查配置,然后重启服务器或运行 /replay reload。

命令

所有命令的时间参数必须使用 yyyy-MM-dd_HH:mm 格式。

命令 描述
/replay enter <dimension> <time> [player|uuid|me] 在当前坐标进入隔离的平行世界,并从指定时间开始回放。如果提供了目标,当回放 NPC 出现时立即传送到该记录玩家附近。使用 me/self/@s 或 UUID 以避免名称冲突。示例:/replay enter overworld 2024-01-15_23:00 me。
/replay pause 暂停或恢复当前回放会话。
/replay speed <0.5/1/2/4> 更改播放速度。
/replay goto <time> 跳转到当前回放中的特定完整时间戳。示例:/replay goto 2024-01-15_23:47。
/replay focus <player|uuid|me> 通过传送到回放 NPC 附近来跟随记录的玩家。命令目标是回放 NPC,因此即使实时玩家在线,/replay focus bentianjia 也会传送到回放 NPC;如有需要,请使用 me/self/@s 或 UUID。
/replay exit 离开平行世界,销毁临时实例,并将管理员恢复到之前的状态。
/replay list [dimension] 列出可用的回放文件,可按维度筛选。
/replay reload 重新加载 config.yml,扫描假人排除项,并保持正在进行的录制和当前回放会话继续运行。

需要执行耗时操作的命令会先发送即时进度反馈,然后在异步任务完成后发送最终结果。

回放进入进度消息:

[GlobalReplay] Decompressing replay files, please wait...
[GlobalReplay] Decompression complete, loading parallel world...
[GlobalReplay] Entered parallel world <time>, <X> players loaded

配置重载结果:

[GlobalReplay] Configuration reloaded

权限

权限 描述
globalreplay.enter 允许进入回放世界并使用回放会话控制。
globalreplay.enter.others 在强制执行基于玩家范围的访问时,允许查看其他玩家的回放数据。
globalreplay.admin 授予所有 GlobalReplay 管理权限。
globalreplay.exempt 防止该账号被录制。适用于假人或自动化账号。

GlobalReplay 兼容 LuckPerms 权限检查。

配置

默认 config.yml 结构:

storage:
  flush-interval-seconds: 30
  compression: lz4

auto-delete:
  enabled: true
  keep-full-quality-hours: 24
  keep-low-quality-days: 7
  delete-after-days: 30

recording:
  excluded-entity-names:
    - "shopkeeper"
  excluded-entity-uuids: []

prefix: "&8[&bGlobalReplay&8]&r "

配置参考:

键 描述
storage.flush-interval-seconds 缓冲录制数据压缩并刷盘到磁盘的频率。
storage.compression 回放文件的压缩算法。目前仅支持 lz4。
auto-delete.enabled 启用或禁用自动录制清理。
auto-delete.keep-full-quality-hours 在最近几小时内保持全质量录制。
auto-delete.keep-low-quality-days 在接下来几天内保留低质量录制。
auto-delete.delete-after-days 删除超过此天数的录制。
recording.excluded-entity-names 手动排除的实体名称。匹配的实体不会被录制。
recording.excluded-entity-uuids 手动排除的实体 UUID。匹配的实体不会被录制。
prefix 聊天消息前缀。支持与 Minecraft 颜色代码一起使用的 &。

运行 /replay reload 会重新加载所有配置值,扫描假人排除模块,不会中断正在进行的录制,也不会影响已经进入回放世界内的管理员。

作者

GlobalReplay 由 bentianjia 开发。

许可证

GlobalReplay 采用 MIT 许可证授权。只要保留标识 bentianjia 为作者的版权声明,您即可使用、修改和分发本软件。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源