Phantom Blade Zero 生命值 音乐 内置音频播放器 模组

Phantom Blade Zero 生命值 音乐 内置音频播放器 模组

让你的《Phantom Blade Zero》在生命值低于特定阈值时自动播放音乐。

描述
-----------

半血时,战斗主题曲响起。濒死时,绝望曲目奏响。死亡时,音乐在15秒后戛然而止。

血量触发BGM为你的《影之刃零》流程增添一层戏剧色彩。它实时监测你角色的血量,并在你跨越血量阈值时播放你自己的歌曲,随后在你回满血时自动停止。

它不会从屏幕上采样血条。它通过UE4SS读取实际的GameplayAbilitySystem属性(来自CharacterBasics.BasicAttributeSet的Health和Health_Max),因此绝不会因分辨率、画质设置或HUD可见性而受到干扰。

该模组由两部分组成:一个每200毫秒读取一次血量、并在跨越阈值时写入一个微型状态文件的Lua脚本,以及一个监视该文件并播放匹配歌曲的隐藏后台播放器。播放器以隐藏窗口运行,因此绝不会有控制台窗口在游戏上方弹出。

每首歌曲、音量和阈值都放在一个纯文本配置文件中。保存文件后改动立即生效——无需重启游戏,无需重启播放器。游戏中按F3可随时开启或关闭全部功能。

这是一个独立模组。它不会修改或与其他任何模组冲突。


安装说明
-------------------------

1. 将压缩包解压到任意位置。
2. 从包根目录运行安装批处理文件(名为 安装.bat)。它会
  定位你的游戏文件夹,复制文件,启动后台播放器并
  注册一个启动快捷方式。
3. 运行歌曲编辑批处理文件(编辑歌单.bat),填入你的歌曲路径并
  保存。
4. 启动游戏。

设置你的歌曲——用任意文本编辑器打开 mod-config.ini:

    half=F:\Music\song1.mp3      在46% - 80%血量时播放
    quarter=F:\Music\song2.mp3    在1%  - 45%血量时播放
    death=F:\Music\song3.mp3      死亡时播放

支持的格式为Windows能解码的任何格式:mp3、wav、m4a、flac、wma。
路径可以包含空格和非ASCII字符。留空某一行即可让
该阶段保持静音。

手动安装——将Mods\pbz-health-bgm文件夹复制到
<GameFolder>\platform\steam\ue4ss\Mods\pbz-health-bgm,确保其中存在
enabled.txt,然后运行player\start-hidden.vbs启动播放器。

卸载——运行 卸载.bat。它会移除游戏内模组文件夹、启动
快捷方式并终止后台播放器。


主要功能
-------------

基于血量的阶段

    满血        停止播放
    血量 81% -  99%  无(故意设置的静音间隔)
    血量 46% -  80%  歌曲 1
    血量 1%  -  45%  歌曲 2
    死亡              歌曲 3

每个阶段在你进入它的那一刻触发一次,且从不循环。离开某阶段再
掉回该阶段,它会再次触发。所有边界均可配置。

满血时自动停止——当血量回到满血线
(默认99.5%,带0.5%容差,以防整数血量取整
破坏它)时,播放停止,所有阶段重新待命,等待下一次下降。

限时死亡音乐——死亡曲目播放15秒后
被切断,无论文件长度如何。若在计时器到期前复活,会立即
停止并取消计时器。时长可配置;0表示无
限制。

F3开/关切换——游戏中按F3启用或禁用整个模组。
禁用会立即停止播放并抑制所有事件。重新启用
会重新待命所有阶段,因此禁用期间的内容不会延迟重播。

完美弹反与完美闪避音效(可选)——为完美弹反和
完美闪避分配一个短音效。普通格挡和普通翻滚保持
静音。音效使用独立的播放器实例,因此绝不会切断
背景音乐。

检测分为两级:技能名称片段(必需)加上可选的
动画/蒙太奇名称片段。第二级存在的原因是完美与
普通变体通常共用同一技能,仅在动画
片段上不同,因此单靠技能名称无法区分它们。

此部分需要一次性校准。设置discover=yes,在游戏中执行一次普通
格挡、一次完美弹反、一次普通闪避和一次完美闪避,然后读取
mod.log。每次激活都会连同其技能名称和动画名称记录在日志中。
比较每一对的条目:如果技能名称不同,填入
xxx_ability;如果只有动画不同,则还需填入xxx_montage。然后
将discover设回no。

实时配置重载——编辑mod-config.ini并保存。无需重启游戏,无需重启
播放器。

内置诊断——每个有意义的事件都会写入mod.log,包括
真实血量百分比,以及某阶段未配置歌曲时的明确说明,
因此静音绝不会看起来像是模组坏了。

性能——所有逻辑都在游戏线程上运行,因此经过了仔细调优。
PlayerController只解析一次并缓存;每帧只读取其Pawn字段,
因为在此构建版本上GetPlayer()会遍历整个UObject数组,是
最容易被忽视的掉帧来源。StaticFindObject、
AbilitySystemComponent和AttributeSet均已缓存。轮询间隔为200毫秒,而非
每帧。死亡检查仅在血量已经很低时运行。在
500次模拟tick中实测:恰好1次完整对象数组遍历和2次StaticFindObject
调用。

注意事项与限制

  - 阶段仅在向下跨越时触发。如果单次攻击将你从
    100%带过两个阶段,只会播放你最终落入的阶段;被跳过的阶段
    不会追溯播放。
  - 如果血量未达到满血线,自动停止不会触发。
    调低full_ratio以更改阈值。
  - 完美弹反与完美闪避音效在校准前为静音。
  - 这些音效带有约0.2至0.4秒的延迟:Lua
    侧每200毫秒轮询一次,播放器每100毫秒轮询一次状态文件,再加上
    音频解码器启动时间。它们作为额外一层,而非替代
    游戏自身的打击音效。零延迟需要钩住
    游戏的音频回调,而纯Lua加播放器的模组无法做到。
  - 如果游戏未将这些动作实现为GameplayAbility,
    发现模式将找不到任何内容,该功能无法使用。


需求
------------

必需

  - Phantom Blade Zero(Steam AppID 4115450)
  - UE4SS,正确安装。以下两者都必须存在于
    <GameFolder>\platform\steam\ 下:
        dwmapi.dll
        ue4ss\UE4SS.dll
    如果任一缺失,模组将永远不会加载,mod.log也不会出现。
  - Windows 10 或 Windows 11
  - Windows PowerShell 5.1(随Windows自带,无需安装)
  - Windows已能解码的任何格式的音频文件

非必需

  - 无需管理员权限
  - 无需Python,无需额外.NET运行时,无第三方组件
  - 不修改任何游戏文件

你必须自己提供音乐。该模组不附带任何音频,因为
受版权保护的曲目无法重新分发。

兼容性——独立模组,因此不会触碰其他模组的文件,可与
其他UE4SS模组共存。血量读取自
CharacterBasics.BasicAttributeSet;如果重大游戏更新重命名了
该属性集,请编辑
Scripts\main.lua顶部的ATTR_SET_CLASS常量。完美弹反与闪避检测依赖于游戏的
GameplayAbility和动画名称,因此游戏更新可能需要
使用发现模式重新校准。


致谢
----------

UE4SS-RE团队——没有UE4SS,这一切都不会存在。
https://github.com/UE4SS-RE/RE-UE4SS

pbz-custom-accessory-effects的作者——该模组的血量与玩家
查找直接仿照了那个模组,以及那条关键的性能
教训:在此构建版本上GetPlayer()会遍历整个对象数组,必须
缓存。没有它,弄清这个引擎设置会花费长得多的时间。

启发本模组的原始血量触发模组的作者。这个
版本在该理念基础上构建,没有常驻控制台窗口,用血量阶段
代替单一触发,满血自动停止,死亡曲目限时,
且一切皆可配置。

所有提供反馈并测试早期版本的人。