离线回放库

[url=https://www.buymeacoffee.com/higorae]支持我的工作 / 请我喝杯咖啡[/url]

Offline Replay Vault 是一个用于《街头霸王6》的 REFramework Lua 模组，可将你的回放保存为文件，并在游戏原生的回放查看器中播放这些文件。

[line]

[size=5][b]描述[/b][/size]

《街头霸王6》仅保留有限的本地回放列表，且保存的文件经过加密，并与录制它们的账号绑定。在线回放（例如你的收藏）可能会从服务器上消失。借助此模组，你可以将任意回放备份为一个小的 JSON 文件，想保存多久就保存多久，之后在正常的回放界面中播放。你还可以将文件发送给朋友，让他们在自己的游戏中播放。

[list]
[][b]一键备份整个本地回放列表[/b]，无需播放任何回放。[/]
[][b]播放时自动备份：[/b]你观看的每个回放都会被保存，包括收藏和其他在线回放。[/]
[][b]播放任意备份[/b]，从模组窗口中操作。它会在游戏自带的回放查看器中打开，支持暂停、倒退和镜头控制，退出时返回模式选择界面。[/]
[][b]以卡片形式浏览备份[/b]，显示日期、角色、回合比分和来源，并带有搜索框。[/]
[][b]用播放列表整理备份[/b]，例如按对局或按你想练习的内容分类。[/]
[][b]分享回放[/b]，只需发送 [font=Courier New]replay_.json[/font] 文件。不涉及账号或存档文件。[/]
[][b]可选快捷键[/b]，无需打开菜单即可播放、浏览和备份。[/]
[/list]
[b]安全且仅用于练习：[/b]本模组从不修改你的存档文件（[font=Courier New].bin[/font]）。要播放备份，它只是将录像放入游戏的回放队列并打开回放界面，与菜单调用相同。它从不注入输入，也从不干预对局。请勿在排位在线对局中使用。

[line]

[size=5][b]安装说明[/b][/size]

[size=4][b]前置条件[/b][/size]

请先确保已安装 REFramework：

[list=1]
[]从 [url=https://github.com/praydog/REFramework/releases]REFramework GitHub Releases[/url] 页面下载 SF6.zip。[/]
[]将 [font=Courier New]dinput8.dll[/font] 和 [font=Courier New]reframework/[/font] 文件夹直接解压到《街头霸王6》游戏根目录——即 [b]StreetFighter6.exe[/b] 所在的同一文件夹。[/]
[/list]
已在 REFramework v1.5.9 上测试。

[size=4][b]模组安装[/b][/size]

[b]方式 A — 手动安装（推荐）[/b]

[list=1]
[]下载并解压模组的 zip 文件。[/]
[]将解压出的 [font=Courier New]reframework/[/font] 文件夹直接复制到《街头霸王6》游戏根目录（与 [b]StreetFighter6.exe[/b] 同一文件夹），合并到你现有的 [font=Courier New]reframework/[/font] 文件夹中。保持以下确切结构：[/]
[/list]
[code]
Street Fighter 6/
├── StreetFighter6.exe
├── dinput8.dll
└── reframework/
└── autorun/
└── offline_replay_vault.lua ← 模组脚本[/code]
[i]注意：本模组是单个脚本。无需将任何文件放到其他位置。备份会自动创建在 [font=Courier New]reframework/data/offline_replay_vault/[/font] 中。[/i]

[b]方式 B — Fluffy Mod Manager[/b]

[list=1]
[]将模组的 zip 压缩包拖放到 Fluffy Mod Manager 中。[/]
[]在列表中启用模组并点击 [b]Deploy[/b]。[/]
[/list]
[b]从 0.1 版本更新：[/b]用新的 [font=Courier New]offline_replay_vault.lua[/font] 替换旧文件。你的备份会保留在原处，并会显示在新列表中。

[b]从 SF6 Replay Dump（旧名称）更新：[/b]安装前请删除 [font=Courier New]reframework/autorun/sf6_replay_dump.lua[/font]，否则模组会显示两次。你在 [font=Courier New]reframework/data/sf6_replay_dump/[/font] 中的旧备份仍然可用，并仍会显示在列表中。

[line]

[size=5][b]游戏内使用方法[/b][/size]

[list=1]
[]启动《街头霸王6》。[/]
[]按 [b]Insert[/b]（REFramework 默认快捷键）打开菜单覆盖层。[/]
[][b]Offline Replay Vault[/b] 窗口会随之打开。它包含五个标签页：[b]Backups[/b]、[b]Playlists[/b]、[b]Hotkeys[/b]、[b]Diagnostics[/b] 和 [b]About[/b]。底部的状态行会显示每个按钮的结果（绿色）或错误（红色）。[/]
[/list]
[size=4][b]备份你的回放[/b][/size]

[b]整个本地回放列表：[/b]

[list=1]
[]打开 [b]Local Replays[/b]。状态行会显示 [font=Courier New]local list loaded: N slots[/font]。[/]
[]点击 [b]Back up replays[/b]。列表中的每个回放都会被保存，无需播放其中任何一个。[/]
[]状态行会显示 [font=Courier New]backup: N replays saved, N already saved, 0 incomplete[/font]。[/]
[/list]
[b]自动备份：[/b]勾选 [b]Auto backup on play[/b]。从那时起，你播放的每个回放都会自动保存，包括收藏和其他在线回放，并会短暂提示文件名。该选项会被记住。

[b]单个回放：[/b]当回放正在播放时（暂停也可以），点击 [b]Back up replays[/b]。

在线回放（收藏、搜索等）只能通过播放来保存：游戏仅在你播放时才会下载回放。文件夹中已有备份的回放会被跳过，因此你可以随意多次点击该按钮。

[size=4][b]播放备份[/b][/size]

[list=1]
[]进入 [b]Local Replays[/b] 界面，且没有正在播放的回放。[/]
[]在 [b]Backups[/b] 标签页中，打开你想播放的回放卡片（使用 [b]Search[/b] 可更快找到）。[/]
[]点击卡片上的 [b]Play[/b]。[/]
[/list]
游戏会正常打开回放。当你通过暂停菜单退出时，它会像任何普通回放一样返回模式选择界面。

每张卡片标题都会显示类似 [font=Courier New]12/10 20:57 Sagat vs Jamie[M] 1-0 local[/font] 的摘要：备份的日期和时间（回放本身没有对局日期）、角色（[font=Courier New][M][/font] = 现代操作）、回合比分（P1-P2）以及来源（[font=Courier New]local[/font]、[font=Courier New]online[/font]，或 [font=Courier New]vault[/font] 表示由模组播放的备份）。

[size=4][b]播放列表（可选）[/b][/size]

[list=1]
[]在 [b]Playlists[/b] 标签页中，输入名称并点击 [b]Create playlist[/b]。[/]
[]在 [b]Backups[/b] 标签页中，在 [b]Add to[/b] 中选择该播放列表，然后点击任意卡片上的 [b]Add to playlist[/b]。[/]
[]在 [b]Playlist[/b] 中选择该播放列表以仅显示其备份。选择 [b](all backups)[/b] 可再次查看全部。[/]
[/list]
一个备份可以属于多个播放列表。卡片上的 [b]Remove[/b] 和 [b]Delete this playlist[/b] 只会更改播放列表：你的 [font=Courier New]replay_.json[/font] 文件永远不会被删除。

[size=4][b]快捷键（可选）[/b][/size]

打开 [b]Hotkeys[/b] 标签页，点击某个操作旁的 [b]Set[/b]，然后按下你想要的按键或组合键（例如 Ctrl+F6）。Esc 取消，[b]Clear[/b] 移除绑定。你可以绑定：播放选定的备份、下一个/上一个备份、备份回放，以及开始/停止帧捕获。

[list]
[]所有快捷键初始均未绑定。建议优先使用 Ctrl 或 Shift 组合键。[/]
[]选定的备份会在其卡片上以 [font=Courier New]>[/font] 标记。下一个/上一个仅在所选播放列表内切换。[/]
[]播放快捷键在对局或回放期间会被忽略。[/]
[]会短暂提示发生了什么；你可以用 [b]On-screen notice[/b] 将其关闭。[/]
[/list]
[size=4][b]分享回放[/b][/size]

[list]
[][b]发送：[/b]制作备份并发送 [font=Courier New]replay_.json[/font] 文件。[/]
[][b]接收：[/b]将 [font=Courier New]replay_*.json[/font] 复制到 [font=Courier New]reframework/data/offline_replay_vault/[/font]，然后在 [b]Backups[/b] 标签页中点击 [b]Refresh backup list[/b]。[/]
[/list]
请发送 JSON，而非 [font=Courier New].bin[/font] 存档。[font=Courier New].bin[/font] 经过加密，很可能只能在录制它的账号上打开。

[line]

[size=5][b]快速测试（立即试用）[/b][/size]

想确认一切是否正常？

[list=1]
[]确保模组已安装且《街头霸王6》正在运行，REFramework 菜单可访问。[/]
[]打开 [b]Local Replays[/b]。[/]
[]按 Insert 并在 Offline Replay Vault 窗口中点击 [b]Back up replays[/b]。[/]
[]打开其中一个新备份的卡片并点击 [b]Play[/b]。[/]
[/list]
如果该回放能打开，说明模组安装正确！

[line]

[size=5][b]故障排除[/b][/size]

[list]
[][b]按 Insert 没有反应：[/b]REFramework 未正确安装。请仔细检查 [font=Courier New]dinput8.dll[/font] 和 [font=Courier New]reframework/[/font] 文件夹是否直接位于游戏文件夹内（与 [b]StreetFighter6.exe[/b] 同级），而不是在子文件夹内。[/]
[][b]REFramework 菜单打开了，但看不到 Offline Replay Vault 窗口：[/b]确保 [font=Courier New]offline_replay_vault.lua[/font] 直接位于 [font=Courier New]reframework/autorun/[/font] 内（不是散落在游戏根目录，也不是在 zip 中嵌套的多余文件夹内）。[/]
[][b][font=Courier New]backup: no replay loaded[/font]：[/b]请先打开 Local Replays（或播放一个回放），然后点击备份按钮。[/]
[][b][font=Courier New]backup: nothing new, N already saved[/font]：[/b]这些回放已有备份。如果你在游戏外删除或复制了备份文件，请先点击 [b]Refresh backup list[/b]。[/]
[][b][font=Courier New]player: no backup found[/font]：[/b]请先制作备份，或将 [font=Courier New]replay_*.json[/font] 复制到 [font=Courier New]reframework/data/offline_replay_vault/[/font] 并点击 [b]Refresh backup list[/b]。[/]
[][b][font=Courier New]error: open the menu (Local Replays) first[/font]：[/b]返回 Local Replays 界面并重试。[/]
[][b][font=Courier New]error: incomplete backup[/font]：[/b]请重新为该回放制作备份。[/]
[][b]备份未显示在列表中：[/b]点击 [b]Refresh backup list[/b]。仅列出直接位于 [font=Courier New]offline_replay_vault[/font] 文件夹中的文件，不包括子文件夹。[/]
[][b]出现带有 [font=Courier New]syntax error[/font] 的“ScriptRunner Message”窗口：[/b]脚本已损坏。请重新下载。[/]
[][b]播放备份时游戏关闭：[/b]请将 [font=Courier New]reframework/data/offline_replay_vault/[/font] 中的 [font=Courier New]rebuild_trace.json[/font] 和 [font=Courier New]player_error.json[/font] 发送给作者。[/]
[/list]
[line]

[size=5][b]模组创建的文件[/b][/size]

所有内容都放入 [font=Courier New]reframework/data/offline_replay_vault/[/font]。你的存档文件永远不会被触及。

[list]
[][font=Courier New]replay_*.json[/font]：你的备份。这些是你保留和分享的文件。文件名会标明日期、来源、角色以及槽位或在线回放 ID，例如 [font=Courier New]replay_20261012_183444_online_chun-li_vs_sagat_HVN8S3CXN.json[/font]。[/]
[][font=Courier New]playlists.json[/font]：你的播放列表。[/]
[][font=Courier New]config.json[/font]：快捷键、自动备份和所选播放列表。删除它可以重置这些设置。[/]
[][font=Courier New]player_error.json[/font]、[font=Courier New]rebuild_trace.json[/font]：上次播放尝试的诊断信息。[/]
[]其他文件仅在你使用 [b]Diagnostics[/b] 标签页时出现，可以删除。[/]
[/list]
备份包含角色的 ID、颜色以及对局输入。它们不包含你的 Steam 账号，但请避免发布你不想分享的文件。

[size=5][b]卸载[/b][/size]

删除 [font=Courier New]reframework/autorun/offline_replay_vault.lua[/font]。也可以选择删除 [font=Courier New]reframework/data/offline_replay_vault/[/font]，但请先保留你想留的备份。

[line]

[size=5][b]权限与致谢[/b][/size]

[list]
[]基于 praydog 的 REFramework 构建。[/]
[]窗口样式与 [url=https://www.nexusmods.com/streetfighter6/mods/3966]Training Mode Drill Share[/url] 共用。[/]
[]回放结构在社区项目的帮助下进行了研究：[url=https://github.com/rkaganda/sf6_replays_data]rkaganda/sf6_replays_data[/url]、[url=https://github.com/Wael3rd/SF6_Tools]Wael3rd/SF6_Tools[/url] 和 [url=https://www.nexusmods.com/streetfighter6/mods/3966]Training Mode Drill Share[/url]。[/*]
[/list]