VeilShift-变身为任意Boss 76种形态原生招式

VeilShift-变身为任意Boss 76种形态原生招式

变身为任意怪物、精英或Boss,并使用该角色自身的原生招式进行战斗。76种形态、按角色配置的招式组合、随机形态池、完整的键盘/手柄按键重绑定以及游戏内菜单。UE4SS Lua

1. 此模组的功能


VeilShift 让你只需按一个键即可 [b]变成游戏中的任何怪物或 Boss[/b],并使用 [b]该角色自身的招式[/b] 进行战斗——轻击连招、重击连招、抓取/处决、终极技、暗影武器和特殊技能。
这不是模型替换。每个形态都是通过游戏自身的资源管理器加载的 [b]真实蓝图 Actor[/b],然后由原生 GameplayAbility 系统驱动。因此伤害来自游戏真实的技能,而不是注入的虚假数值。
[b]你的玩家仍然是玩家。[/b] 原始的 PlayerController、摄像机目标、HUD、存档数据和区域触发器都保留在原角色上。变身后的形态是一个独立的、一次性的动作代理,会与你一起移动。再次按键(或按 [b]F10[/b])即可将一切还原。
[b]功能[/b]
[list]
[]v0.3.17 目录中有 [b]76 个形态[/b](菜单标注为“75变”):剧情 Boss、精英、杂兵和 NPC[/]
[/list][list]
[][b]原生招式[/b] —— 每个形态都保留自身的技能、动画、武器和 Niagara 特效[/]
[/list][list]
[][b]逐角色招式配置[/b] —— 选择该角色的 [i]哪些[/i] 招式放在哪个按键和哪个连招阶段上[/]
[/list][list]
[][b]随机形态[/b],带有可搜索的多选角色池[/]
[/list][list]
[][b]摄像机自动取景[/b] —— 视野距离会根据形态的体型缩放(巨大的 Boss 仍能完整入镜,小型杂兵不会被拉远)[/]
[/list][list]
[][b]完整的按键重绑定[/b],支持键盘 + 鼠标和手柄,包括连招动作[/]
[/list][list]
[][b]游戏内设置面板[/b](UMG、深色主题、支持手柄导航),无需编辑配置文件[/]
[/list][list]
[][b]实时重载配置[/b] —— 游戏运行时编辑文本文件;更改会在约 0.5 秒内生效[/]
[/list][list]
[][b]纯 Lua[/b] —— 无需额外 DLL,无需独立注入器,除 UE4SS 本身外无需任何东西[/]
[/list][line]
## 2. 需求


[list]
[][b]UE4SS[/b] 已安装并在此游戏上正常工作(Lua API)。推荐 3.x;较旧的版本会回退到较慢的异步计时器。[/]
[/list][list]
[][b]仅限单人 / 离线。[/b] 请勿在任何在线、合作或受反作弊保护的环境中使用。[/]
[/list][list]
[]Windows。游戏 UI 语言无关紧要:模组菜单支持 [b]中文和英文[/b](见 [i]招式设置 → 语言[/i])。[/]
[/list][line]
## 3. 安装


[list=1]
[]为游戏安装 [b]UE4SS[/b](如果你已经运行其他 UE4SS Lua 模组,跳过此步)。[/]
[/list][list=1]
[]复制
[code]VeilShift[/code]文件夹,使此文件存在:
即该文件夹放在 [b][code]Mods[/code] 内部[/b],而不是与它并列。[/
]
[/list][list=1]
[]启用它,任选一种方式:
[list]
[
]UE4SS 3.x:模组文件夹中自带的
[code]enabled.txt[/code]标记文件就足够了,或者[/]
[/list][list]
[
]在
[code]Mods\mods.txt[/code] 中添加一行:
[code]VeilShift : 1[/code],或者[/]
[/list][list]
[
]从你的 UE4SS 模组管理器中启用它。[/]
[/list][/
]
[/list][list=1]
[]启动游戏。打开
[code]Mods\VeilShift\VeilShift.log[/code]——最后一行应显示
[code][loaded] VeilShift 0.3.17 ...[/code]。[/
]
[/list][quote][b]设置文件不会随模组一起提供。[/b]
[code]VeilShift.txt[/code]会在你首次在游戏内菜单中更改设置并按下 [b]保存设置 / Save[/b] 时创建。它会被写入游戏的
[code]~mods[/code]文件夹:
[code]<Game>\ProjectPBZ\Content\Paks\~mods\VeilShift.txt[/code]如果找不到它,说明你还没有保存过设置——在此之前一切都使用默认值运行。[/quote][b]卸载:[/b] 删除
[code]VeilShift[/code]文件夹(可选删除
[code]Content\Paks\~mods\VeilShift.txt[/code])。没有运行时卸载,因此请 [b]重启游戏[/b]——模组自身的说明也是如此,这就是为什么 [b]F10[/b] 存在,作为“先把我还原”的按键。
[line]
## 4. 默认控制


[table][tr][td]动作[/td]
[td]键盘 / 鼠标[/td]
[td]手柄[/td]
[/tr]
[tr][td][b]变身 / 还原[/b][/td]
[td][code]4[/code][/td]
[td]菜单 / 选项按钮[/td]
[/tr]
[tr][td][b]打开设置菜单[/b][/td]
[td][code]F8[/code][/td]
[td]视图 / 触摸板按钮[/td]
[/tr]
[tr][td]将状态打印到日志[/td]
[td][code]F9[/code][/td]
[td]—[/td]
[/tr]
[tr][td][b]紧急还原(始终有效)[/b][/td]
[td][code]F10[/code][/td]
[td]—[/td]
[/tr]
[tr][td]轻击(连招阶段 1–5)[/td]
[td]鼠标左键[/td]
[td]X / □[/td]
[/tr]
[tr][td]重击(连招阶段 1–5)[/td]
[td][code]F[/code][/td]
[td]Y / △[/td]
[/tr]
[tr][td]抓取 / 处决[/td]
[td][code]E[/code][/td]
[td]B / ○[/td]
[/tr]
[tr][td]终极技[/td]
[td][code]Q[/code][/td]
[td]LT / L2[/td]
[/tr]
[tr][td]暗影武器[/td]
[td]左
[code]Ctrl[/code][/td]
[td]RT / R2[/td]
[/tr]
[tr][td]特殊技能 1[/td]
[td]鼠标左键 +
[code]F[/code][/td]
[td]LB + Y[/td]
[/tr]
[tr][td]特殊技能 2[/td]
[td]双击鼠标左键(220 毫秒窗口)[/td]
[td]LB + X[/td]
[/tr]
[tr][td]架势 / 格挡[/td]
[td]鼠标右键[/td]
[td]LB / L1[/td]
[/tr]
[tr][td]闪避[/td]
[td]左
[code]Shift[/code][/td]
[td]RB / R1[/td]
[/tr]
[/table]上面每一行都可以在菜单中重新绑定。只有 [b]菜单键[/b] 在更改后需要重启。
[line]
## 5. 游戏内菜单(F8)


一个停靠在右侧的深色面板,完全可以用键盘、鼠标或手柄导航。五个标签页:
变身 / Transform
[list]
[][b]固定变身角色[/b] —— 从可搜索的列表中选择一个固定形态(输入以按名称筛选),或保持为
[code]random[/code]。[/
]
[/list][list]
[][b]随机角色[/b] —— 复选框。开启时,下次变身会随机选择一个形态。[/]
[/list][list]
[][b]随机范围[/b] —— 随机池。可搜索多选;每次选择后列表 [b]不会[/b] 关闭,因此你可以勾选数十个形态。按钮:全选 / 清除全部。[/]
[/list][list]
[][b]变身移动速度倍率[/b] —— 0.25× 到 3×(默认 1.5×)。立即生效。[/]
[/list][list]
[][b]立即变身 / 还原主角 / 保存设置 / 恢复默认[/b]。[/]
[/list]招式 / Move settings
有趣的那个:[b]重新配置角色自身的招式槽位。[/b] 对于所选形态,你会得到六个组:
[table][tr][td]组[/td]
[td]可填充的槽位[/td]
[/tr]
[tr][td]轻击[/td]
[td]阶段 1 → 5[/td]
[/tr]
[tr][td]重击[/td]
[td]阶段 1 → 5[/td]
[/tr]
[tr][td]抓取 / 处决[/td]
[td]1 个槽位[/td]
[/tr]
[tr][td]终极技[/td]
[td]1 个槽位[/td]
[/tr]
[tr][td]暗影武器[/td]
[td]按下 / 按住 / 长按(3 个槽位)[/td]
[/tr]
[tr][td]特殊技能[/td]
[td]共享池:特殊 1 和特殊 2 从同一列表中选取[/td]
[/tr]
[/table]对于每个槽位,你从 [b]该角色[/b] 可用的招式(带有清理过的中文/英文名称)中选择,或构建一个最多 64 个招式的循环。你也可以在此处将页面语言在 [b]中文 / English[/b] 之间切换。
键盘 / Keyboard
点击一个绑定,然后直接按下按键或鼠标按钮。
[code]Esc[/code]取消,
[code]Delete[/code]清除绑定。
手柄 / Gamepad
控制器按钮同理,另有左摇杆 X/Y 轴交换和 [b]摇杆死区[/b](0 – 0.5,默认 0.12)。
说明 / Notes
内置速查表:哪些立即生效、哪些在下次变身时生效、哪些需要重启。
[b]生效时机规则[/b]
[list]
[][b]立即:[/b] 移动倍率、手柄轴/死区、战斗绑定[/]
[/list][list]
[][b]下次变身:[/b] 所选形态、随机角色列表、随机池[/]
[/list][list]
[][b]重启:[/b] 菜单键[/]
[/list][list]
[][b]务必按下 保存设置 / Save[/b] —— 否则不会写入磁盘[/]
[/list][line]
## 6. 配置文件


[b]位置:[/b]
[code]<Game>\ProjectPBZ\Content\Paks\~mods\VeilShift.txt[/code][b]格式:[/b] 纯
[code]key=value[/code],每行一个。没有代码,没有脚本——文件会逐字段验证,未知或无效的行会被忽略并记录日志警告。[b]重载:[/b] 每 0.5 秒轮询一次。编辑 → 保存 → 完成,无需重启(
[code]menu_key[/code] 除外)。
新文件如下所示(这些是默认值):
逐角色招式覆盖会附加为:
[code]<slot>[/code]是以下之一
[code]lightA lightAA lightAAA lightAAAA lightAAAAA heavyB heavyBB heavyBBB heavyBBBB heavyBBBBB execution combatArtPress shachiPress shachiHold shachiPressLong[/code];
[code]<moveIndex>[/code]是该形态招式列表中的从 1 开始的索引。省略条目会保留内置默认值——你永远不必手动编写这些,菜单会为你完成。
注意事项:
[list]
[]按键名称是 Unreal 按键名称(
[code]Four[/code]、
[code]F8[/code]、
[code]LeftMouseButton[/code]、
[code]Gamepad_FaceButton_Top[/code] 等)。[/
]
[/list][list]
[]空值 = 未绑定(该招式随后遵循游戏自身的绑定,或被禁用)。[/]
[/list][list]
[][code]pad_toggle[/code]是旧版的单个手柄变身/还原键;较新的菜单会分别写入
[code]pad_transform[/code]+
[code]pad_exit[/code]。旧文件仍然可用。[/
]
[/list][list]
[]0.3 之前版本的
[code]settings.ini[/code]如果位于
[code]main.lua[/code]旁边,且
[code]VeilShift.txt[/code]尚不存在,则会作为回退读取一次。[/
]
[/list][line]
## 7. 游戏内行为


[list]
[][b]进入[/b] 大约需要一帧加上该形态的首次资源加载(缓存后通常为几十毫秒)。[/]
[/list][list]
[][b]战斗是原生的。[/b] 技能使用你角色的镜像输出属性;当攻击未命中时,模组绝不会添加“虚假伤害”。[/]
[/list][list]
[][b]你的生命值是真实的。[/b] 变身不会给你额外的生命值或护甲:来自敌人的伤害仍在你自己的角色上结算,可见的代理被排除在伤害管线之外,因此它永远不会成为第二条生命条。[/]
[/list][list]
[][b]形态上的敌人 AI 被禁用[/b] —— 你保持完全的手动控制;形态不会自行战斗。[/]
[/list][list]
[]属于该形态的 [b]武器[/b] 会被拾取、绑定并隐藏,以免穿模;退出时会恢复。[/]
[/list][list]
[][b]HUD[/b] 会在变身之前捕获并在之后恢复,包括其业务入口状态。[/]
[/list][list]
[][b]摄像机[/b] 距离会根据形态的包围盒重新计算;巨大的 Boss 会自动获得额外距离。[/]
[/list][b]已知限制[/b]
[list]
[]某些形态的技能是为 AI 使用而编写的。当玩家使用时,它们可能会未命中、异常命中,或没有受击者动画。[/]
[/list][list]
[]非常大的 Boss 在狭窄走廊中仍可能穿墙/穿摄像机;请手动调整摄像机或再次变身。[/]
[/list][list]
[]在游戏暂停 / 过场动画期间变身会将加载排队,直到游戏恢复(日志显示
[code][waiting] game paused[/code])。[/
]
[/list][list]
[]只会触及玩家 Pawn。其他替换玩家 Pawn、HUD 或输入绑定的模组可能会冲突。[/]
[/list][list]
[]未与其他也为玩家生成 Actor 的 UE4SS 模组一起测试;如果两个模组争抢 Pawn,请禁用其中一个。[/]
[/list][list]
[]没有专门的“即时卸载”:先还原,然后重启游戏。[/]
[/list][line]
## 8. 故障排除


[table][tr][td]症状[/td]
[td]处理方法[/td]
[/tr]
[tr][td]按下
[code]4[/code] 时没有任何反应[/td]
[td]检查
[code]VeilShift.log[/code] 中是否有
[code][loaded][/code]。没有 → 模组未启用(mods.txt / enabled.txt / 文件夹层级错误)。[/td]
[/tr]
[tr][td]日志显示
[code][waiting] game paused[/code][/td]
[td]回到游戏玩法中(取消暂停),加载会自行恢复。[/td]
[/tr]
[tr][td]日志显示
[code][not_ready][/code][/td]
[td]你处于菜单/过场动画/加载界面中;请在游戏玩法中重试。[/td]
[/tr]
[tr][td][code][not_ready] 随机角色池为空[/code][/td]
[td]打开 F8 → 变身 → 随机范围,勾选至少一个形态,保存。[/td]
[/tr]
[tr][td]菜单无法打开[/td]
[td]默认是
[code]F8[/code]。如果你更改了
[code]menu_key[/code],请 [b]重启游戏[/b]。[/td]
[/tr]
[tr][td]角色卡在 Boss 形态,HUD 丢失[/td]
[td]按 [b]F10[/b] —— 紧急还原。然后检查日志中是否有
[code][restore_failed][/code]/
[code][hud_restore_failed][/code]。[/td]
[/tr]
[tr][td]变身时短暂卡顿[/td]
[td]该形态的首次资源加载。重复变身会被缓存。[/td]
[/tr]
[tr][td]形态看起来不对 / T-pose[/td]
[td]该形态的动画蓝图可能依赖仅 AI 的状态;选择另一个形态或附上日志行报告。[/td]
[/tr]
[tr][td]设置未生效[/td]
[td]你必须按下 [b]保存设置[/b];并注意哪些设置是“下次变身”或“重启”。[/td]
[/tr]
[tr][td]随机形态不断重复[/td]
[td]检查随机池:空池或只勾选了一个形态时会出现这种情况。[/td]
[/tr]
[/table][b]日志:[/b]
[code]Mods\VeilShift\VeilShift.log[/code]—— 人类可读,可安全附加到错误报告中。它包含
[code][loaded][/code]、
[code][entered][/code]、
[code][restored][/code]、计时以及任何失败的步骤。
[line]
## 9. 备注 / 致谢


[list]
[]完全使用 [b]UE4SS Lua + 原生 UMG[/b] 构建。没有 JavaScript 求值,没有外部进程,没有捆绑 DLL。[/]
[/list][list]
[]设置 UI 外壳是一个共享的 UE4SS Lua/UMG 菜单模块;VeilShift 只注册自己的页面,不会修改其他模组的包。[/]
[/list][list]
[]模组创建的所有内容都会被跟踪并在还原时回滚;不会向你的存档文件写入任何内容。[/]
[/list][list]
[]与任何脚本模组一样,使用任何变身模组前请 [b]备份你的存档[/b]。[/]
[/list][list]
[]请勿重新上传/重新打包。欢迎错误报告——请附上
[code]VeilShift.log[/code]以及你当时在做什么。[/
]
[/list][line]