客户端《英灵神殿》地图全面重制，支持持久化发现标记、可搜索管理、自定义图标、指南针追踪、传送门、载具、墓碑、建筑、生成点、商人和符文石。

乔伊的寻路者

作者： 乔伊坏规矩
版本： 1.1.1

乔伊的寻路者是《英灵神殿》的一款客户端地图、探索与导航全面改进模组。它保持原版世界不变，同时为你实际发现的事物提供一个持久、可搜索的寻路者图层：资源、建筑、生成点、商人、传送门、载具、符文石、敌人目击、坟墓以及你自己的自定义标记。

目标是在不将地图变成全局揭示或需要服务端模组的前提下，让《英灵神殿》的地图变得显著更加实用。

1.1.1 版本更新内容

版本 1.1.1 修复了《英灵神殿》中反复出现的0.5-1.0秒帧时间卡顿问题 1.0.12 并防止Pin Manager的文本输入将控制指令泄露到游戏玩法中。

• 高频输入补丁不再在每次《英灵神殿》输入轮询时请求分配参数数组。
• 关闭地图界面时，UI发现机制不再每0.75秒执行一次全局Unity UI搜索。
• 船只、推车和传送门更新现在使用生命周期提供的注册表，而不是反复搜索整个已加载场景。
• 符文石注册表快照不再在每次扫描时重新同步所有已加载的位置。
• 全球 已启用=假 设置现已暂停所有循环的寻路者运行时和界面工作。
• 打开的图钉管理器现在作为模态界面运行：搜索、重命名、图标/类型搜索和首领名称字段可以接收输入，而不会同时移动角色、触发动作、切换快捷栏槽位或关闭地图。

这些改动不会改变Wayfinder的 .wfd 模式、已保存标记标识、仅客户端网络模型或瓦尔海姆世界存档。

帧时间修正已通过受控A/B复测确认，复测使用相同的服务器、世界和模组组合，在1.1.0版本中复现了卡顿问题。Pin Manager输入修正也已在Valheim 1.0.12的游戏内确认。

之前 1.1.0 修复

版本 1.1.0 为Valheim更新Wayfinder 1.0.7 并修复了持续存在的随机或重复传送门标记错误。

• 传送门现在必须是已加载、已启用的 传送世界 使用有效的原版 网络视图 并且在Wayfinder记录之前，ZDO也要如此。
• ZDO位置具有权威性，必须与已加载的场景对象一致，防止半初始化或回收的对象写入错误坐标。
• 稳定的ZDO身份与精确的位置别名配对，因此重复扫描、重新登录、传送门重命名和链接状态变更都会更新同一条记录。
• 被摧毁的传送门会通过其网络标识移除，并采用保守的位置回退。
• 仅记录位置的旧传送门数据会被保留但隐藏，直到真实传送门确认后才显示。这样既能防止损坏的标记重新出现，又能让合法的旧记录在原地恢复，且用户元数据保持完整。
• 传送门诊断可通过以下方式获取 调试日志; 它们默认是禁用的。
• 英灵神殿1.0中重命名地图右键路径的处理，不会导致Harmony补丁集在启动时失败。

之前的 1.0.1 商人位置修正仍然保留。

上一个1.0.1修复

版本 1.0.1 修复了已确认商人标记的位置问题。在1.0.0版本中，已确认的哈尔多、希尔迪尔或沼泽女巫标记可能会落在生成的商人营地原点，而不是瓦尔海姆原生商人图钉所使用的位置。

• 已确认的交易商标记现在使用 瓦尔海姆本地商人的标记位置作为权威地点 可用时。
• 如果原生标记点尚不可用，则使用已加载商人的实际世界坐标作为备选。
• 生成的贸易商营地中心仅用于 可能的/候选商人营地 交易商确认前的标记。
• 已确认现有1.0.0交易记录自动 原地自我纠正 当观察到正确的本地商人标识时。
• 此修正会保留现有的Wayfinder记录，包括收藏、追踪状态、自定义名称、图标覆盖、备注及其他用户自有元数据。无需重置数据库或手动重建图钉。

亮点

• 仅客户端。 无需安装专用服务器。
• 每个世界独立的寻路者持久数据库 具备安全备份/恢复和世界隔离功能。
• 可搜索标记管理器 已融入大地图中。
• 创建、重命名、收藏、删除、筛选和编辑标记，无需依赖 Valheim 旧的固定标记栏。
• 完整视觉图标选择器 对于新增和现有标记，包括持久化的用户图标覆盖以及真正的默认重置。
• 最多追踪5个目标 带自定义水平罗盘和可选的 world-space 信标光束。
• 为支持的地图标记自定义寻路者图标，同时适当保留底层原始标记数据。
• 将相同资源分组连接并进行资源聚类，同时支持可选的聚类数量。
• 合法发现后生成的结构／兴趣点／地下城记忆。
• 物理生成点记忆，包括专用生成点美术和已知生成点周围的目击抑制。
• 可选的普通敌人目击热点，若有对应敌人的奖杯图案则一并显示。
• 符文石、维京罗盘、首领引导和商人处理，并针对特殊情况清理以避免嘈杂或误导性的标记。已确认商人标记与瓦尔海姆原生商人标记位置对齐；生成的营地中心仅为候选位置。
• 带有标签/名称同步以及防止误触地图右键导致意外删除的传送门纪念功能。
• 船和车的记忆使用稳定的网络标识，装载时实时更新位置，卸载时清除最后已知状态。
• 墓碑视觉替换，保留底层原生死亡标记的持久性，只有当物理坟墓真正消失时才移除标记。
• 可选扩展地图探索倍率。
• 预算内的发现工作和生命周期驱动的注册表，旨在避免正常游玩中重复的全场景扫描。

多人游戏行为

寻路者会 不 添加自己的网络层。它在本地观察瓦尔海姆的常规网络对象，并将寻路者数据存储在每个玩家的机器上。

这意味着：

• 服务器 不 需要安装乔伊的寻路器。
• 其他玩家可以 不 需要安装模组才能使用。
• 寻路器标记、筛选、收藏、追踪状态和图标覆盖均为每位玩家本地设置。
• 寻路者不会在玩家之间自动共享发现。
• 移动的船只/推车会在同一网络对象加载到你的客户端时更新。如果它离开你的加载范围，寻路者会保留其最后已知位置，直到你的客户端再次观察到它。

探索理念

寻路者默认有意保持保守。它只记住你真正互动过或遇到过的事物，而不是凭空揭示整个世界。

自动扫描周边区域资源，正在 默认关闭，发现敌人出现在 默认关闭，未探索区域迷雾扫描正在 默认关闭，且即使启用了区域扫描，被掩埋的银仍仅限交互。

图钉管理器

打开大地图并使用寻路器控制来管理你的标记。默认备用快捷键是 F7 当地图放大打开时。

经理支持：

• 搜索与分类筛选
• 在你所在位置手动创建标记，或在地图上放置标记
• 收藏
• 重命名 / 删除
• 完整可搜索图标选择
• 默认图标重置
• 追踪槽位 T1-T5
• 分类可见性控制
• 首领标签覆盖
• 在管理器打开时以模态方式抑制游戏输入，这样所有可编辑字段都能正常使用，而不会将控制传递到Valheim

指南针与追踪

寻路者罗盘默认开启。显式追踪的标记在实用世界尺度距离内仍然可用，并可显示实时距离、可选名称、屏幕边缘钳制及世界空间信标光束。

追踪功能与删除操作是分开的，也与《英灵神殿》中正常的中键地图标记不同。

配置

生成的配置文件为：

BepInEx/config/com.joeybadmanners.wayfinder.cfg

大多数玩家可以保持默认设置，并使用地图内的标记管理器进行普通的地图操作。重要的配置组包括：

• 00 - 通用 — 启用/禁用，调试日志记录
• 10 - 地图 ——视觉替换、地图移除行为、首领标记缩放
• 11 - 图钉管理器 — F7备用键位，紧凑地图控制，隐藏分类，首领标签
• 20 - 探索 — 集群、交互发现、可选区域扫描、目击、地牢内容扫描
• 21 - 资源筛选器 ——故意设计为有噪音的基础资源，例如石头／树枝／燧石／蒲公英
• 22 - 建筑 — 生成结构发现
• 23 - 生成器 — 物理生成器与目击抑制
• 24 - 传送门 — 传送门发现、标签同步、命名、销毁清理
• 30 - 指南针 — 罗盘显示与追踪标记上限
• 40 - 路径点 — 追踪目标信标行为
• 50 - 载具 — 船只/车辆，实时更新，最后已知状态
• 60 - 探索 — 可选探索半径倍率
• 90 - 性能 —扫描间隔、持久化批处理和视觉刷新时机

调试日志默认关闭。 详细运行时日志记录 仅在以下情况生效： 调试日志 也已启用。

安装

模组管理器

通过Thunderstore/r2modman安装Joey's Wayfinder。BepInExPack Valheim应作为其必要依赖项自动安装。

手动

1. 安装BepInExPack Valheim。
2. 放置 乔伊坏礼仪.寻路者.dll 在以下文件夹中 BepInEx/plugins/.
3. 启动一次英灵神殿以生成配置和寻路器数据文件夹。

无需在服务器端进行安装。

所需依赖

• denikson-BepInExPack_Valheim-5.4.2350

数据和备份

寻路者会在你的BepInEx配置区域下保存每个世界的数据，位于一个 乔伊的寻路者/世界 文件夹。世界数据库使用 .wfd 文件并保持一个 。备份 用于恢复的安全副本。

移除模组不会更改或删除你的英灵神殿世界。寻路者记住的数据与世界存档是分开的。

兼容性/设计说明

Joey的寻路者旨在与《英灵神殿》的常规联机机制共存，它读取本地可用的游戏状态，而非引入自定义服务器协议。在原版地图数据得到保留的场景下，寻路者仅替换显示层，例如受支持的原生Boss/死亡标记图标。

如果另一个地图模组大量替换了相同的小地图界面、标记生命周期或地图输入方式，可能会出现视觉或交互冲突。

支持

如果你喜欢我的模组并想支持我的创作，可以在这里找到我 Ko-fi:

https://ko-fi.com/joeybadmanners

开发者 乔伊坏规矩 在……的协助下 OpenAI 的 ChatGPT.

验证状态

版本1.1.1是针对已安装的Valheim 1.0.12 Windows程序集和BepInExPack Valheim 5.4.2350编译的。Harmony目标与仅客户端依赖项已进行静态审计。在相同环境下进行的受控A/B重测确认，1.1.0中反复出现的卡顿问题已消除，本地游戏内测试确认了图钉管理器的输入抑制功能。持续回归测试以及多人/原版客户端检查仍在 测试计划.md 仍推荐。

授权

MIT 许可证。见 许可协议.