PBZ快速武器切换 - 可配置(UE4SS)

PBZ快速武器切换 - 可配置(UE4SS)

独立UE4SS模组:可配置的武器切换冷却时间(默认0.9秒),同时保留原生HUD切换动画。无需编辑存档,无需修补EXE。

[size=5][b]影之刃零 · 快速切换武器 / Phantom Blade Zero — Fast Weapon Swap[/b][/size]

[size=3]基于 UE4SS 的独立切武冷却模组:把切换武器冷却压到可配置秒数(默认 0.9 秒),保留原生 HUD 切换动画,不写存档、不改 EXE、不碰机器码。

已验证游戏版本:UE 5.7.4 / CL-302256(2026-11-04 更新的 v1.0)[/size]

[size=4][b]功能 Features[/b][/size]
[list]
[]切换武器后只等待可配置冷却(默认 0.9 秒)[/]
[]通过游戏自身 UE 反射接口实现,不修改 EXE / 机器码[/]
[]切换动画播完才清冷却,保留右下角武器图标切换动画[/]
[]不写存档、不改武器伤害 / 其它技能冷却[/]
[]游戏内热键开关与重载配置,日志可查[/]
[/list]
[size=4][b]前置要求 Requirements[/b][/size]
[list]
[]已安装《影之刃零》专用 UE4SS:(GameDir)\platform\steam\ue4ss\UE4SS.dll[/]
[]仅单人离线使用[/]
[/list]
[size=4][b]安装 Installation[/b][/size]
[list=1]
[]下载 pbz-fast-weapon-swap-v1.1.zip[/]
[]解压得到 pbz-fast-weapon-swap 文件夹[/]
[]放到 (GameDir)\platform\steam\ue4ss\Mods\pbz-fast-weapon-swap\[/]
[]启动游戏,切换武器测试;日志在 Mods\pbz-fast-weapon-swap\weapon_swap_log.txt[/]
[/list]
[size=4][b]配置 Configuration[/b][/size]
编辑 Mods\pbz-fast-weapon-swap\config.txt,保存后游戏内按 Ctrl+F6 重新读取:
[list]
[][b]enabled = true[/b] — 总开关(也可用 Ctrl+F5 切换)[/]
[][b]cooldown_seconds = 0.9[/b] — 切换后多久清冷却(秒),即实际冷却时间;推荐 0.9,可调 0.5-1.5。不要低于 0.5,太低可能打断 HUD 武器图标切换动画[/]
[][b]poll_interval_ms = 250[/b] — 仅用于发现玩家武器组件的轮询间隔(修改后需重启游戏)[/]
[][b]log = true[/b] — 是否写日志[/]
[][b]debug = false[/b] — 详细日志(排查用)[/]
[/list]
[size=4][b]热键 Hotkeys[/b][/size]
[list]
[][b]Ctrl+F6[/b] — 重新读取 config.txt[/]
[][b]Ctrl+F5[/b] — 临时开启 / 关闭模组[/]
[/list]
[size=4][b]实现原理 How it works[/b][/size]
原修改器用 Cheat Engine 代码补丁直接改切换武器冷却计算。本模组不碰 EXE,而是调用游戏暴露的 UE 反射接口:
[list]
[][b]/Script/SGameCombatSystem.CharacterWeaponsComponent:StartChangeWeaponCooldown[/b] — 切换武器开始进入冷却时触发[/]
[][b]...:GetCurrentChangeWeaponCooldown[/b] — 读取当前剩余冷却[/]
[][b]...:ResetChangeWeaponCooldowns[/b] — 游戏自带的清零切换武器冷却函数[/]
[/list]模组在冷却开始后按 cooldown_seconds 延迟一次清冷却:等 HUD 切换动画播完再清,不会出现“武器切了、右下角图标不换位置”的问题。

[size=4][b]排查 Troubleshooting[/b][/size]
日志:Mods\pbz-fast-weapon-swap\weapon_swap_log.txt。正常应包含:
[code]已挂钩 StartChangeWeaponCooldown ...
已挂钩 GetCurrentChangeWeaponCooldown ...
切换武器冷却 Hook 已就绪
找到玩家武器组件: ...[/code]如果只有“已加载”而没有“已挂钩”,说明游戏更新改了类路径,请把日志发到评论区。

[size=4][b]注意 Notes[/b][/size]
[list]
[]只影响切换武器冷却,不改武器伤害 / 其它技能冷却[/]
[]模组只会把剩余冷却提前清零,不会延长原版冷却[/]
[]不写存档;卸载直接删除 pbz-fast-weapon-swap 文件夹即可[/]
[]单人离线使用[/]
[/list]
[size=4][b]更新日志 Changelog[/b][/size]
[list]
[][b]v1.1[/b] — 修复“切换武器后右下角武器图标不换位置”:清冷却改为切换后延迟一次(默认 0.9s),移除轮询 / 查询时的反复清零,保留 HUD 切换动画[/]
[][b]v1.0[/b] — 首个发布版,基于原修改器机制重写为独立 UE4SS 模组[/]
[/list]
[size=4][b]English[/b][/size]
A standalone UE4SS mod that lowers the weapon-switch cooldown to a configurable value (0.9s by default) while keeping the native HUD swap animation. No save edits, no EXE patching, no memory patching.

[b]Features:[/b] configurable cooldown after each weapon swap; implemented through the game's own UE reflection API; the cooldown is cleared only after the swap animation finishes; no damage or other cooldown changes; in-game hotkeys.

[b]Requirements:[/b] Phantom Blade Zero with the PBZ UE4SS mod loader installed: (GameDir)\platform\steam\ue4ss\UE4SS.dll

[b]Installation:[/b] extract the pbz-fast-weapon-swap folder into (GameDir)\platform\steam\ue4ss\Mods\pbz-fast-weapon-swap\

[b]Configuration:[/b] edit config.txt (cooldown_seconds = 0.9 by default), then press Ctrl+F6 in game.

[b]Notes:[/b] single-player / offline only. Uninstall by deleting the folder.