Playback
作者 wo55555
Open-source Minecraft Bedrock replay mod with recording, cinematic camera keyframes, and experimental video export.
- 2,448 次下載
- 58 個星標
- 更新於
- 視覺與介面replay recording
README0.4.0-mc26.60
Playback
录下此刻,再现世界。
面向 Windows LeviLamina 的开源 Minecraft 基岩版回放录制与电影相机编辑模组,并提供实验性视频导出。
Warning
Playback 目前仍处于早期开发阶段,现有公开版本均为预发布版本。请备份重要世界和录制文件;在 Minecraft、LeviLamina 或 Playback 版本发生变化后,不保证旧回放仍然兼容。
Playback 将客户端可见的 Minecraft 基岩版游戏过程录制为便携回放文件,在隔离的本地回放世界中重建场景,并提供基于时间线的电影相机关键帧。当前还提供供测试使用的 MP4 和 PNG 序列导出。
快速开始
Important
建议尽量使用干净的 LeviLamina 客户端实例;目前不保证与其他模组广泛兼容。
- 为目标 Minecraft 版本创建或选择干净的 LeviLamina 客户端实例。
- 通过 LeviLauncher/Lip 或发行压缩包安装匹配的 Playback
#client版本。 - 启动游戏,使用
record start/record pause/record stop录制,然后从主菜单的 Playback 浏览器打开导出的回放。
截图、完整 Lip 命令、手动安装以及录制回放说明见安装与使用指南。
运行展示
主菜单入口
原生回放浏览器
回放预览与文件详情
游戏内时间线编辑器
Note
目前的 UI 仍在积极开发中,当前 UI 界面不代表最终效果。
Minecraft 基岩版回放与相机功能
- 游戏录制 — 捕获已加载区块、方块实体、实体移动、玩家状态、时间和经过筛选的客户端安全数据包。
- 多人服务器区块兼容 — 保留本地世界的区块处理方式,并针对采用其他区块传输方式的服务器,在客户端完成解码后录制可移植的回放数据。
- 低开销写入 — 异步写入回放快照和时间线数据,减少录制过程中的卡顿。
- 便携归档 — 将录制结果导出为便于保存和分享的回放文件。
- 隔离回放 — 通过原生主菜单回放浏览器,在独立的本地回放世界中打开录制内容。
- 回放浏览器 — 支持搜索、导入、筛选、排序、重命名、删除和打开回放,并提供平铺与列表视图。
- 回放缩略图 — 在游戏未打开菜单时尝试为录制内容捕获预览图。
- 时间线控制 — 支持播放、暂停、跳转、倍速调整和快速定位。
- 时间线编辑器 — 提供可缩放轨道、可调整面板、相机/序列/实体片段编辑,以及撤销与重做;工程随回放数据保存,重新打开时自动恢复。
- 服务器自定义方块与维度 — 注册从服务器录制的方块类型,并按名称解析自定义维度,让模组服务器的世界以自身的几何、材质和维度布局回放。
- 电影相机关键帧 — 记录位置、偏航、俯仰、滚转和 FOV,并支持平滑、线性、缓入缓出、保持、Hermite 与三次贝塞尔插值。
- 维度感知相机路径 — 每次维度变化都会切断相机轨道,预览和导出不会在不同世界之间错误插值。
- 第一人称跟随 — 以录制者、其他玩家或任意实体的视角观看回放,并还原录制时的 HUD、手持地图、视角摇晃以及传送门和睡觉效果。
- 预览控制 — 选择显示的 HUD 元素,调整预览音量、静音和暂停时静音,不影响导出音频;第一人称跟随录制者时可预览已录制的容器与服务器表单。
- 实验性视频导出 — 将指定 tick 区间渲染为带 AAC、Opus 或 FLAC 音频的 H.264 MP4,或带附属 WAV 的 PNG 序列。音频可关闭,可选择单声道或立体声,并可配置帧率、分辨率、SSAA、预热帧和每帧额外渲染次数。
- D3D11 与 D3D12 采集 — 支持两种原生渲染后端;D3D12 支持 1x/2x/4x SSAA,D3D11 使用 1x。
- 双语界面 — 为命令、原生回放界面和资源包主菜单按钮提供英文及简体中文本地化。
本版更新
v0.4.0 为 MC 26.10、MC 26.20、MC 26.40、MC 26.51 和 MC 26.60 提供相同的功能集。第一人称与第三人称相机轨道可选择录制者或其他玩家,也可从视口跟随实体。录制保留 HUD、手持地图、视角效果、服务器资源包和客户端生成的音效,本地视角可选最高 120 Hz 采样。时间线新增多选、吸附、标记和右键菜单,暂停菜单新增录制控制、保存对话框和录制指示器。
检查器的“预览”页可控制 HUD 和预览音频,且预览音频设置不影响导出音频。分页导出对话框新增音频编码、声道、码率及无音频导出选项。光照效果、界面动画等导出计时跟随回放时间;切换维度时保留录制的种子和群系,并重新预热渲染器。快照录制和跳转更快,从回放关闭游戏时也会清理临时世界,包括正在导出的情况。使用实验性渲染路径前请先阅读下方限制。
Caution
Playback 仍为预发布版本,可能进行不兼容的格式或配置更新。早于 v0.4.0 的录像不再支持,必须重新录制;程序可能无法识别旧归档的不兼容性。相机切换轨道已移除,旧编辑器工程中的切换轨道数据会被丢弃。升级前请备份录像和工程,不提供迁移功能。
Important
主菜单中的 Playback 按钮仍依赖轻量 UI 资源包。通过 Lip 或完整 Release ZIP 安装时,资源包会放入 mods/playback/resource_packs/playback-ui/;Release 同时提供 playback-ui.mcpack 供单独手动导入。
完整发行历史与详细变更见更新日志。
兼容性
Playback 为 0.4.0 维护五条独立预发布线。请仅安装与 Minecraft 和 LeviLamina 运行时匹配的版本;发行标签后缀不一定与游戏版本相同。
| Minecraft / LeviLamina | Playback 版本 | 状态 |
|---|---|---|
26.10.* | v0.4.0-mc26.10 | 预发布 |
26.20.* | v0.4.0-mc26.20 | 预发布 |
26.40.* | v0.4.0-mc26.40 | 预发布 |
26.51.* | v0.4.0-mc26.50 | 预发布 |
26.60.* | v0.4.0-mc26.60 | 预发布 |
所有发行线均面向 Windows x64 平台的 Minecraft 基岩版,并以纯客户端模组形式发布。mc26.50 发行线对应 Minecraft 26.51;mc26.60 构建严格要求 Minecraft 1.26.60.5,不支持其它 26.60 游戏构建。26.40 的依赖范围为 >=26.40.5 <26.50.0。
Note
MC 26.20 有意跳过 0.2.0 版本。该运行时上的视频导出无法工作:26.20 头文件错误声明了结构体对齐,导致采集路径从填充字节读取渲染项数量,把所有提交都判定为纯覆盖层,每次导出都卡在第 0 帧。因此 26.20 发行线从 v0.1.2-mc26.20 直接进入包含该修复的 v0.2.1-mc26.20。MC 26.10 发行线不受影响,已正常发布 v0.2.0-mc26.10。
Tip
Playback 为纯客户端模组,支持在本地世界和多人服务器中录制游戏过程。
从源码构建
Playback 使用 Visual Studio 2022、xmake 和 Git 在 Windows x64 上构建。干净 Release 构建命令、输出结构和依赖排错见源码构建指南。
命令
| 命令 | 说明 |
|---|---|
playback version | 显示当前加载的 Playback 版本。 |
record start | 开始或继续录制当前世界。 |
record pause | 暂停当前录制。 |
record stop | 停止录制并导出回放。 |
record rate [20-120] | 查看或设置本地玩家视角每秒采样次数,重启游戏前有效。 |
record indicator [on/off] | 切换、显示或隐藏屏幕上的录制指示器。 |
语言
Playback 目前提供英文(en_US)和简体中文(zh_CN)翻译,翻译文件位于 src/lang/。
常见问题
Playback 是什么?
Playback 是面向 Windows x64 LeviLamina 客户端的 Minecraft 基岩版回放录制与相机编辑模组。它会保存客户端可见的会话数据,并在独立的本地回放世界中重建。
Playback 可以录制多人服务器吗?
可以。Playback 是纯客户端模组,可录制本地世界或多人会话中客户端实际看到的区块、实体和经过筛选的数据包。2026 年 8 月 20 日热更新改进了采用其他区块传输方式或自定义实体注册表的服务器录制;修复前从未保存的数据无法恢复,受影响的回放可能需要重新录制。
Playback 可以将回放导出为视频吗?
可以,但仍为实验性功能。MP4 使用 H.264 视频,可选 AAC、Opus 或 FLAC 音频;PNG 序列可附带 .audio.wav。音频可关闭,也可选择单声道或立体声。AAC 是默认且兼容性更广的选项,部分播放器不支持 MP4 中的 Opus 或 FLAC。预览音量和静音不影响导出。
相机关键帧会跨维度插值吗?
不会。每次已录制的维度变化都会切断相机时间线,即使经过的中间维度没有相机关键帧也一样。
应该安装哪个 Playback 版本?
请按兼容性表选择。特别注意,Minecraft 26.51 对应 v0.4.0-mc26.50,而 v0.4.0-mc26.60 仅支持 Minecraft 1.26.60.5。不要混装不同发行线。
开发状态与计划
- 录制、回放、相机和导出工作流仍在持续构建与优化中。
- 后续将重点调试多人服务器会话的录制与回放,欢迎测试并反馈问题。
- 后续计划包括更广泛的渲染器兼容和更多相机工具。
Tip
测试重点: 报告相机、跨维度、区块加载或导出问题时,请附上回放文件、日志、GPU、渲染后端和导出设置。
已知限制
- 回放格式仍在开发中,Alpha 版本之间可能发生变化。
- Playback 重建的是已录制的客户端可见状态,并不是原始服务器模拟过程的确定性副本。
- 当前不会将待处理的计划刻以及村庄、袭击、POI 等服务端系统保存为权威模拟状态。
- 视频导出仍为实验性功能,可能仍存在运行时问题。
- 日常录制、回放和导出建议使用原版标准/精美画质。光线追踪与灵动视效(Vibrant Visuals)已进行针对性的导出测试和计时修复,但仍属实验性路径,不代表已保证广泛的渲染器或着色器包兼容性。
- 部分导出的规则网格/抖动图案,以及偶发的原生维度加载警告仍在调查中。遇到问题请附上渲染器、导出设置、日志和可复现的短片段。
- D3D12 的 SSAA 上限为 4x(超采样渲染尺寸放不下时更低),D3D11 使用 1x。
- 相机只能渲染回放数据中实际存在的区块,无法重建从未录制的地形。
- 2026 年 8 月 20 日的修复无法追溯恢复现有回放归档中已经缺失的服务器区块或自定义实体注册数据。
- Minecraft 或 LeviLamina 更新后,需要重新确认兼容性。
报告可复现问题时,请尽量附带日志、相关版本和最小回放文件。
如需报告可复现问题,请创建 Issue。
参与贡献
构建说明见源码构建指南,格式化和 Pull Request 流程见 CONTRIBUTING.md。
请阅读并遵守 行为准则。参与本项目即表示你同意遵守其中条款。
安全问题请按照 SECURITY.md 私下报告,不要为安全漏洞创建公开 Issue。
行为准则
Playback 采用 Contributor Covenant 行为准则。请在参与 Issue、Pull Request、Discussion 或社区空间之前阅读 CODE_OF_CONDUCT.md。
致谢
特别感谢 LeviLamina 的维护者与社区提供原生模组开发平台和工具,使 Playback 得以实现;同时感谢 Flashback 项目及其贡献者,其回放理念与架构为 Playback 提供了重要启发。
许可证
Copyright (C) 2026 wo555
Playback 采用 GNU Affero 通用公共许可证 v3.0 发布。分发修改版本时必须继续使用 AGPL-3.0,并提供对应源代码。第三方组件保留各自许可证,详情见 THIRD_PARTY_NOTICES.md 和 licenses/ 目录。