HUD 指南针

HUD Compass

抬头显示指南针 - 为船只、手推车和传送门添加动态地图标记

兄弟，我的船去哪儿了？再也不会找不到你的船、手推车或传送门了。这是一个抬头显示指南针，包含标准图钉以及用于船只、手推车、激活和未激活传送门的动态地图标记，显示在指南针和地图上。

HUD Compass 结合并增强了 Immersive Compass 和 Automatic Map Markers 的功能，为位置辅助带来完整体验。（见下方鸣谢）

• 可缩放的指南针显示在屏幕顶部。
• 在游戏中可以开关指南针。
• 动态图钉（船只、手推车、传送门）会显示在指南针和地图上，可选择是否显示标签。
• 支持自定义船只和手推车。
• 激活和未激活的传送门可以有不同的颜色。
• 针对雾、薄雾、战斗中以及奔跑时的配置，以增强沉浸感。
• 传送门图钉会显示你为其指定的名称。
• 船只标签可以指定船只类型（Karve、Longship、Raft），也支持自定义船只。
• 包含/排除的图钉类型是可配置的。
• 图钉大小相对于标记距离，带有可配置的限制。
• 可配置为使用外部图像作为自定义指南针和动态图标外观。请参阅备注

新内容

• 修复了玩家登录专用服务器时出现的服务器异常（且未发送动态图钉的问题）
• 修复了“启用指南针”设置为“关”时，指南针仍显示在屏幕中间的问题

配置

A - HUD 指南针

• 启用指南针： 启用或禁用指南针 HUD。@
• 显示指南针： 显示或隐藏 HUD 指南针。使用“切换指南针键”在游戏中进行更改。
• 切换指南针键： 在游戏中用于切换指南针可见性的按键。

B - 指南针显示

• 使用玩家方向： 根据玩家面对的方向来定向指南针，而不是屏幕中央。
• 指南针缩放： 设置指南针在屏幕上的整体缩放比例。
• Y 轴偏移： 距离屏幕顶部的像素偏移量。
• 距离（最小）： 图钉显示在指南针上的最小距离。@
• 距离（最大）： 图钉显示在指南针上的最大距离。@
• 玩家图钉可见性： 强制玩家图钉（多人游戏）显示或不显示在指南针和地图上，或让玩家自行决定。如果未设置为 PlayerChoice，则覆盖“显示我的玩家图钉”。@
• 显示我的玩家图钉： 在无地图模式且可见性设置不可用时，在指南针上显示或隐藏你的玩家图钉（多人游戏）。如果“玩家图钉行为”未设置为 PlayerChoice，则会被服务器覆盖。
• 图钉缩放： 设置图钉在屏幕上的整体缩放比例。
• 最小图钉大小： 放大或缩小图钉在其最远可见距离处的缩放比例。
• 显示中心标记： （可选）显示中心标记图形。
• 地图打开时隐藏 HUD： 当大地图打开时隐藏 HUD 显示。

C - 忽略

• [i]图钉名称： 忽略具有这些名称的位置图钉（逗号分隔，无空格）。用星号（[*]）结尾表示前缀。@
• 图钉类型： 忽略这些类型的位置图钉（逗号分隔，无空格）。类型包括：Fire,House,Pin,Portal,Start,Haldir,Hildir,BogWitch,Death,Bed,Shout,Boss,Player,RandomEvent,Ping,EventArea。@

E - 指南针颜色

• 指南针颜色： （可选）调整指南针的主色。
• 图钉颜色： （可选）调整指南针上位置图钉的颜色。
• 中心标记颜色： （可选）调整中心标记图形的颜色。

F - 动态图钉

• 在地图上显示动态图钉： 在主地图和小地图上显示船只、手推车和传送门的图钉。在下方单独控制。@
• 在指南针上显示动态图钉： 在指南针上显示船只、手推车和传送门的图钉。在下方单独控制。@
• 玩家图钉刷新间隔： 地图和指南针上玩家图钉刷新的间隔秒数。减小以获得更“平滑”的玩家图钉更新。零值表示每帧刷新。注意：Valheim 默认的玩家图钉刷新间隔是 2 秒。减小可能会降低多人游戏性能。@

G - 动态类型

• 显示船只： 在地图和指南针上显示船只。@
• 显示手推车： 在地图和指南针上显示手推车。@
• 显示传送门： 在地图和指南针上显示传送门。@

H - 动态名称

• 在地图上显示动态名称： 在大地图上显示船和手推车类型（例如，Raft, Karve, Longship）以及传送门名称。

I - 动态地图颜色

• 地图上激活传送门颜色： 具有激活连接的传送门图标颜色。
• 传送门颜色： 地图上传送门图标的颜色。
• 船只颜色： 地图上船只图标的颜色。
• 手推车颜色： 地图上手推车图标的颜色。
• 在指南针上使用颜色： 在指南针上为动态图钉使用颜色。

J - 可见性

• 始终可见： 无论距离远近，始终以完整尺寸显示这些类型或名称（逗号分隔，无空格）的图钉，除非图标在地图上被隐藏。@

K - 沉浸感

• 在薄雾中隐藏指南针： 在薄雾中关闭指南针。@
• 战斗中隐藏指南针： 在战斗中关闭指南针。@
• 战斗中隐藏指南针延迟： 战斗动作结束后，指南针重新显示的延迟时间。@
• 在浓雾中隐藏指南针： 在浓雾中关闭指南针。@；
• 在室内隐藏指南针： 在地牢或有遮蔽处时关闭指南针。@
• 奔跑时隐藏指南针： 奔跑时关闭指南针。停下或行走以确定方向。@

Z - 实用工具

• 日志级别： 控制日志中包含的信息级别。
• 使用外部图像： 指南针和动态标记将使用模组文件夹中的图像，这些图像可以自定义。

配置项描述以“@”结尾的为服务器权威设置。

游戏内重新配置

你可以使用 Configuration Manager（或类似）模组在不退出游戏的情况下更改配置。如果你对配置文件进行了更改，配置将会重新加载。

鸣谢

首先，感谢 gdragon 说服我接手 Immersive Compass 的开发，并提供了大量的建议、测试和反馈。没有这些帮助，我可能只实现了一半的功能。

HUD Compass 整合了 GuyDeYoYo（又名 Fragnarok，已获许可）的 Immersive Compass 的功能，后者也借鉴了 Aedenthorn 的原始代码。

动态标记使用了来自 Schlangguru 的 Automatic Map Markers - Ship & Cart 的代码，我曾多次尝试联系他以获得明确许可，但该模组已不再维护。

代码的使用符合上述模组的许可要求，并包含在分发中。

备注

• 在浓雾或薄雾中关闭指南针的选项仅在你实际处于雾或薄雾中时适用。如果它遮挡了你视野中的其他物体，则不会关闭。
• 玩家图钉可见性（服务器控制设置）会影响指南针和地图上的玩家图钉显示。
• “显示我的玩家图钉”与地图上的“对其他玩家可见”开关同步。两者是相同的。
• 一个 C. 忽略 / 图钉名称 条目可以包含前导和尾随的星号（*）。
  • 示例：
    • “Raspberry*” 将匹配 “Raspberry” 和 “Raspberry xyz”
    • “*Raspberry” 将匹配 “Raspberry” 和 “abc Raspberry”
    • “Raspberry” 将匹配 “Raspberry”、“Raspberry xyz” 和 “abc Raspberry”，但仅限于起始或结尾与整个字符串匹配时
    • “*berry” 将匹配 “Raspberry”、“Blueberry” 和 “Cloudberry”，以及任何以 “berry” 结尾的内容，包括带有数量前缀的所有浆果（例如 “3 Raspberry”）

注意： 通配符匹配可能会消耗 FPS。尽可能尝试创建一个包含多个图钉的匹配（即上面的 '*berry' 示例）。

兼容性问题与缺陷

• HUD Compass 已与 OdinsShipsPlus、ValheimRAFT、CustomShips 和 CraftyCarts 进行过测试。

• 它应该适用于任何使用标准 Ship 或 Vagon 组件添加船只或手推车的模组。

• “可建造的”船只和手推车将显示其基础单位的名称，例如 Custom Ship、Raft Base。

• 如果你发现兼容性问题，可以在 NexusMods 上发帖。请务必包含你认为可能不兼容的模组名称和版本。

• 如果你遇到错误，请在 NexusMods 上报告。如果报告错误，请务必包含以下信息：

  • 你使用的此模组版本
  • 发生问题时你正在做什么，或试图做什么
  • 问题是否可重现——即，你能重复它吗？
  • 你观察到的确切行为（或未观察到的行为）
  • 如果可能，请在 Discord 上发布包含错误的日志文件截取（错误始终以此模组的名称开头）。

你可以在以下网址找到所有 Neobotics 发布的模组：

• Thunderstore: https://tinyurl.com/NeoboticsOnThunderstore
• Nexus Mods: https://tinyurl.com/NeoboticsOnNexus

欢迎随时提供你的评论和反馈。请在 NexusMods 或 Discord 上发布：https://tinyurl.com/NeoboticsOnDiscord

更新日志

1.1.7

• 修复了玩家登录专用服务器时出现的服务器异常（且未发送动态图钉的问题）
• 修复了“启用指南针”设置为“关”时，指南针仍显示在屏幕中间的问题

1.1.6

• 修复了动态图钉在地图上的显示/隐藏问题
• 添加了在地图打开时关闭 HUD 的配置

1.1.5

• 为 Call to Arms 更新
• 动态传送门图钉和 HUD 图钉现在应用地图图标显示/隐藏设置
• 动态图钉在未探索区域不再可见

1.1.4

• 修复了船只和手推车标记不移动的问题

1.1.3

• 更新了多人游戏，使远程标记再次可见。

1.1.2

• 添加了新的沉浸感配置，用于在室内、浓雾、薄雾、战斗中以及奔跑时控制 HUD 的可见性。
• 添加了对 Randy Kapp 的高级传送门（黑曜石、古代和黑金属传送门）的支持
• 修复了（大部分）不同分辨率下的指南针定位问题

1.1.1

• 未发布

1.1.0

• 未发布

1.0.12

• 为图钉名称添加了字符串开头通配符匹配，以支持 AutoMapPins 的带“数量”的图钉名称，例如，“*Raspberry”匹配“5 Raspberry”
• 修复了字符串结尾通配符的问题
• 添加了缺失的“Hammer”别名，用于排除图钉类型
• 修复了“其他”玩家图钉在指南针上的颜色问题

1.0.11

• 修复了罕见的显示/隐藏指南针问题

1.0.10

• 修复了一些用户报告的指南针位置问题

1.0.9

• 添加了石头传送门

1.0.8

• 性能调整

1.0.7

• 更改了动态图钉名称的地图配置，并修复了查看动态图钉名称的问题。请参阅文档。

1.0.6

• 修复了覆盖自定义图像的问题

1.0.5

• 将外部图像移至模组根文件夹，以兼容 R2Modman 安装
• 添加了使用嵌入式（默认）或外部图像的配置

1.0.4

• 添加了 NoMap 模式下在配置中显示/隐藏玩家图钉的功能
• 添加了服务器配置，用于强制玩家图钉开启、关闭或让玩家决定
• 更改为使用 Resources 文件夹中的图像，以允许自定义指南针图像

1.0.3

• 修复了小地图上动态图钉的罕见问题。
• 修复了显示/隐藏指南针被服务器设置覆盖的问题
• 添加了独立的服务器权威 HUD 启用/禁用

1.0.2

• 修复了某些系统上的玩家加载问题。

1.0.1

• 添加了对自定义船只和手推车的支持
• 修复了动态图钉颜色在淡出时发生变化的问题（其他玩家的标记）
• 修复了新创建的对象的图钉显示为其他玩家标记的问题（即淡出且颜色错误）

1.0.0

• 初始版本