
PBZ-框架菜单
面向模组的“统一设置中心”,为《影之刃零》模组生态系统提供一个标准化、安全且功能完备的“游戏内菜单框架”。它对开发者友好,入门门槛极低。
查看大图[size=4][b][color=#c8a44d]PBZ-Framework Menu[/color] — 《影之刃零》游戏内模组菜单框架[/b][/size]
一个秉承 Skyrim 的 [url=https://github.com/QTR-Modding/SKSE-Menu-Framework-3]SKSE Menu Framework 3[/url] 理念的菜单框架,专为 [url=https://www.nexusmods.com/phantombladezero]《影之刃零》[/url](UE 5.7)打造,采用 UE4SS C++ DLL 模组形式。它为模组提供一个可用热键唤出的游戏内设置界面——包含每个模组的独立页面、按键重绑定、主题和多语言——全部可在同一个统一界面中编辑。
[b]亮点[/b]
[list]
[][b]一个热键,管理所有模组[/b] — 按 [b]F8[/b](可配置)打开菜单;Esc 或 F8 关闭。每个已注册的模组都会在侧边栏中显示为独立分区。[/]
[][b]统一设置与按键重绑定[/b] — 复选框、滑块、下拉菜单、文本字段、颜色选择器和[b]游戏内按键捕获[/b]。配置由框架保存;模组读取这些配置。已在游戏内测试:通过此菜单重绑定 PBZPhotoMode 的按键。[/]
[][b]分类树侧边栏[/b] — 模组可声明嵌套分类(如 "My Mod/Freeze Mode");可折叠,带会话记忆和侧边栏搜索。[/]
[][b]截图友好[/b] — 菜单打开时相机被冻结。穿透模式(默认 [b]Ctrl+P / Alt+F1[/b],按两次)可让你的截图工具(PixPin、NVIDIA Overlay 等)捕获冻结画面;设置页还内置截图按钮,可将 PNG 保存到 [b]Screenshots\[/b]。[/]
[][b]主题[/b] — 随附与游戏 HUD 相配的墨金主题(深色底、细银边框、金色高亮、朱砂点缀)。可通过 [b]themes\<name>.json[/b] 自定义主题,在设置中选择。[/]
[][b]4 种语言,可热切换[/b] — 简体中文 / English / 日本語 / 한국어。[/]
[][b]模组作者 API[/b] — 零依赖 C 头文件,任何 UE4SS C++ DLL 模组都可注册分区、设置页、自定义绘制页面、热键和纹理。见下文。[/]
[/list][b]为何对你的游戏安全(架构)[/b]
菜单是一个[b]独立的 DirectComposition 覆盖窗口[/b],拥有自己私有的 D3D11 设备和 ImGui 1.92。它[b]从不接触游戏的交换链或 D3D 对象[/b]——没有 Present 钩子,不涉及引擎内部——因此可与 [b]FSR3 帧生成和 NVIDIA Streamline[/b] 安全共存,也兼容游戏自定义的 Shipping 引擎。输入通过低级钩子处理:菜单打开时游戏相机被冻结,所有键盘/鼠标输入都会馈送给菜单;关闭后立即恢复一切。已在 2560x1440、开启 FSR3 帧生成的情况下于游戏内验证,并确认可与 PBZPhotoMode 共存(同一会话中 F2 拍照模式 + F8 菜单)。
[b]面向模组作者(C API / SDK)[/b]
包含 [b]pbzfm.h[/b](随下载包提供,位于 [b]PBZFM/sdk/[/b])——唯一的外部头文件是 [b]windows.h[/b];所有函数在运行时通过 GetProcAddress 解析,无需导入库,也无需捆绑 ImGui。
[list]
[][b]ABI 稳定性[/b] — 必需核心加可选导出:旧头文件在新框架版本上仍可工作;新导出在旧版本上会退化为 NULL。已发布的导出名称和签名永不再变。[/]
[][b]分区与嵌套分类[/b] — 一次调用即可声明如 "My Mod/Sub Page" 的树;侧边栏会自动渲染该树。[/]
[][b]模式化设置页[/b] — bool/int/float/text/enum/键盘/组合键控件、变更回调、由框架管理的每模组 JSON 存储。[/]
[][b]热键[/b] — 单键和修饰键组合,即使菜单打开时也能送达。[/]
[][b]菜单事件、纹理、i18n[/b] — 渲染线程上的打开/关闭事件、stb_image 纹理加载,以及通过框架语言表进行标签查找(回退:纯文本)。[/]
[/list]完整指南和可编译的参考实现([b]demo_mod.cpp[/b])均在下载包中。
[b]要求[/b]
[list=1]
[][url=https://www.nexusmods.com/phantombladezero/mods/5]UE4SS for PBZ[/url](KintaroModding fork)——请先安装它。[/]
[]本模组,用模组管理器或手动安装(见下文)。[/]
[/list][b]安装[/b]
[list=1]
[]安装 [url=https://www.nexusmods.com/phantombladezero/mods/5]UE4SS for PBZ[/url]。[/]
[]用模组管理器安装本模组的 zip,或解压以得到:
[code]<game>\platform\steam\ue4ss\Mods\PBZFM\dlls\PBZFM.dll
<game>\platform\steam\ue4ss\Mods\PBZFM\enabled.txt[/code][/]
[]启动游戏并按 [b]F8[/b]。[/]
[/list]卸载:删除 [b]PBZFM[/b] 文件夹。绝不修改任何游戏文件。
[b]故障排除[/b]
首先检查 [b]Documents\PBZ\Logs\PBZFM.log[/b] 中的日志(自动创建;若 Documents 不可写则回退到 [b]ue4ss\Mods\PBZFM\PBZFM.log[/b])。在 UE4SS.log 中,你应看不到任何 PBZFM 警告。
[b]已知限制[/b]
[list]
[]游戏手柄导航已开发,但应作者要求暂时搁置——不包含在当前包中。[/]
[]截图穿透是"两次按压"设计:第一次按压打开借用窗口,第二次真实按压触发你的工具(PixPin / NVIDIA overlay 会忽略注入的按键)。[/]
[]尚未验证:真正的独占全屏、多显示器、HDR、Steam Overlay。[/]
[/list][b]许可与致谢[/b]
MIT 许可。SDK 头文件对客户端模组[b]零义务[/b]——包含它并在运行时与 PBZFM.dll 通信不会使你的模组成为衍生作品;你可随意为其授权。
致谢:[url=https://github.com/ocornut/imgui]Dear ImGui[/url]、[url=https://github.com/nothings/stb]stb_image[/url]、[url=https://github.com/KintaroModding/UE4SS-RE-RE-for-Atsors-PBZ]UE4SS for PBZ[/url],以及 [url=https://github.com/lin-414/PBZPhotoMode]PBZPhotoMode[/url],其经实地验证的发现塑造了本覆盖层方案。灵感来自 SKSE Menu Framework 3。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。