海盗王帽子HUD

海盗王帽子HUD

海盗帽 HUD 是一个 ASI 模组,当海盗王帽检测到附近有宝藏时,会显示一个宝箱图标并播放简短的警报声

[size=4][b]描述[/b][/size]

当海盗王帽子检测到附近有宝藏时,会添加一个小宝箱图标和一段短促音效。如果你在隐藏头盔的情况下游玩,看不到帽子原本的提示,这个模组会很有用。

必须装备海盗王帽子。你可以调整图标的位置和大小、更改通知音量,或使用你自己的图标和音效。

源代码和问题反馈:[url=https://github.com/Kryptesa/PirateHatHUD]GitHub 仓库[/url]。

[size=4][b]安装说明[/b][/size]

[b]使用 [url=https://github.com/faisalkindi/CrimsonDesert-UltimateModsManager]CDUMM(Crimson Desert Ultimate Mods Manager)[/url] 或 [url=https://www.nexusmods.com/crimsondesert/mods/633]DMM(Definitive Mod Manager)[/url]:[/b]

1. 关闭游戏。
2. 将下载的 PirateHatHUD ZIP 拖入管理器。
3. 在 ASI 页面启用 Pirate Hat HUD,并确保 ASI 加载器已启用。
4. 启动游戏,加载存档,并在宝藏附近使用海盗王帽子。

[b]使用其他兼容的 ASI 加载器:[/b]

1. 关闭游戏并解压压缩包。
2. 将 PirateHatHUD.asi 和 PirateHatHUD.ini 一起放入 bin64 文件夹。
3. 启动游戏。

默认图标和音效已内置;无需单独的 PNG 或 WAV 文件。

要更改设置,请编辑 ASI 旁边的 PirateHatHUD.ini。大多数更改需要重启游戏。[sound] volume_percent 的更改在保存后约一秒内生效,无需重启。

更新时,请备份你的 INI,并避免安装第二份 ASI。对于 CDUMM 或 DMM,请在游戏关闭的情况下先启用现有模组,再导入更新。

[size=4][b]主要功能[/b][/size]

[list]
[][b]宝藏指示器:[/b]海盗王帽子检测到宝藏时显示宝箱图标。[/]
[][b]声音通知:[/b]检测变为激活时播放一次短促提示音。[/]
[][b]HUD 可见性:[/b]图标会随小地图隐藏,在菜单中隐藏,以及在对话或过场动画期间因游戏的小地图绘制状态而隐藏。它会在可配置的延迟后返回,默认一秒。[/]
[][b]音频控制:[/b]通知音量受游戏总音量、音效音量以及 PirateHatHUD.ini 中的 [sound] volume_percent 控制。该配置设置会额外应用一个 0 到 100 百分比的乘数:100 保持游戏滑块设定的音量,50 使声音振幅减半,0 则静音。将任一游戏滑块设为零也会使通知静音。保存配置音量更改即可无需重启生效。声音也可以独立于图标禁用。[/]
[][b]安静的菜单切换:[/b]在菜单中、小地图隐藏时、模组禁用时以及游戏失去焦点时,提示音会被抑制。[/]
[][b]自定义:[/b]可调整图标位置、大小、返回延迟和声音冷却时间。ASI 旁边可选的 PirateHatHUD_treasure.png 和 PirateHatHUD_treasure.wav 文件会替换内置资源。自定义声音必须为单声道或立体声 PCM WAV,8 位或 16 位,8-192 kHz,最大 8 MiB。请手动安装自定义资源,并在更改这些文件后重启。[/]
[][b]热键:[/b]F9 切换图标和声音;F10 停止当前会话的模组。两个按键均可在 INI 中重新分配。[/]
[][b]显示支持:[/b]SDR、scRGB 和 HDR10 输出。[/]
[/list]
[size=4][b]要求[/b][/size]

[list]
[]兼容的 ASI 加载器。[url=https://github.com/faisalkindi/CrimsonDesert-UltimateModsManager]CDUMM[/url] 和 [url=https://www.nexusmods.com/crimsondesert/mods/633]DMM[/url] 提供模组安装和 ASI 加载器管理。[/]
[]必须装备海盗王帽子才能获得宝藏通知。若要仅检查图标设置,请设置 [indicator] force_show=1;这仍需要可见的小地图和关闭的菜单,且不会触发声音。[/]
[/list] UI 布局已针对游戏版本 2.03.02 进行检查。游戏更新可能需要模组更新。

[size=4][b]问题反馈和故障排除[/b][/size]

请在 Nexus 的 Bugs 标签页报告问题,或在 [url=https://github.com/Kryptesa/PirateHatHUD/issues]GitHub[/url] 上提交 issue。请包含复现问题的步骤、你的预期以及实际发生的情况。

模组会将日志保存在 PirateHatHUD.asi 旁边,名为 PirateHatHUD_*.log(使用 CDUMM 或 DMM 时通常在游戏的 bin64 文件夹中)。要捕获更多详细信息:

1. 打开 ASI 旁边的 PirateHatHUD.ini,将 [logging] 下的 level 改为 debug:

[code]
[logging]
level=debug[/code]
2. 保存文件,重启游戏并复现问题。
3. 附上该会话最新的日志、你的 INI、模组和游戏版本、你的 ASI 加载器以及任何其他已安装的模组。包括 HDR、DLSS 和帧生成等图形设置;截图或短视频也有帮助。
4. 之后,将 level 设为 info 并重启以恢复正常日志记录。

日志会自动轮换:默认情况下,模组保留三个文件,每个最多 5 MB。在再次启动游戏前复制相关日志,以免它们被轮换删除。如果没有创建日志,请在报告中说明,并检查模组和 ASI 加载器是否已启用。

如果图标从未出现,请尝试 [indicator] force_show=1,重启,加载存档,确保小地图可见,关闭菜单并等待一秒。这可以在不需要附近宝藏的情况下检查叠加层。之后将其设回 0;正常检测需要装备海盗王帽子。

[size=4][b]致谢[/b][/size]

[list]
[][url=https://icons8.com/]Icons8[/url] 提供图标。[/]
[]Roy's Noise 提供 "Subscribe alert - metal dings",来源于 [url=https://uppbeat.io/]Uppbeat[/url]。[/]
[][url=https://github.com/cursey/safetyhook]SafetyHook[/url]、[url=https://github.com/zyantific/zydis]Zydis[/url] 和 [url=https://github.com/ocornut/imgui]Dear ImGui[/url] 的开发者提供模组使用的库。[/]
[][url=https://github.com/faisalkindi/CrimsonDesert-UltimateModsManager]CDUMM[/url] 和 [url=https://www.nexusmods.com/crimsondesert/mods/633]DMM[/url] 的开发者提供模组管理器和 ASI 加载器支持。[/]
[/list]