原生PS5手柄UI

概述

原生 PS5 控制器 UI 是一个基于轻量级脚本的模组，可在不替换原始界面文件的情况下启用游戏内置的 PlayStation 5 控制器按键提示。

与传统的 PS4/PS5 UI 替换模组不同，此模组不使用大型 UI 包、预编译脚本或修改过的游戏界面资源。

相反，它利用游戏现有的 PS5 控制器支持来显示原生 PlayStation 按键图标，同时保持原始界面完整。

专为希望获得 PS5 按键提示而不牺牲 HUD 模组兼容性的玩家而设计。

特性

• 原生 PS5 按键提示 — 使用游戏内置的 PlayStation 5 控制器图标。
• 轻量级脚本解决方案 — 无需不必要的 UI 替换或额外资源。
• 无缝自适应 HUD 兼容性 — 已成功与 Seamless Adaptive HUD 一起测试。
• 最少的脚本修改 — 使用 @wrapMethod 而非替换整个输入管理器脚本。
• 保留原始 UI — 不覆盖 HUD 界面包或预编译脚本。
• 键盘和鼠标支持 — 保留键盘和鼠标检测。
• 易于安装 — 只需将一个文件夹复制到游戏的模组目录中。

兼容性

游戏： The Witcher 3: Wild Hunt — 次世代 / 重制版 目标版本： 5.1 模组版本： 1.0.0

已测试兼容性

• Seamless Adaptive HUD — 正常工作

原始测试版本已在启用 Seamless Adaptive HUD 的情况下成功测试。PS5 按键提示和自适应 HUD 功能同时正常工作。

重命名后的 v1.0.0 版本使用相同的底层脚本逻辑。

潜在冲突

避免使用其他强制 PlayStation 按键提示或替换控制器检测脚本的模组。

其他修改相同输入检测方法的模组可能导致冲突或需要额外的兼容性测试。

不保证与所有 HUD 或控制器模组兼容。

安装

1. 下载模组。
2. 解压压缩包。
3. 将 modNativePS5ControllerUI 文件夹复制到游戏的 mods 目录中。
4. 启动 The Witcher 3。

安装路径： The Witcher 3/mods/modNativePS5ControllerUI/

重要： 安装前请移除之前的 PS4/PS5 UI 替换模组，以避免潜在冲突。

卸载

只需从游戏的 mods 目录中删除 modNativePS5ControllerUI 文件夹即可。

此模组不会修改存档数据。

工作原理

原生 PS5 控制器 UI 使用轻量级脚本包装器将支持的控制器检测结果重定向到游戏的原生 PS5 输入类型。

它不替换整个 inputManager.ws 文件，仅修改所需的检测行为。

此模组不替换 CR4ScriptedHud.OnTick 、不注入自定义 Flash UI 文件，也不包含 precompiled.rsblob 替换。

这最大限度地减少了不必要的修改，并降低了与其他 UI 和 HUD 模组发生潜在冲突的可能性。

限制

• 不添加自适应扳机支持或高级 DualSense 触觉反馈。
• 依赖游戏现有的 PS5 按键图标资源。
• 某些界面元素可能依赖游戏原生支持。
• 不保证与其他控制器检测模组的兼容性。
• 最终发布包应在公开发布前进行游戏内验证。

更新日志

版本 1.0.0 — 初始发布

• 原生 PS5 控制器 UI 检测。
• 轻量级 @wrapMethod 实现。
• 保留键盘和鼠标检测。
• 无外部 UI 包或预编译脚本替换。
• 使用原始测试构建与 Seamless Adaptive HUD 一起测试。
• 更新命名并清理发布包。

致谢

作为传统 PlayStation UI 替换模组的轻量级替代方案创建，专注于兼容性和最少的修改。

特别感谢 The Witcher 3 模组社区。