HUD 指南针

船只、推车与传送门的动态地图标记抬头指南针

老兄，我的船呢？再也不会弄丢你的船、推车或传送门了。一个带提示功能的指南针，包含标准标记，以及指南针和地图上用于船只、推车、激活和未激活传送门的动态地图标记。

HUD指南针带来完整的地点指引体验。（见下方鸣谢）

• 可缩放的指南针会出现在你的屏幕顶部。
• 在游戏中开启或关闭指南针。
• 动态标记（船只、车辆、传送门）会显示在罗盘和地图上，无论是否带有标签。
• 传送门标记会显示你为它们设定的名称。
• 船只标签可以指定船只类型（卡维、长船、木筏），以及自定义船只。
• 不想用通用名称？给你的货车和船只添加自定义名称吧。
• 支持自定义船只和马车。
• 活跃和不活跃的传送门可以有不同的颜色。
• 雾效、薄雾以及在战斗和奔跑时的配置，以获得更好的沉浸感。
• 要包含或排除的引脚类型可配置。
• 图钉大小随标记距离变化，可配置上下限。
• 使用外部图像配置自定义指南针和动态图标外观。 查看笔记

新

• 修复了显示/隐藏类型与显示/隐藏地图/指南针配置设置之间的“脱节”问题
• 新增功能：可为货车和船只命名，并在地图上显示
• 已移除“忽略的标记名称和类型”以及“显示购物车、船只和传送门”的服务器权威钩子

配置

A - 抬头显示指南针

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

B - 罗盘显示

• 使用玩家朝向： 根据玩家面朝的方向而非屏幕中央来确定指南针的朝向。
• 罗盘刻度： 设置屏幕上罗盘的整体缩放比例
• Y偏移： 从屏幕顶部的偏移量（像素）。
• 距离（最小）： 指南针上显示标记的最小距离。@
• 距离（最大）： 图钉在罗盘上显示的最大距离。@
• 玩家标记可见性： 强制多人游戏中玩家标记在罗盘和地图上显示或不显示，或由玩家自行决定。若未设为“玩家选择”，则覆盖“显示我的玩家标记”。@
• 显示我的玩家标记： 在玩无地图模式且可见性设置不可用时，显示或隐藏罗盘上的玩家标记（多人游戏）。若玩家标记行为未设为“玩家选择”，则会被服务器覆盖。
• 别针缩放： 设置屏幕上标记的整体缩放比例
• 最小密码长度： 放大或缩小标记在最远可见距离时的尺寸。
• 显示中心标记： （可选）显示中心标记图形。
• 地图打开时隐藏HUD： 打开大地图时隐藏 HUD 显示。

C - 忽略

• 引脚名称： 忽略具有这些名称的地点标记（逗号分隔，不含空格）。在字符串末尾加星号（*）表示前缀。
• 别针类型： 忽略这些类型的位置标记（逗号分隔，无空格）。类型包括：Fire,House,Pin,Portal,Start,Haldir,Hildir,BogWitch,Death,Bed,Shout,Boss,Player,RandomEvent,Ping,EventArea。

E - 指南针颜色

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

F - 动态标记

• 在地图上显示动态标记： 在主地图和小地图上显示船只、推车和传送门的标记。分别在下方进行控制。@
• 在指南针上显示动态标记： 在罗盘上显示船只、推车和传送门的标记。下方可单独控制。@
• 玩家标记刷新标记间隔： 地图和指南针上玩家标记刷新的间隔秒数。调低可让玩家标记更新更“平滑”。设为零则每帧刷新。注意：Valheim 默认玩家标记刷新为 2 秒。调低可能会降低多人游戏性能。@

G - 动态类型

• 显示船只： 在地图和罗盘上显示船只。
• 显示购物车： 在地图和指南针上显示马车。
• 显示传送门： 在地图和罗盘上显示传送门。@

H - 动态名称

• 在地图上显示动态名称： 在大地图上显示船和推车的类型（即木筏、维京船、长船）以及传送门名称。

一、动态地图颜色

• 地图上活动传送门的颜色： 有活动连接的传送门图标颜色。
• 传送门颜色： 传送门图标在地图上的颜色。
• 飞船颜色： 地图上船只图标的颜色。
• 购物车颜色： 地图上购物车图标的颜色。
• 在指南针上使用颜色： 在指南针上为动态标记使用颜色

J - 可见性

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

K - 沉浸模式

• 在雾中隐藏指南针： 关闭迷雾中的罗盘。@
• 战斗中隐藏罗盘： 战斗中关闭指南针。
• 战斗中隐藏罗盘的延迟： 战斗动作结束后，罗盘重新显示之前的时间量。@
• 在雾中隐藏指南针： 在浓雾中关闭指南针。@;
• 室内隐藏指南针： 在地牢或遮蔽处时关闭罗盘。@
• 奔跑时隐藏罗盘： 奔跑时关闭指南针。停下或步行来辨别方向。

L - 死亡标记管理

-- 自动移除死亡标记： 当墓碑被清空或未生成墓碑时，自动移除死亡标记。

M - 命名

• 允许命名： 允许为船只和推车命名以在地图上显示。@
• 最大名称长度： 船只或推车名称的最大长度。@
• 使用按键修饰键： 按下此键同时配合“使用”键，将打开船只或推车命名对话框。

Z - 实用技能

• 日志级别： 控制日志中包含的信息级别
• 使用外部图片： 已弃用

描述以“@”结尾的配置项由服务器权威控制。

游戏内重新配置

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

制作人员

首先，感谢 权志龙 感谢你说服我接手开发沉浸式指南针，以及 丰富的 建议、测试和反馈。没有这些帮助，我只会有一半的功能。

HUD指南针整合了GuyDeYoYo（又名Fragnarok，经其许可）的沉浸式指南针功能，并将原始代码归功于Aedenthorn。

动态标记使用了Schlangguru的自动地图标记——船只与马车中的代码，我曾多次尝试联系他以获得明确许可，但该模组已无人维护。

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

笔记

• 忽略的标记，以及推车、船只和传送门的显示设置为不再由服务器控制——它们仅为客户端设置。服务器仍控制动态标记是否 允许 在地图和指南针上，允许的类型有 显示 是一项客户端设置。
• 你可以为你的货车和船只命名，名称会显示在地图上。
  • 对于购物车，将鼠标悬停在购物车上，然后按下你通常的“使用”键以及 使用按键修饰键
  • 对于船只，将鼠标悬停在船舵上，并按下你通常的“使用”键以及 使用按键修饰键
  • 如果在灵巧卡车上使用保险杠贴纸，贴纸文字将会更新。如果你更换保险杠贴纸，地图 将 装备拖车或触发更新标记的事件后才会更新。
  • 如果你使用另一个模组，为货车或船只命名并使用开箱即用的文本（ZDOVars.s_text）来保存名称，那也可以正常工作。
• 图像资源位于 BepInEx/config/Neobotics/HUDCompass 中。这样可以确保你的自定义图像在更新时不会被覆盖。配置 使用外部图片 现已弃用。
• 死亡标记管理：
  • 这是在多个移除死亡标记的模组已被弃用后添加的。当启用自动移除时，清空墓碑将移除死亡标记。如果你的物品栏中没有任何物品且未生成墓碑，则不会创建标记。
  • 移除本地死亡标记不会从制图台上移除该标记。如果你在死亡标记处于活动状态时记录发现，它会作为幽灵标记残留在制图台上。
• 在浓雾或薄雾中关闭指南针的选项仅在你确实身处雾中时才生效。如果雾气只是遮挡了你视野中的其他物体，该选项不会关闭。
• 玩家标记可见性（服务器控制设置）会影响玩家标记在罗盘和地图上的显示。
• 显示我的玩家标记与地图上的“对其他玩家可见”开关同步。它们是一样的。
• A C. 忽略/固定名称 条目可以包含开头和结尾的星号（*）
  • 示例：
  • “Raspberry*”将匹配“Raspberry”和“Raspberry xyz”
  • “*Raspberry”将匹配“Raspberry和“abc Raspberry”
  • "*Raspberry*" 将匹配 "Raspberry"、"Raspberry xyz" 和 "abc Raspberry"，但前提是开头或结尾匹配整个字符串
  • 以“berry”结尾的词会匹配“Raspberry”“Blueberry”和“Cloudberry”，以及所有其他以“berry”结尾的词，包括带有数量前缀的浆果（例如“3 Raspberry”）。

注意： 通配符匹配可能会对帧率造成较大负担。请尽可能创建包含多个引脚的通配符（例如上面的“*berry”示例）。

兼容性问题和缺陷

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

• 任何使用标准船只或货车组件添加船只或货车的模组都应该能正常使用。

• 可建造的船只和推车会显示其基础单位的名称，例如自定义船只、木筏底座。

• 如果你发现兼容性问题，请在Discord的mod-help频道发帖说明。请务必附上你认为可能不兼容的模组名称和版本。

• 如果你发现了bug，请在Discord的mod-help频道中报告。如果你确实要提交bug报告，请务必包含以下内容：

  • 你的此模组版本
  • 事情发生时你正在做或试图做的事
  • 如果可以重复——也就是说，你能复制它吗？
  • 你观察到的（或未观察到的）确切行为
  • 如果可能，请在Discord上发布带有错误的日志文件截图（错误始终以该模组的名称开头）

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

• Thunderstore： Neobotics在Thunderstore上
• Nexus Mods： 星云新纪元
• 海克西姆： 新机器人学论

欢迎随时提出你的意见和反馈。请在NexusMods或Discord上留言： 新机器人Discord在线