
UUEPBS - 移动层
非官方 UUEPBS 分支:按动画集划分的骨骼偏移层(徒手/单刃/双刃/大剑 × 待机/行走/奔跑/冲刺)、用于眨眼的程序化时间轴、平滑交叉淡化。
查看大图描述
XTGMods 出品的 UUEPBS 2.7.1 的非官方附加组件。 上游源码与发布版本:github.com/XTGMods/UUEPBS/releases
UUEPBS 为你提供全局身体滑块。本构建新增了第二层独立的骨骼偏移,按游戏实际正在播放的动画集进行拆分——因此你可以分别调整“徒手行走”、“大刀奔跑”、“双刀待机”,而不是对所有情况只做一个折中方案。
它是叠加式的:它叠加在普通滑块之上,绝不替换它们。
安装说明
- 照常为你的游戏安装 UE4SS 并确保其正常工作(其他 UE4SS 模组能加载)。
- 将压缩包中的 UUEPBS 文件夹解压到你的 Mods 文件夹:
- Phantom Blade Zero:
<Game Folder>\platform\steam\ue4ss\Mods\ - 其他 UE 游戏:
<Game Folder>\<Project Folder>\Binaries\Win64\ue4ss\Mods\
- Phantom Blade Zero:
- 启动游戏并按 F6。
结果应如下所示:
...\ue4ss\Mods\UUEPBS\
enabled.txt
native\UUEPBS.dll
Scripts\main.lua
Scripts\config.lua
...
如果面板无法打开,请参阅下方的故障排除——最常见的原因是该游戏的 Mods 文件夹位置不正确。
主要功能
你将获得
- 4 种情境 × 4 种移动状态 = 16 个独立旋钮
- 情境:徒手(武器收在背上)、单刀、双刀、大刀
- 状态:待机 / 行走 / 奔跑 / 冲刺
- 叠加式,而非覆盖式——旋转和位移相加,缩放相乘。所有原有滑块仍然有效。
- 平滑交叉淡化——在情境、状态和开/关之间过渡(0–1000 毫秒,可在面板中调整;默认 250 毫秒)。
- 动作播放期间绝不应用——当攻击 / 闪避 / 冲刺动作播放时,该层关闭且状态冻结,之后会淡入恢复。
- 预设包含这些层——保存预设会存储全部 16 个表;旧预设仍可加载。
- 自动保存——每个情境/状态保存为独立的 JSON,并在下次启动时恢复。
- 英文 / 中文界面——包含完整中文翻译, Language = "auto" 跟随系统(可在状态选项卡中切换)。
- 程序化时间轴(新增)——独立的动画选项卡:选择一组骨骼,串联 移动 和 延迟 节点,并循环播放。为眨眼而设计,适用于任何小幅周期性运动。片段保存在各自的文件中,通过明确的 保存 / 加载 手动保存,绝不自动保存。
快速开始(5 分钟)
- 按 F6 → 移动 选项卡。
- 选择一个武器情境——从 徒手(收刀) 开始——并选择一个状态,例如 行走。
- 勾选预览此情境/状态。此时该层会在你站立不动时应用,因此你可以无需移动即可进行调整。
- 搜索骨骼(例如 spine_04),然后拖动旋转 / 移动 / 缩放。编辑器与详细面板相同:镜像、子级模式、"仅显示已编辑"、Ctrl+单击输入数值。
- 取消勾选预览并关闭窗口。收起武器行走:偏移会在行走时出现,停下时淡出。
- 对单刀 / 双刀 / 大刀重复此操作——只需拔出你想调整的武器(面板会跟随游戏正在播放的动画)。
- 拖动混合(毫秒) 直到过渡感觉合适。
提示: 先给每个状态一个明显不同的值(例如 spine_04 偏航:待机 0,行走 5,奔跑 10,冲刺 15),跑动一圈确认切换正常,然后再细化。
时间轴动画(眨眼及其他小幅循环)
- 打开动画并从
中选择一个片段。包中自带UUEPBS Presets\Animations\
——将其复制到那里即可获得现成的眨眼动画。Extras\Animations\blink.json - 一个轨道是一组骨骼:单击骨骼按钮,搜索并勾选骨骼(例如 FACIAL_L_EyelidUpperA / FACIAL_R_EyelidUpperA)。
- 其下方是节点列表,从上到下播放:
- 移动——持续时间 + 缓动(线性 / 平滑 / 缓入 / 缓出 / 缓入缓出)+ 目标旋转 / 平移 / 缩放。
- 延迟——固定时间,或随机范围(每次进入节点时重新抽取随机值)。
- 自由地添加、删除、重新排序和混合节点;勾选循环以重复轨道。
- 播放 / 暂停 / 重启是全局的,每个片段都有自己的启用标志。轨道下方的条按比例显示其节点,绿线是实时播放头。
- 按保存将片段写入
;加载会重新读取它(如果有未保存的更改,它会先询问)。不会自动保存任何内容。Animations\<name>.json
动画会叠加在滑块和移动层之上,仅应用于玩家角色。多个片段可以同时运行:不同骨骼独立运动,如果两个片段涉及同一骨骼,数值会相加(旋转相加,缩放相乘)。
游戏如何决定应用哪一层
- 徒手——玩家身上每件可见武器都挂接到名称包含 Back 的插槽上。
- 武器类型——直接读取角色动画蓝图自身的 WeaponType 值。在 Phantom Blade Zero 中它等于 EWeaponType - 1:
| 值 | 含义 |
|---|---|
| 0 | 单刀 |
| 1 | 双刀 |
| 2 | 大刀 |
| 3 | 手中无武器 |
因为这是游戏自身用来挑选动画集的变量,所以每个值对应一层 = 每套招式对应一层。调整一套招式一次,而不是每把武器模型调一次。
- 回退——在拔出武器后的那一两帧里,该值仍然陈旧时,模组会回退到收刀插槽类型,然后再回退到 config.lua 中可选的按武器覆盖设置。
- 移动状态——来自 CharacterMovement 速度:< 30 待机,< 300 行走,< 700 奔跑,否则冲刺(均可配置),带 120 毫秒防抖。
- 动作——任何蒙太奇播放时(攻击、闪避、冲刺攻击),该层会关闭且状态冻结。
需求
- UE4SS 已安装并正常工作(针对 UE4SS v3.0.1 beta 构建并测试)
- XTGMods 出品的 UUEPBS 2.7.1。
你不需要安装原始 UUEPBS——本包是完整构建。如果你已安装,覆盖安装即可(如果想切回,请先备份你的 native\UUEPBS.dll)。
故障排除
面板无法打开(F6) 检查 UE4SS 是否真的已加载(其他 UE4SS 模组 / 其自身日志),UUEPBS\enabled.txt 是否存在,以及 UUEPBS\native\UUEPBS.dll 是否存在——仅源码安装会静默无操作。查看 UE4SS.dll 旁边的 UE4SS.log。中文文本显示为方框 界面会合并来自 Windows 的中文字体(msyh.ttc / simhei.ttf / simsun.ttc)。安装中文字体(或中文语言包),或在 config.lua 中设置 Language = "en"。高亮了错误的武器类型 设置 LocomotionDebug = true,拔出武器,然后在 UE4SS.log 中查找 locomotion diag: ... WeaponType=N。如果该武器对应的值不正确,请将其添加到 config.lua 中的 LocomotionWeaponTypeOf(1blade, 2double, 3great)。奔跑时没有任何效果 徒手 层仅在所有武器都在背上时应用,武器层仅在武器拔出时应用,动作播放期间不应用任何层。检查状态选项卡中的 Live on N mesh(es)。游戏更新后找不到姿势钩子 打开状态选项卡并按刷新(或 F7)。详细信息在 native\UUEPBS.log 中。
卸载
删除 Mods\UUEPBS,或用原始 UUEPBS 构建替换 native\UUEPBS.dll 以恢复原版滑块。如果你以后想回来,你的层数据会保留在 UUEPBS Presets_locomotion_*.json 中。
致谢与许可
- 原始 UUEPBS © XTGMods——Nexus Mods。这是非官方修改,未获得原作者认可。原始 readme 已作为 README-original.md 包含在内,并且包含与原始源码的完整差异。
- Dear ImGui(MIT)——许可证文本已作为 LICENSE-Dear-ImGui.txt 包含在内。
- UE4SS 未包含在内;请单独安装。
- 使用风险自负:这会修改骨骼姿势。仅限离线 / 单人游戏。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。