寻路者

描述
导入、导出和管理个人地图标记，并显示玩家和地图光标坐标。

功能
[list]
[]从 valheim.tools 的 JSON 导出文件导入标记。[/]
[]将你的个人地图标记导出为 JSON。[/]
[]使用点、火、房屋、剑或传送门图标在指定的世界 X/Z 坐标处添加标记。[/]
[]加载、重新加载和清除单个标记集合，或清除所有个人标记。[/]
[]撤销上一次标记操作。[/]
[]跳过重复标记，并在导入前检查世界种子。[/]
[]为每个世界和角色单独跟踪集合。[/]
[]在游戏过程中切换显示玩家坐标，在大地图上切换显示光标坐标。[/]
[/list]
要求
BepInEx。

游戏版本
此版本为 Valheim 1.0.21 构建。

安装
1. 关闭 Valheim 并解压下载的文件。
2. 将 TheWayfinder.dll 复制到你的 Valheim 安装目录中：
Valheim/BepInEx/plugins/TheWayfinder.dll
3. 启动游戏。配置和导入文件夹会自动创建。

更新时，请替换现有的 DLL，而不是保留多个副本。

快速上手
打开大地图并按 [b]J[/b] 打开或关闭 Wayfinder。按 [b]Esc[/b] 关闭其窗口。

标记： 按坐标添加标记、导出你的标记、清除所有个人标记，或撤销上一次操作。

集合： 选择一个 JSON 文件以加载、重新加载或清除其标记。文件会自动出现在列表中；只有在你加载它们时才会添加标记。

设置： 选择是否显示玩家坐标和地图光标坐标。

导入和导出
将 JSON 文件放入：
Valheim/BepInEx/config/TheWayfinder/Imports

导出的文件会保存到同一文件夹。每次导出时请选择新的文件名；现有文件不会被覆盖。

你可以从 valheim.tools 导出标记，并通过“集合”选项卡加载 JSON。

控制台命令
窗口提供了主要控制功能。也可以使用控制台命令：

[code]wayfinder preview <filename.json>
wayfinder import <filename.json>
wayfinder export <filename.json>
wayfinder add X Z icon label
wayfinder collections
wayfinder reload <collection name>
wayfinder clear <collection name> --confirm
wayfinder clear all --confirm
wayfinder undo[/code]
标记图标：dot、fire、house、sword、portal。

示例：

[code]wayfinder add -807 -376 sword Base supplies[/code]
配置
设置保存在：
Valheim/BepInEx/config/local.valheim.thewayfinder.cfg

可以在此文件中更改面板快捷键。手动编辑前请关闭游戏。

卸载
关闭 Valheim 并删除 Valheim/BepInEx/plugins/TheWayfinder.dll。已保存到地图上的标记会保留。

故障排除
检查 Valheim/BepInEx/LogOutput.log 中的错误。如果出现问题，请尝试仅安装 BepInEx 和 The Wayfinder 运行游戏。

报告问题时，请包含你的 Valheim 版本、Wayfinder 版本、复现步骤以及相关日志消息。

AI 披露
The Wayfinder 在编程、重构、文档和测试规划方面得到了 AI 协助。其设计和游戏内测试由我指导。