海盗王帽子界面

描述

添加一个小宝箱图标和短暂音效，当海盗王帽子侦测到附近宝藏时触发。如果你隐藏头盔游玩、看不到帽子的常规提示，这个功能会很有用。

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

源代码和错误报告： GitHub 仓库.

安装说明

与 CDUMM（深红沙漠终极模组管理器） 或 DMM（终极模组管理器）:

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

使用另一个兼容的ASI加载器：

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

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

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

更新时，请备份您的INI文件，并避免安装第二份ASI。对于CDUMM或DMM，请在导入更新前启用现有模组，并确保游戏已关闭。

主要特性

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

要求

• 一个兼容的ASI加载器。 CDUMM 和 DMM 提供模组安装和 ASI 加载器管理功能。
• 必须装备海盗王帽才能收到宝藏通知。如需仅图标设置检查，请设置[indicator] force_show=1；这仍然需要小地图可见且菜单关闭，并且不会触发声音。
  

界面布局已针对游戏版本2.03.02进行检查。游戏更新可能需要更新模组。

错误报告与故障排除

在“Nexus 漏洞”选项卡中报告问题，或在以下地址提交议题： GitHub请包含重现问题的步骤、您期望的结果以及实际发生的情况。

该模组会将日志保存到PirateHatHUD.asi旁边，文件名为PirateHatHUD_*.log（通常在使用CDUMM或DMM时位于游戏的bin64文件夹中）。要捕获更多详细信息：

1. 在ASI文件旁边打开PirateHatHUD.ini，将[logging]下的level改为debug：

[日志记录]
等级=调试

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

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

如果图标始终不出现，请尝试使用[indicator] force_show=1，然后重启、加载存档，确保小地图可见，关闭菜单并等待一秒。此操作会在无需附近宝藏的情况下检查覆盖层。检查完毕后请将其改回0；正常探测需要装备海盗王帽子。

感谢名单

• Icons8 用于图标。
• 罗伊的“订阅提醒-金属叮当声”音效，来源自 乌普比特.
• 的开发者 安全钩子, Zydis 和 亲爱的 ImGui 用于该模组所使用的库。
• 的开发者 CDUMM 和 DMM 为模组管理器和 ASI 加载器提供支持。