BetterReplay
BetterReplay 是一款面向 Paper 的服务端回放插件,通过 FoliaLib 实现与 Folia 兼容的任务调度。 它在服务端记录玩家及附近实体的活动,保存时间线,并让观看者在游戏内回放这些内容,无需客户端安装任何回放模组。
项目简介
- 使用 Java 21 编写服务端的插件
- 针对现代 Paper API 进行适配
- 使用 PacketEvents 进行数据包拦截和回放实体更新
- 使用 FoliaLib 处理调度和传送兼容性
- 支持文件存储和 MySQL 存储后端
- 使用短生命周期的回放列表缓存来优化已保存回放的命令和 API 调用
- 新存档采用定型的二进制
.br归档格式,载荷经过 Zstd 压缩;在迁移期间,旧版 JSON 回放和较旧的 LZ4.br归档仍可读取,但故意不支持v2之前的 alpha 版本.br库存归档
与服务端回放模组的区别
BetterReplay 不是一个客户端录制模组。
服务端方案(本项目):
- 完全在服务端运行
- 玩家客户端无需安装回放模组
- 捕获服务器观测到的游戏状态和事件
- 通过生成和更新回放实体为观看者播放
- 适合审核、事件回顾和服务端工具链工作流
典型的客户端回放模组方案:
- 从特定客户端视角进行录制
- 通常需要修改后的客户端环境
- 通常侧重于自由摄像机或电影剪辑编辑
- 回放通常在录制客户端本地进行
简而言之:BetterReplay 专注于由服务端管理的回放工作流和基于 API 的集成。
功能特性
- 服务端录制和游戏内回放,无需客户端回放模组
- 将定型的二进制
.br回放归档存储在文件后端或 MySQL 后端中 - 崩溃/重启安全的追加日志录制,并在启动时恢复孤立的临时存档
- 回放保护、保留清理、基于区块过滤的导出以及隐藏的管理员诊断功能
- 可选的基于区块的录制和回放,以记录玩家周围的方块基准线
- 回放控制功能,包括暂停步进、可变速度以及实时速度反馈
- 观看者安全控制、观看者状态还原,以及在回放期间可选地隐身在线玩家
- Velocity 回放交接功能,允许在专用后端服务器上启动回放,并在结束后将观看者返回原服
- 利用 ViaVersion 代理获取客户端版本详情,以便在后端服务器上正确显示回放玩家的皮肤元数据
- 优先支持其他插件的 API 集成
- 可选支持 Floodgate 软依赖
Velocity 回放交接
BetterReplay 可以通过 /replay play <name> server:<backend> 或配置的 Velocity.Default-Replay-Server 将观看者转移到另一个 Velocity 后端进行回放,然后在回放结束时将他们送回原始服务器。
这使得网络可以在专用回放服务器上隔离回放观看,同时生产服务器继续录制。建议共享 MySQL 存储,以便源服务器和回放后端都能访问相同的已保存回放列表和数据载荷。如果交接失败或未确认,系统会向观看者发送聊天错误提示。
Velocity 插件下载:
ViaVersion 代理详情
当 ViaVersion 代理发送 vv:proxy_details 时,BetterReplay 会使用其报告的客户端协议版本作为回放玩家的皮肤元数据,而不是使用后端的本地协议检测。这解决了后端 ViaVersion 仅看到代理连接协议而非玩家实际客户端版本的网络场景。代理必须运行 ViaVersion 5.7.2 或更高版本,并启用 send-player-details: true;若缺少或无效的数据包,则回退到 PacketEvents 检测。
BetterReplay
BetterReplay is a server-side replay plugin for Paper with Folia-friendly scheduling through FoliaLib. It records player and nearby entity activity on the server, stores that timeline, and replays it in-game for viewers without requiring a client replay mod.
What this project is
- Server plugin written in Java 21
- Targets modern Paper APIs
- Uses PacketEvents for packet interception and replay entity updates
- Uses FoliaLib for scheduler and teleport compatibility
- Supports file and MySQL storage backends
- Uses a short-lived replay-list cache for saved replay commands and API listing calls
- New saves use finalized binary
.brarchives with Zstd-compressed payloads; legacy JSON replays and older LZ4.brarchives remain readable during the migration window, but pre-v2alpha.brinventory archives are intentionally unsupported
How this differs from client-side replay mods
BetterReplay is not a client recording mod.
Server-side approach (this project):
- Runs entirely on the server
- No replay mod required on player clients
- Captures server-observed gameplay state and events
- Plays back by spawning and updating replay entities for a viewer
- Fits moderation, event review, and server-side tooling workflows
Typical client-side replay mod approach:
- Records from a specific client perspective
- Usually requires modded client setup
- Often focuses on free-camera or cinematic editing
- Playback is usually local to the recording client
In short: BetterReplay focuses on server-managed replay workflows and API-driven integration.
Features
- Server-side recording and in-game playback with no client replay mod required
- Finalized binary
.brreplay archives stored in either file or MySQL backends - Crash/restart-safe append-log recording with startup recovery of orphaned temporary saves
- Replay protection, retention cleanup, chunk-aware filtered export, and hidden admin diagnostics
- Optional chunk-aware recording and playback for block baselines around recorded players
- Playback controls with pause stepping, variable speed, and live speed feedback
- Viewer safety controls, viewer state restoration, and optional live-player vanish during playback
- Velocity replay handoff for launching playback on a dedicated backend server and returning viewers afterward
- ViaVersion proxy client-version details for correct replay player skin metadata on backend servers
- API-first integration support for other plugins
- Optional Floodgate soft dependency support
Velocity replay handoff
BetterReplay can move viewers to another Velocity backend for playback with /replay play <name> server:<backend> or a configured Velocity.Default-Replay-Server, then return them to their original server when the replay ends.
This lets a network keep replay viewing isolated on dedicated replay servers while production servers continue recording. Shared MySQL storage is recommended so the origin and replay backend can access the same saved replay list and payloads. Failed or unacknowledged handoffs report a chat error to the viewer.
Velocity plugin download:
ViaVersion proxy details
When a ViaVersion proxy sends vv:proxy_details, BetterReplay uses its reported client protocol version for replay player skin metadata instead of the backend's local protocol detection. This handles networks where backend ViaVersion sees the proxy connection protocol rather than the player's actual client version. The proxy must run ViaVersion 5.7.2 or newer with send-player-details: true; absent or invalid payloads fall back to PacketEvents detection.
下载 BetterReplay
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BetterReplay
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BetterReplay
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BetterReplay
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BetterReplay
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BetterReplay
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BetterReplay
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BetterReplay
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BetterReplay
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 BetterReplay
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
[1.5.1]
修复 Folia 兼容性问题
安全
- 2026-08-29: Replay 加载现在对文件、MySQL、ZIP、LZ4、Zstd、GZIP、时间线索引和区块载荷的分配进行了限制;验证声明的大小和编解码器元数据;并在这些结构耗尽服务器内存之前拒绝格式错误的归档结构
- 2026-08-30: 将已弃用的
org.lz4:lz4-java依赖项替换为正在维护的at.yawk.lz4:lz4-java分支,同时保留传统的 LZ4 replay 解码功能 (#97)
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧