QuickSL

QuickSL

F5 快速存档、F6 快速读档,并且读档后**尽量留在原地**,不再被拉回最后使用的铃铛。

一、前置:UE4SS

本 mod 是 UE4SS 的 Lua 脚本,必须先装 《影之刃零》专用 UE4SS(官方通用版在这个游戏上不加载 mod)。

下载(二选一):

认准 "UE4SS for Phantom Blade Zero",不要下成别的游戏的 UE4SS。


二、安装

  1. 完全关闭游戏。
  2. 把 UE4SS 压缩包解压到 包含 PBZ.exe 的目录:
    ...\steamapps\common\PBZ\platform\steam\
    
    解压后应当是:
    platform\steam\PBZ.exe            ← 约 511 MB 的那个
    platform\steam\dwmapi.dll
    platform\steam\ue4ss\
    
    ⚠️ 不是游戏根目录 ...\common\PBZ\,也不是 steam\(那个 PBZ.exe 只有 1 MB,是启动器)。
  3. 把本压缩包里的 PBZQuickSave 文件夹复制到:
    ...\platform\steam\ue4ss\Mods\PBZQuickSave\
    
    最终结构:
    ue4ss\Mods\PBZQuickSave\enabled.txt
    ue4ss\Mods\PBZQuickSave\Scripts\main.lua
    ue4ss\Mods\PBZQuickSave\Scripts\config.lua
    ue4ss\Mods\PBZQuickSave\Scripts\actions.lua
    ue4ss\Mods\PBZQuickSave\Scripts\scan.lua
    ue4ss\Mods\PBZQuickSave\Scripts\util.lua
    
  4. 启动游戏,打开 ...\platform\steam\ue4ss\UE4SS.log,搜索 PBZQuickSave,应看到:
    [PBZQuickSave] v1.0 已加载 —— F5 存档 / F6 读档留在原地(覆盖+按需传送) / F10 修复输入
    
    如果没加载:打开 ue4ss\Mods\mods.txt,加一行 PBZQuickSave : 1,重启游戏。

三、使用

按键 功能
F5 快速存档(写入独立槽 PBZQuickSave)
F6 快速读档(优先读 PBZQuickSave;读档后尽量留在原地)
F7 生成函数扫描报告(调试用)
F8 打印状态(PC / 存档子系统 / 是否忽略输入)
F9 探测存档槽(调试用)
F10 修复输入(如果读档后不能移动/交互)

注意:

  • F5 有 3 秒冷却、F6 有 8 秒冷却,连按会被忽略(日志会写"上一次操作还没结束")。
  • F5 不会动你的自动档和手动档;主菜单「继续游戏」仍然读 AutoSave0。
  • 快速档是独立槽,通常不会显示在游戏的读档列表里,只能按 F6 读。

四、存档安全

  • 第一次用之前,手动备份:
    ...\PBZ\ProjectPBZ\Saved\SaveGames\
    
    整个文件夹复制一份即可。
  • mod 不直接读写 .sav(游戏存档是加密的 PBZS 格式),只是调用游戏自己的存/读函数。
  • 如果读档后卡住、不能交互:
    1. 先按 F10;
    2. 还不行就完全退出游戏重开;
    3. 仍异常就在「载入游戏」里读更早的 AutoSave1 / ManualSave1,或用备份恢复。
  • 连续快速 SL 有冷却保护,但仍建议每次操作间隔几秒。

五、配置(可选)

文件:ue4ss\Mods\PBZQuickSave\Scripts\config.lua,改完保存,重启游戏生效。

配置项 默认 说明
slot_name PBZQuickSave 快速存档槽名。改成 AutoSave0 会覆盖「继续」档,风险更高
keep_position true 读档时用游戏接口覆盖出生点,尽量留在 F5 的位置
teleport_fallback true 覆盖没生效时,读档 6 秒后按需把角色传送回记录点
save_cooldown_s 3 F5 冷却
load_cooldown_s 8 F6 冷却

如果遇到"读档后不能交互",把 teleport_fallback 改成 false(只保留游戏自带的覆盖),或 keep_position = false(完全恢复原版"回铃铛")。

跨关卡读档时,"留在原地"不会生效(坐标属于存档所在的那一关),这是正常的。


六、常见问题

Q:按 F5/F6 没反应?

  • 看 UE4SS.log 里有没有 [PBZQuickSave] 开头的行;没有就是 UE4SS 没加载(检查安装路径、enabled.txt、mods.txt)。
  • 有日志但没动作:可能在上一次操作的冷却里,等几秒再按。

Q:读档还是回铃铛?

  • 确认 keep_position = true、teleport_fallback = true;
  • 跨关卡不生效;
  • 看日志里的 位置校验(t+3000) 和 K2_SetActorLocation 结果。

Q:读档后不能交互?

  • 按 F10;不行就重启游戏;再不行读更早的自动/手动档。

Q:游戏更新后进不去/崩溃?

  • 游戏更新可能让 UE4SS 的签名失效。先删除 platform\steam\dwmapi.dll 和 ue4ss\,等新版 UE4SS 再装。

Q:支持 Epic / PS5 吗?

  • 只在 Steam 版(build 26266538,UE 5.7.4)上测试过;Epic 版未验证,PS5 不支持。

七、卸载

  1. 删除 ue4ss\Mods\PBZQuickSave 文件夹。
  2. 如果不再用任何 UE4SS mod:删除 platform\steam\dwmapi.dll 和 platform\steam\ue4ss\。

八、文件结构

PBZQuickSave-v1.0\
├─ README.md                本文件
├─ INSTALL.txt              快速上手
├─ CHANGELOG.md              更新记录
└─ PBZQuickSave\ ← 复制到ue4ss\Mods\
  ├─ enabled.txt
  └─ 脚本\
      ├─ main.lua 热键注册
      ├─ config.lua配置
      ├─ actions.lua 存/读档实现
      ├─ scan.lua 反射扫描
      └─ util.lua 日志与文件

九、说明

  • 本mod为玩家自制,与S-GAME、UE4SS官方均无关联。
  • UE4SS 使用 RE-UE4SS(MIT);PBZ 专用包来自社区(Nexus 作者 KintaroxOe / Vercadi)。
  • 只建议单机使用;游戏更新后可能需要等新的UE4SS兼容包。