Replay Mod (Fabric & Forge)

在 渲染方式下拉菜单下方，还有一个用于选择编码预设的下拉菜单。

<mark>注意： 如果你只想以良好的画质渲染 MP4 视频，请不要更改这些设置。</mark>

你可以从以下 7 种编码预设 中进行选择：

• MP4 – 默认画质
  以默认画质渲染使用 x264 编码器 编码的MP4 视频。这是默认的编码预设，因为它能导出画质良好且文件体积相对较小的视频。
• MP4 – 高画质
  以高画质渲染使用 x264 编码器 编码的MP4 视频。渲染后的视频文件体积相对较大，但画质几乎无损。对于需要多次编码（渲染）素材的视频制作者来说，这个预设很实用。
• MP4 – 极低画质
  以极低画质渲染使用 x264 编码器 编码的MP4 视频。虽然视频画面看起来很糟，但文件体积极小，因此可以使用此预设进行测试渲染。
• MP4 – 自定义比特率
  选择此预设后，比特率输入框 将会启用，你可以自行设置视频的比特率。渲染后的视频是使用 x264 编码器 编码的MP4 视频。
• WEBM – 自定义比特率
  选择此预设后，比特率输入框 将会启用，你可以自行设置视频的比特率。渲染后的视频是使用 vp8 编码器 编码的webm 视频。
  如果你想将素材直接上传到 YouTube 等流媒体服务，使用webm 视频文件 会很方便，因为这些服务在处理 vp8 编码的视频 时通常无需进行转换。
• MKV – 无损
  以无损画质渲染使用 x264 编码器 编码的MKV 视频。虽然这些视频文件的画质完美，但大多数非基于 FFmpeg 的视频播放器和视频编辑软件（例如 QuickTime Player、Sony Vegas 和 Adobe Premiere）都无法播放这类视频。因此，大多数情况下建议改用 MP4 – 高画质 预设。
• PNG 序列
  将序列导出为PNG 格式 的单独帧。
  图像画质完美。深度图图像采用 32 位浮点编码，存储于按 BGRA 顺序排列的 8 位分量中；要在大多数编辑器中使用，还需要进行某种后期处理。
• OpenEXR 序列 （Minecraft 1.14 及以上版本）
  将序列导出为OpenEXR 格式 的单独帧。图像画质完美，并且可能包含可见图层以外的其他图像图层（例如 深度图）。因此，如果你有充足的磁盘空间，并且想在第三方视频编辑器中进一步编辑视频，这种格式是个不错的选择。

如果你不想在渲染的视频中看到实体的名称标签，只需取消勾选该复选框。隐藏的名称标签也包括盔甲架和生物的名称标签，而不仅仅是玩家！

此设置仅适用于立方体渲染和等距柱状渲染。
因为你可以在360 度查看器中旋转摄像机，倾斜的摄像机视角会导致奇怪的体验：如果用户环顾四周，由于摄像机向上或向下看，他的视野可能会显得倾斜。因此，建议使用相应的复选框始终稳定摄像机的俯仰角和翻滚角。

示例 360° 视频，未稳定摄像机俯仰角
示例 360° 视频，已稳定摄像机俯仰角和翻滚角

这是一个面向视频制作者的实验性设置，允许你将天空颜色更改为固定颜色。使用视频编辑软件（如Adobe After Effects或Sony Vegas），你可以将天空颜色更改为透明，并添加自己的素材作为天空。点击此处了解更多关于色度键控的信息。

<mark>注意：为获得最佳效果，渲染前应禁用云，因为它们是透明的。</mark>

此设置会使深度信息被记录并包含在支持它的视频格式中（目前仅OpenEXR）。

使用支持它的视频编辑器（例如Blender），你可以在渲染的视频上添加任意几何体（以及许多其他效果），使视频中的前景物体仍然遮挡背景几何体，就像它实际上是世界的一部分一样。

<mark>注意：为获得最佳效果，请避免在几何体前方使用半透明方块，因为它们无法在深度图中准确表示。</mark>

<mark>注意：导出深度时不支持抗锯齿。请改为以更高分辨率渲染和编辑视频，并在最后将其缩小。</mark>

<mark>注意：本设置仅面向高级用户。如果你不清楚自己在做什么，请保持这些设置不变。</mark>

Replay Mod 通过命令行运行 FFmpeg 来编码视频。

你可以在渲染设置界面的命令行设置部分自定义执行的命令和命令行参数。

如果你将左侧输入框留空，将使用 ffmpeg 作为命令。如果你没有将 PATH 变量设置为指向你的 FFmpeg 发行版，只需输入 FFmpeg 可执行文件的完整路径（例如 C:\ffmpeg\ffmpeg.exe 或 /usr/local/bin/ffmpeg）。

在右侧输入框中，你可以输入自定义的命令行参数，供控制台使用。

每个编码预设基本上都代表一组与 ffmpeg 命令配合使用的命令行参数。自定义这些命令行参数可以让你使用特定的编解码器或质量设置等。
如果你需要了解 ffmpeg 命令行参数的入门知识，请阅读 FFmpeg 文档。

在将给定的命令行参数传递给 ffmpeg 命令之前，Replay Mod 会将以下占位符替换为你在渲染设置界面中的输入：

• %WIDTH%
  视频的宽度
• %HEIGHT%
  视频的高度
• %FPS%
  视频的帧率
• %FILENAME%
  视频的文件名（不含扩展名）。由于文件名可能包含空格，应使用引号 " 将其括起来。
  由于 ffmpeg 命令始终从目标文件的父目录执行，因此 %FILENAME% 不包含文件的完整路径。
• %BITRATE%
  视频的比特率，单位为千字节每秒。由于 %BITRATE% 占位符已包含值标识符“K”，你无需关心比特率值的格式。

点击右下角的 渲染按钮 即可开始 默认性能渲染。通常，这种模式的渲染速度完全够用，但你也可以使用 高性能渲染 来进一步提升速度。

要使用 高性能渲染，请按住 Ctrl 键（Mac 上按住 Cmd 键）的同时点击 渲染按钮。
高性能渲染 通过以下调整来提升渲染速度：

• 渲染进度、预计剩余时间和按钮点击次数不再每渲染一帧就重新计算，而是每渲染一秒后才重新计算一次（例如，以 60fps 渲染时，每 60 帧计算一次）
• 调整 Minecraft 窗口大小时，不会更新渲染界面

如果你的回放场景较暗（例如夜间或洞穴中），而 亮度：明亮 仍然不够亮，你可以使用 Z 键（某些键盘上为 Y）切换 环境光照。

这可以替代 夜视药水效果，且不会造成天空颜色异常的副作用。

在回放中首次启用 快速模式 时，系统会存储部分实体和方块属性的内部参考信息，以便快速访问，从而加快在 回放时间轴 中的导航速度。作为副作用，预览中不会渲染粒子和第二层皮肤等部分内容。默认情况下，按 Q 键可切换 快速模式。

按 B 键即可打开 玩家概览。在 玩家概览 中，你可以看到回放中当前已加载的所有玩家列表。

点击玩家的 名称或头部，即可旁观该玩家。

每位玩家旁边都有一个 复选框，可用来切换该玩家的 可见性。这样，你就可以在回放中隐藏某些玩家。
在各个复选框下方，有两个复选框按钮——一个用于隐藏所有玩家，另一个用于显示所有玩家。

如果想要保存玩家可见性设置，请勾选 “记住隐藏的玩家”复选框。勾选后，关闭回放后不可见的玩家仍会保持隐藏状态（当然，你可以随时恢复显示）；否则，重新加载回放后，所有玩家都会再次显示。

在回放中，你可以按 N 键为当前回放创建一张缩略图。
缩略图是一张截图，旨在让观看者对回放内容有一个不错的了解。

缩略图有助于让回放查看器保持清晰、有条理。

如果回放没有设置缩略图，回放查看器中将显示默认缩略图。

较长的回放很容易变得杂乱且难以操作。因此，事件标记是一种简单的方式，可以标记回放中的重要事件。

录制回放时，你可以随时按 M 键来设置一个事件标记。该事件标记会记录你添加它时的位置，之后观看回放时，它会显示在回放时间轴上。

观看回放时，在回放时间轴上右键点击某个事件标记，即可跳转到其对应的位置和时间戳。

观看回放时，你也可以按 M 键添加新的事件标记。

双击事件标记即可为其命名。将鼠标悬停在事件标记上时，会显示其名称。这样一来，整理回放内容就更加简单了。

若要删除事件标记，请单击该标记将其选中，然后按 DELETE 键。

理论上，回放文件最长可达 24天20小时30分23秒 ——你大概永远也不会录到这么长。

如果你在 单人游戏 中游玩，会记录你 渲染距离 内所有已加载的区块。
如果你在服务器上游玩，则取决于 server.properties 文件中的 view-distance 设置，该设置默认为 11个区块。

Replay Mod 当然会记录所有已加载的区块，而不仅仅是已渲染的区块。因此，你身后的区块也会被记录。

由于 Replay Mod 的工作方式，你需要在加入 服务器 或 世界 时开始录制，否则回放文件所需的部分数据会缺失。

通常，录制回放不会 影响帧率，也不会导致服务器卡顿。
我们曾在一台仅有 3GB 内存 的低端笔记本电脑上测试该模组，一切运行正常。

录制的 .mcpr 文件 大小很大程度上取决于回放包含的世界数据量。
在旅途中探索了大量地形的回放，文件会明显大于在虚空世界中录制的回放。

时长为 10分钟 的回放文件通常约为 2MB至10MB。在粒子效果繁多、世界变化频繁的 小游戏服务器 上录制的回放，文件可能会更大。

<mark>如果渲染时遇到问题，请先查阅文档，然后再到 Discord 寻求帮助。</mark>

如果你尚未安装 FFmpeg，请按照这里提供的步骤进行安装。

如果你已经安装了 FFmpeg，则需要手动告知 Replay Mod FFmpeg 可执行文件的位置。

首先，获取 ffmpeg.exe （Windows）或 ffmpeg 可执行文件（Mac/Linux）的完整路径。
在 Windows 上，该路径可能类似于 C:\ffmpeg\ffmpeg.exe。

然后，在渲染设置中打开 “命令行设置”部分，将此路径粘贴到左侧输入框中，然后重试渲染。

如果 Minecraft 在渲染几帧后崩溃，最可能的原因是 FFmpeg 无法识别你传入的命令行参数。如果你手动自定义了命令行参数，请重新检查——问题很可能出在你自己的设置上。

<mark>提示： 在你的 .minecraft 文件夹中，你会找到一个名为 export.log 的文件，其中包含 FFmpeg 渲染过程的信息。</mark>

• 如果你没有 自定义命令行参数，可能是输入了极高（或极低）的数值，例如比特率或视频分辨率。请尝试使用其他更合理的数值。
• 确保摄像机不会移动到 Y=0 以下或 Y=255 以上

Future Client 与 ReplayMod 所需的 Mixin 不兼容。
Lunar Client 不支持 ReplayMod。
Badlion Client 提供了一个不同的 ReplayMod，并非此处所指的版本。

通常，Replay Mod 应该 能与大多数 Forge 和 Fabric 模组兼容。

从 Minecraft 1.9.4 开始，Karyonix’ Shaders Mod 已不再兼容 Minecraft Forge。因此，它也不兼容 Replay Mod。

在低于 Minecraft 1.16 的版本中，你可以改用 Optifine。但请注意，官方支持已结束，而且许多版本会导致 ReplayMod 无法正常运行。

在 Minecraft 1.16.5 及更高版本中，你可以使用 Iris，它受到完整支持。目前，你需要搭配下载页面提供的定制版 Sodium 使用。该版本包含的修复尚未合并到官方版本中。

Custom Main Menu 模组常用于整合包中自定义主菜单，例如设置与背景图片相匹配的按钮布局、添加整合包网站或问题追踪器的链接等。如果你熟悉这个模组，Replay Mod 的按钮 ID 为： 17890234 （文本： replaymod.gui.replayviewer）。

由于 Custom Main Menu 模组的特性，第三方模组（例如 Replay Mod）添加到主菜单的按钮默认不会显示。
因此，要使用回放查看器/编辑器/中心，你需要手动配置这些按钮的位置。
为此，你需要修改 Custom Main Menu 的配置文件。通常可以在 .minecraft/config/CustomMainMenu/mainmenu.json 找到该文件（如果你使用的是整合包启动器，它通常有自己的 .minecraft 文件夹）。
有关此配置文件的说明，请参阅 Custom Main Menu 的页面。

你可以在此处找到已经修改好的配置文件列表。

使用 Replay Viewer 界面时，Tickrate Changer 模组可能会导致 Minecraft 卡死。

据报告，LabyMod v3.7.x 与 ReplayMod 及其他 Forge 模组兼容。较低版本则不兼容。

如果同时使用 ReplayMod 和 OldAnimationsMod 时 Minecraft 崩溃，请尝试移除 OldAnimationsMod。

如果你在使用光影时同时启用了 ReplayMod 和 1.7 Animations，可能会看到漂浮的水和玻璃。移除 1.7 Animations 即可解决此问题。

我们收到过与 Patcher 有关的崩溃报告；如果发生崩溃，请尝试移除 Patcher。

Baritone 模组可能会在尝试加载回放时导致崩溃。如果遇到此类问题，请尝试在不运行 Baritone 的情况下启动。

如果尝试将 RandomPatches 与 ReplayMod 一起使用，Minecraft 可能会崩溃。如果 Minecraft 在启动时崩溃，请尝试移除 RandomPatches。

安装 Sodium 后，ReplayMod 可以录制回放，但目前缺少用于渲染的 FREX Flawless Frames API。ReplayMod 下载页面提供了支持此 API 的修改版 Sodium，点击 Click to show compatible Sodium versions 按钮即可获取。

Resource Loader 模组与 ReplayMod 不兼容。

已知 LiteLoader 所包含的 mixin 版本会导致问题。

你可以使用 MultiMC 来绕过此问题。

<mark>MultiMC 的 Edit 功能要求你的电脑已为 json 文件关联默认编辑器。</mark>

1: 创建实例，然后编辑该实例
2: 点击 Install Forge
3: 点击 Install LiteLoader
4: 点击 Add Empty；将名称设为 ReplayMod，将 uid 设为 com.replaymod
5: 选中新建的 ReplayMod，然后点击 Edit
6: 将内容替换为以下其中一段代码
7: 保存并关闭文本编辑器
8: 将 ReplayMod 上移，直到它位于 上方LiteLoader
9: 如果之前安装过 ReplayMod，请从 mods 文件夹中移除 ReplayMod 的 jar 文件。

适用于 1.8.9 的代码片段
{ "formatVersion": 1, "name": "ReplayMod", "uid": "com.replaymod", "version": "1.8.9-2.4.5", "libraries": [{ "name": "com.replaymod:replaymod:1.8.9-2.4.5", "MMC-absoluteUrl": "https://minio.replaymod.com/replaymod/replaymod-1.8.9-2.4.5.jar" }]}

适用于 1.12.2 的代码片段
{ "formatVersion": 1, "name": "ReplayMod", "uid": "com.replaymod", "version": "1.12.2-2.4.5", "libraries": [{ "name": "com.replaymod:replaymod:1.12.2-2.4.5", "MMC-absoluteUrl": "https://minio.replaymod.com/replaymod/replaymod-1.12.2-2.4.5.jar" }]}