DSFlashback
Paper 和 Purpur 服务器的服务端回溯录像。
DSFlashback 直接从你的服务器录制游戏过程,并将其保存为回放文件,可通过 Flashback 客户端模组打开观看。
要求
必需
- Paper 或 Purpur
- ProtocolLib
- 客户端需安装 Flashback 模组以观看录像
可选
- ViaVersion 和 ViaBackwards,用于跨版本转换(26.x.x 至 1.21.x)
- Simple Voice Chat,用于语音录制与播放
- GrimAC 或 Vulcan,用于实验性反作弊证据支持
- Multiverse-Core,用于诊断信息中的额外世界数据
安装
- 在服务器上安装 ProtocolLib。
- 将 DSFlashback JAR 文件放入服务器的
plugins 文件夹中。
- 重启服务器。
为什么使用 DSFlashback?
DSFlashback 可用于管理员审查、员工复盘、玩家举报、活动录像或单纯保存重要时刻。
- 手动开始录制或自动录制所有玩家
- 捕捉移动、战斗、方块、物品、背包、死亡和世界变化
- 记录玩家、附近玩家、实体和地形
- 通过玩家操作时间线搜索重要时刻(仍处于实验阶段)
- 将已保存的回放转换为其他受支持的 Minecraft 版本
- 可选择包含 Simple Voice Chat 的音频录制
- 控制录制的世界、文件保留策略和地形渲染范围
回溯录像
DSFlashback 以标准的 Flashback 文件格式保存录像。你可以下载保存的 ZIP 文件,并在开启 flashback 模组的客户端中打开它。
保存前会对录像进行检查。如果回放中缺少或损坏了重要部分,DSFlashback 会拒绝保存该录像。
服务器管理员可以调整录制的地形半径,以平衡文件大小与回放时可见的周围地形数量。
玩家操作时间线(实验性功能)
每个新录制都可以包含一个可搜索的重要玩家操作列表。这允许工作人员无需从头观看整个回放即可快速定位事件。
操作时间线可能包含如下条目:
00:04 开始破坏方块
00:06 破坏了方块
00:09 攻击玩家
00:10 造成伤害
00:14 使用物品
00:18 切换世界
00:25 死亡
时间线显示动作发生的时间、具体行为、结果以及目标(如有)。
如何使用操作时间线
1. 查找回放
/flashback list
复制显示的录像相对路径。
2. 查看单个回放的行动
/flashback actions replay <replay-path>
示例:
/flashback actions replay IM_DIV/2026-07-15/04-43-05_to_04-43-19.zip
3. 搜索某玩家的操作
/flashback actions player <name-or-uuid>
示例:
/flashback actions player IM_DIV since=24h
4. 缩小搜索结果
| 过滤器 |
功能说明 |
示例 |
type=<glob> |
匹配操作名称。* 可匹配任意文本。 |
type=*combat* |
from=<tick-or-time> |
从回放中的某个刻或时间点开始。 |
from=200 |
to=<tick-or-time> |
在回放中的某个刻或时间点停止。 |
to=800 |
status=<result> |
显示具有特定结果的动作。 |
使用时间线中显示的结果 |
since=<duration> |
搜索该玩家最近的录像。 |
since=24h |
page=<number> |
打开下一页结果。 |
page=2 |
先从无过滤器的搜索开始。结果显示服务器存储的实际操作名称和结果,你可以将这些内容复制到更精确的搜索中。
结果每次显示十条:
/flashback actions replay IM_DIV/example.zip page=2
仅搜索名称中包含 combat 的操作:
/flashback actions player IM_DIV type=*combat* since=7d
没有操作数据的旧录像无法提供时间线。如果手动将录像复制到文件夹中,请使用以下命令重建回放列表:
/flashback index rebuild
反作弊支持(实验性功能)
DSFlashback 集成了 GrimAC 和 Vulcan 的支持。被接受的标记可以创建证据标记并自动启动聚焦录制。
重要提示: 反作弊支持已添加但尚未完全测试。它可能与某些版本的 GrimAC 或 Vulcan 不兼容。请勿依赖此功能。
回放转换
需要 VIA VERSION 才能使用此功能
已保存的录像可以转换为其他受支持的 Minecraft 版本,因为 DSFlashback 会根据服务器当前版本保存回放。如果你需要在另一个客户端版本上查看回放,则必须转换版本。
- 原始回放永远不会被修改
- 安全转换会在可能的情况下移除不支持的部分
- 严格转换在遇到无法转换的意外部分时会停止
- 转换后的录像在保存前会经过检查
版本更改转换需要兼容版本的 ViaVersion 和 ViaBackwards。
/flashback convert <replay-path> <target-version>
示例:
/flashback convert IM_DIV/example.zip 1.21.11
Simple Voice Chat 支持
当安装 Simple Voice Chat 时,DSFlashback 可以录制:
- 被录制玩家的麦克风
- 附近的、低语、群组、静态和基于位置的声音
客户端需要同时安装 Flashback 和 Simple Voice Chat 才能进行语音播放。语音录制可能会显著增加回放文件大小,并且可以在配置中禁用。
录制控制
手动录制
/flashback start player <player>
/flashback stop <player>
自动录制
/flashback autorecord on
/flashback autorecord off
/flashback autorecord status
自动录制适用于当前在线玩家及未来加入的玩家。当玩家离开时,录像会被保存。定时录制段和世界切换行为可以在配置中进行调整。
命令参考
/dsflashback 是 /flashback 的别名,因此可以使用任一命令名称。
录制与状态
| 命令 |
作用 |
示例 |
/flashback start player <player> |
开始录制单个玩家 |
/flashback start player IM_DIV |
/flashback stop <player> |
停止并保存玩家的录制 |
/flashback stop IM_DIV |
/flashback status |
显示当前活跃的录制和录制器状态 |
/flashback status |
/flashback list |
列出已保存的录制及其路径 |
/flashback list |
/flashback autorecord on |
自动录制当前在线玩家及未来加入的玩家 |
/flashback autorecord on |
/flashback autorecord off |
停止自动开始录制 |
/flashback autorecord off |
/flashback autorecord status |
显示是否启用了自动录制 |
/flashback autorecord status |
回放工具
| 命令 |
作用 |
示例 |
/flashback verify <replay> |
检查回放文件是否有效 |
/flashback verify IM_DIV/example.zip |
/flashback convert <replay> <version> |
为其他版本创建转换后的副本 |
/flashback convert IM_DIV/example.zip 1.21.11 |
/flashback actions replay <replay> |
显示单个回放中存储的操作 |
/flashback actions replay IM_DIV/example.zip |
/flashback actions player <player> |
搜索来自某个玩家的索引操作 |
/flashback actions player IM_DIV |
/flashback index rebuild |
重建可搜索的回放列表索引 |
/flashback index rebuild |
管理
| 命令 |
作用 |
/flashback doctor |
显示录制健康状况、警告及集成状态 |
/flashback privacy status |
显示哪些隐私内容选项已启用 |
/flashback reload |
重新加载插件配置 |
/flashback profile apply <full|evidence|performance> confirm |
应用预设的录制配置方案 |
默认情况下,服务器管理员可以使用这些命令,但需要相应的权限。
- 运行:
/flashback doctor
- 开始一次测试录制:
/flashback start player <player>
- 四处移动,与方块交互,并执行一些常规操作。
- 停止并保存录制:
/flashback stop <player>
- 使用兼容的 Flashback 客户端打开保存的 ZIP 文件。
- 检查其操作时间线:
/flashback actions replay <replay-path>
录制文件存储在以下目录:
plugins/DSReplay/flashback
有用的服务器控制选项
DSFlashback 包含以下选项:
- 允许和禁止的世界
- 自动录制
- 录制分段长度
- 录制保留策略
- 地形录制半径
- 磁盘空间保护
- 隐私设置
- 语音录制
- 玩家操作录制
- 针对大型服务器的性能限制
默认设置旨在在回放质量、服务器负载和文件大小之间提供实用的平衡。
DSFlashback
server-side Flashback recordings for Paper and Purpur servers.
DSFlashback records gameplay directly from your server and saves it as a replay that can be opened with the Flashback client mod.
Requirements
Required
- Paper or Purpur
- ProtocolLib
- Flashback on the client side to watch recordings
Optional
- ViaVersion and ViaBackwards for cross-version conversion(26.x.x to 1.21.x)
- Simple Voice Chat for voice recording and playback
- GrimAC or Vulcan for experimental anticheat evidence
- Multiverse-Core for additional world information in diagnostics
Installation
- Install ProtocolLib on the server.
- Place the DSFlashback JAR in the server's
plugins folder.
- Restart the server.
Why use DSFlashback?
DSFlashback can be used for moderation, staff review, player reports, event recordings or simply keeping important moments.
- Start recordings manually or record everyone automatically
- Capture movement, combat, blocks, items, inventories, deaths and world changes
- Record the player, nearby players, entities and terrain
- Search important moments through a player action timeline(still experimental)
- Convert saved replays to another supported Minecraft version
- Optionally include Simple Voice Chat audio recording
- Control recording worlds, file retention and terrain range
Flashbacks
DSFlashback saves recordings in the normal Flashback file format. You can download the saved ZIP and open it on your client with flashback mod on.
Recordings are checked before they are saved. If an important part of a replay is missing or broken, DSFlashback rejects it.
Server owners can change the recorded terrain radius to balance file size against the amount of surrounding terrain visible during playback.
Player action timeline (EXPERIMENTAL)
Every new recording can include a searchable list of important player actions. This allows staff to find an event without watching the entire replay from the beginning.
An action timeline can contain entries such as:
00:04 Started breaking a block
00:06 Broke the block
00:09 Attacked a player
00:10 Dealt damage
00:14 Used an item
00:18 Changed world
00:25 Died
The timeline shows when the action happened, what happened, its result and its target when one is available.
How to use the action timeline
1. Find the replay
/flashback list
Copy the relative path shown for the recording.
2. View actions from one replay
/flashback actions replay <replay-path>
Example:
/flashback actions replay IM_DIV/2026-07-15/04-43-05_to_04-43-19.zip
3. Search actions from a player
/flashback actions player <name-or-uuid>
Example:
/flashback actions player IM_DIV since=24h
4. Narrow the results
| Filter |
What it does |
Example |
type=<glob> |
Matches an action name. * can match any text. |
type=*combat* |
from=<tick-or-time> |
Starts at a tick or time in the replay. |
from=200 |
to=<tick-or-time> |
Stops at a tick or time in the replay. |
to=800 |
status=<result> |
Shows actions with one result. |
Use a result shown in the timeline |
since=<duration> |
Searches recent recordings for a player. |
since=24h |
page=<number> |
Opens another page of results. |
page=2 |
Start with an unfiltered search. The results show the real action names and results stored by your server, which you can copy into a narrower search.
Results are shown ten at a time:
/flashback actions replay IM_DIV/example.zip page=2
Search only actions with combat in their name:
/flashback actions player IM_DIV type=*combat* since=7d
Older recordings without action data cannot provide a timeline. If recordings were copied into the folder manually, rebuild the replay list with:
/flashback index rebuild
Anticheat support(EXPERIMENTAL)
DSFlashback includes integrations for GrimAC and Vulcan. Accepted flags can create evidence markers and start a focused recording automatically.
Important: Anticheat support has been added but has not been fully tested. It may not work correctly with every GrimAC or Vulcan version. Do not rely on it.
Replay conversion
VIA VERSION NEEDED FOR THIS FEATURE
Saved recordings can be converted to another supported Minecraft version as DSFlashback saves the flashback on version that matches the server so if you need to view the flashback on another version of a client you need to convert the version.
- The original replay is never changed
- Safe conversion removes unsupported parts when possible
- Strict conversion stops when an unexpected part cannot be converted
- Converted recordings are checked before being saved
Version-changing conversion requires compatible versions of ViaVersion and ViaBackwards.
/flashback convert <replay-path> <target-version>
Example:
/flashback convert IM_DIV/example.zip 1.21.11
Simple Voice Chat support
When Simple Voice Chat is installed, DSFlashback can record:
- The recorded player's microphone
- Nearby, whisper, group, static and location-based voice
The client needs both Flashback and Simple Voice Chat for voice playback. Voice recording can noticeably increase replay file size and can be disabled in the configuration.
Recording controls
Manual recording
/flashback start player <player>
/flashback stop <player>
Automatic recording
/flashback autorecord on
/flashback autorecord off
/flashback autorecord status
Automatic recording applies to current players and future joins. Recordings are saved when players leave. Timed recording segments and world-change behaviour can be adjusted in the configuration.
Command reference
/dsflashback is an alias for /flashback, so either command name can be used.
Recording and status
| Command |
What it does |
Example |
/flashback start player <player> |
Starts recording one player |
/flashback start player IM_DIV |
/flashback stop <player> |
Stops and saves the player's recording |
/flashback stop IM_DIV |
/flashback status |
Shows active recordings and current recorder status |
/flashback status |
/flashback list |
Lists saved recordings and their paths |
/flashback list |
/flashback autorecord on |
Records current players and future joins automatically |
/flashback autorecord on |
/flashback autorecord off |
Stops starting automatic recordings |
/flashback autorecord off |
/flashback autorecord status |
Shows whether automatic recording is enabled |
/flashback autorecord status |
Replay tools
| Command |
What it does |
Example |
/flashback verify <replay> |
Checks whether a replay is valid |
/flashback verify IM_DIV/example.zip |
/flashback convert <replay> <version> |
Creates a converted copy for another version |
/flashback convert IM_DIV/example.zip 1.21.11 |
/flashback actions replay <replay> |
Shows actions stored in one replay |
/flashback actions replay IM_DIV/example.zip |
/flashback actions player <player> |
Searches indexed actions from a player |
/flashback actions player IM_DIV |
/flashback index rebuild |
Rebuilds the searchable replay list |
/flashback index rebuild |
Administration
| Command |
What it does |
/flashback doctor |
Shows recording health, warnings and integration status |
/flashback privacy status |
Shows which private content options are enabled |
/flashback reload |
Reloads the plugin configuration |
/flashback profile apply <full|evidence|performance> confirm |
Applies a prepared recording profile |
Commands are available to server operators by default and require the appropriate permission.
- Run:
/flashback doctor
- Start a test recording:
/flashback start player <player>
- Move around, interact with blocks and perform a few normal actions.
- Stop and save the recording:
/flashback stop <player>
- Open the saved ZIP with a compatible Flashback client.
- Check its action timeline:
/flashback actions replay <replay-path>
Recordings are stored under:
plugins/DSReplay/flashback
Useful server controls
DSFlashback includes options for:
- Allowed and blocked worlds
- Automatic recording
- Recording segment length
- Recording retention
- Terrain recording radius
- Disk-space safety
- Privacy settings
- Voice recording
- Player action recording
- Performance limits for larger servers
The default settings are intended to provide a practical balance between replay quality, server load and file size.
评论 0
登录后参与评分
还没有评论,来抢沙发吧