世界导航者

世界导航器是一个多功能、交互式、可扩展的游戏内导航系统和指南。

世界导航器就像你手机或任何GPS设备上的导航地图应用，经过改编后融入星露谷物语。它结合了高效的算法与多功能菜单，提供实时指引，或者在游戏中将直白的文字方向写在废纸条上。

这个模组的首个版本耗时近一年才发布——我一直希望有这样的内容存在，在制作过程中，我既享受了极大的乐趣（也遇到了不少挫折）。希望你能喜欢它，并觉得它有用！

[视频已省略]

如何安装：

1. 安装最新版本的SMAPI.
2. 下载此模组并将其解压到 Stardew Valley/Mods 中。
3. 同样安装上述要求中列出的必需模组。
4. 使用SMAPI运行游戏。

如果你需要安装模组的额外帮助，星露谷物语维基提供了更详细的说明。 要卸载该模组，请从你的Mods文件夹中删除该模组的文件夹。

注意：世界导航器可以随时安装（或移除）。

如何查看菜单？

默认情况下，按键盘上的B键。

通过按下你在 config.json 中设置的按键（该文件会在你打开游戏后生成）或在世界导航器菜单内的选项子菜单中设置的按键，打开世界导航器菜单。你也可以使用像 通用模组配置菜单 这样的模组来设置按键。

如果你使用 更好的游戏菜单，右键点击游戏菜单中的地图标签，然后选择“世界导航器”。如果你使用 图标框架，世界导航器的图标会出现在你的图标中。如果你使用手柄并安装了 星控，世界导航器可作为该模组的一个使用项目。如果你使用 手机 或 手机续作，世界导航器的图标会显示在手机上。

打开世界导航菜单后，点击了解可用的功能，或者继续阅读此处...

特性

NPC、任务、地点搜索、可自定义的家园点、兴趣点及其他功能

世界导航器提供详细菜单，让您可以选择村民、任务、事件甚至您的家作为导航目标，世界导航器会引导您到达目的地。您还可以在星露谷物语的存档中搜索任何位置并执行相同操作（包含可点击地图）。有了世界导航器，您将很难再次在荒野中迷路。此外，其他模组可以向兴趣点子菜单添加它们自己的兴趣点，方便您选择这些作为目的地目标。（模组作者，请参阅下方了解具体操作方法。）

世界导航器兼容 模组NPC、任务、地点和事件！

主动引导与一张废纸

世界导航仪让你可以选择使用主动引导或文字指引（或两者兼备）。

主动引导意味着你可以通过选择视觉指示（指针、线路或脚印）获得实时方向指引。当你抵达传送点、矿车或其他移动方式时，会弹出小型提示告诉你下一步操作（例如"前往南边的鹈鹕海滩"或"乘坐矿车到鹈鹕镇"）。系统会计算最短*路径，帮助你穿越各地形中的障碍物。请注意，可拾取物品（如采集物、家具）或可移除物（如杂草、资源堆（树桩、巨石等），若你持有必要工具）不会被视作障碍。

另外，《世界导航者》可以用通俗语言在废纸上写下方向指引，供你参考，带来那种模拟的感觉；或者，如果你只是想知道这个世界上某个东西在哪，但现在不想去那里，也可以这样做。你会收到一件物品——一张废纸，你可以右键点击（检查/执行动作按钮）来查看。有些情况下，你甚至可能在纸上发现一个小涂鸦。除此之外，这张废纸就只是垃圾，你可以扔掉，或者想留着也行。

*在某些非常特殊的情况下，由于进行的某些近似处理，可能会错过跨越多个地点的最短路线，但这很少见。本指南将始终在你的位置内找到最短路线。

世界、四处走动、NPC日程安排与秘密

世界导航器能够全面理解游戏世界，并掌握你通过各种方式（从步行到矿车，从巴士到姜岛鹦鹉快递）在该世界中移动的路径。它能判断建筑是否开放参观、NPC所站房间是否可进入、NPC未来数小时的所在位置，以及更多信息。当你使用该功能时，它会实时检查存档中的位置与旅行选项。你甚至可以通过内置选项子菜单自定义部分检测或忽略的内容（但这不会改变你周围的世界）。

上一段中的所有内容都包括了模组地点和多种模组旅行方式。

世界导航器内置了对中央车站及其内容包的支持（计划在中央车站1.4版本中提供完整支持），但某些模组形式的旅行需要模组作者添加额外内容（详见下方关于如何添加的内容）。

《世界导航者》甚至能告诉你需要向谁打招呼才能完成"引荐"任务。请查看该任务的NPC子菜单。

关于"描述指引"功能的说明：场景内的基本方位为近似值："向北走10格"的指令可能实际指向偏北最多22度的方向。这种偏差由Anya算法特性决定——该算法得名于其假设"任意角度"的移动均可行。当指令指定较长距离时，这种偏差的影响更为显著，因此建议在完成部分路程后重新请求指引（指引会实时更新）。此外，该模组会忽略它认为你可移除的障碍物（如可采集的野草或可用工具破碎的碎石）。若你依赖游戏环境的文字描述，请注意旅途中仍可能遇到此类障碍物。

另外...甚至还有些秘密你可能会发现。

选项与配置

世界导航器拥有自己的选项子菜单。这些选项会保存到你的存档文件中，而不是存储在 config.json 文件中。打开世界导航器并点击"选项"按钮。以下是你可设置的部分选项：

• 选择你的家园位置，之后可以通过主世界导航菜单中的"回家"按钮（默认已设置为农舍前方）使用该位置
• 选择主动导航时使用的视觉类型：围绕玩家旋转的箭头、实心白线或脚印（我个人最喜欢的），或者通过简单的Content Patcher模组提供自己的视觉（请参阅下方"模组作者"部分）
• 选择在导航过程中是否在你的目的地（或NPC上方）显示指示器
• 更多功能...无论是自定义搜索子菜单中可点击的世界地图颜色，还是告诉世界导航器在计算路线时检查或忽略各种世界限制，都可以通过选项子菜单来定制您的体验。

此外，在您使用该模组运行游戏一次后，World Navigator 会在模组文件夹中生成一个 config.json 文件。该文件负责处理一些选项，包括用于打开 World Navigator 菜单的按键绑定（或无需按键），但此文件不处理菜单中的其他选项。默认情况下，打开菜单的键盘按键为 'B'。您也可以使用 Generic Mod Config Menu 来设置此功能。config.json 包含以下选项：

• 打开世界导航器菜单的按键绑定。默认：'B'
• 在菜单中查阅任务或事件更多信息的快捷键。默认：'F1'
• 显示一条简要描述当前指引的通知的快捷键。默认：'左 Shift + B'
• 一个复选框，用于强制光标捕捉到菜单中更多的元素。如果你在安装 World Navigator 时已拥有 Stardew Access，则默认为 true，否则为 false

它是如何做到它所做的？

World Navigator 会在您询问路线时，实时收集您模组收藏中各个位置的数据。这一步可能需要几秒钟。它会找出这些位置之间通过任何旅行方式连接的所有路径，然后计算前往目的地的最短路线。如果您随后启用主动导航功能，系统会在行进途中引导您绕过大多数固定障碍物，让您始终知道该往哪里走，不会陷入死胡同。

如果你想了解更多细节，我计划写一些关于我实现的算法。这可能会以文章的形式出现在Nexus上，所以请关注此模组以查看。

其他模组、兼容性与整合

给玩家们：

多人游戏

多人模式尚未经过测试，在某些情况下可能会出现一些奇怪的行为，部分原因是当您处于菜单中时时间仍在流逝，因此周围的世界也可能发生变化。更可能的问题会更加微妙。我目前不清楚未来多人模式的兼容性会如何变化。

话虽如此，我确实计划支持多人游戏，而且对此充满希望。

安卓及其他平台

此模组专为电脑版星露谷物语1.6.15（及可能更高版本）设计。我无法为其他平台提供支持。

游戏控制器

希望该模组能提供完整的控制器支持。我本人不使用控制器，但我在制作这个模组时始终考虑到了控制器用户的需求。虽然我的控制器测试能力有限，但我已尽力而为——如果你遇到问题，请告知我，以便我尝试改进任何方面，优化你使用模组的体验。特别说明：World Navigator 可与模组 Star Control 配合使用。

模组整合

虽然你可以通过按下按钮（默认为B键，但你可以自行配置）打开菜单，但你也可以通过与以下模组的集成来打开它：Better Game Menu、Iconic Framework、Star Control、Mobile Phone 或 Mobile Phone Continued。如果你使用Better Game Menu，可以在游戏菜单的地图标签页上右键点击，然后选择World Navigator。如果你使用Iconic Framework，World Navigator的图标会包含在你的图标栏中。如果你使用Star Control，World Navigator可作为该模组的可用物品使用。如果你使用Mobile Phone或Mobile Phone Continued，手机界面上会包含World Navigator的图标。

世界导航器可以通过让模组作者添加内容来与任何模组整合（见下文）。其中两个模组是我自己制作的：杂草蔓延之处 - 更多农场损坏信息 和 寻找失败果树（如果你已有其中任一模组，请确保更新它们）。请参阅这些模组的描述以了解它们如何使用世界导航器。此外，如果你使用祖鲁市中心模组，世界导航器会尝试让玩家避开交通拥堵。

除了内置支持大多数通过内容补丁添加的位置和大多数"类原版"旅行方式外，世界导航器还支持使用Pathoschild的模组中央车站进行旅行。其他模组也可以为世界导航器提供可能被遗漏或误解的数据（模组作者请参见下方说明）。

模组兼容性

由于世界导航器经常使用原版纹理作为菜单的界面，因此，那些重新着色用户界面或物体的模组也会如预期般改变世界导航器的菜单，但世界导航器本身提供的各种图标除外。

一些模组添加了世界导航器无法理解的旅行方式。这些通常表现为特定的触发动作，会使玩家传送，或是用C#代码实现类似功能。模组作者可以告知世界导航器这些情况（详见下文）。也可以制作单独的模组来实现此功能，但原模组作者更可能对自己的模组做出更准确的描述。

如果一个模组在没有使用典型游戏逻辑的情况下在某个位置放置了障碍物，世界导航器可能无法识别该障碍物，并将其视为不存在，从而错误地认为玩家可以从此处通过。模组作者可以告知世界导航器这些障碍物的信息（详见下文）。

World Navigator 已经由我或我的测试人员与数百个热门模组一同测试过。如果你遇到问题，请参阅下方的 "如何报告错误/问题" 部分。

模组冲突

目前已知没有完全与世界导航器冲突的模组——也就是说，你可以将此模组与其他任何模组一起安装。不过，某些模组可能需要注意一些问题。

例如，在使用世界导航的主动引导功能时，后台会运行一个非常复杂但高效的算法。因此，如果你使用像快进这样的游戏节奏加速模组，在少数特定地点或情况下可能会遇到一些卡顿。

另一种模组类别包括允许你跳跃、游泳、无碰撞穿墙或以其他方式穿过通常无法通行的世界区域的模组——如果世界导航器在你穿过无法通行的区域时正在引导你，它可能会关闭，此时你需要重新进入可步行区域后才能再次启动导航。

针对模组作者：

你可以创建新的指针类型。你可以将模组中的兴趣点添加到世界导航器中供玩家使用。你可以告诉世界导航器它可能遗漏的世界中的事物。

查看模组作者指南.

翻译

您必须阅读并同意我的个人资料页面上的翻译指南与限制条款。任何违反这些限制的翻译或模组将被举报为滥用行为。以下是与本模组相关的一些注意事项：

这个模组的文件中有两个不同的default.json文件。

该模组除其他功能外，还使用占位符（例如{{locationName}}）为位置、基本方位等内容创建人类可读的方向指示，但我意识到我的写作以英语为中心。因此，当前版本代码中的部分文本行和翻译行在其他语言中处理时，可能会难以在保持语法正确性的同时适用于所有使用场景。支持更多语言固然有益，但可能需要我们以某种方式合作，而非仅由你创建翻译文件。开始翻译前，欢迎随时联系我咨询问题。

如何反馈漏洞/问题

有时事情会出错，或者只是表现异常。我希望了解这些情况！

一旦您发现出问题，请在SMAPI控制台窗口中输入"worldnav log"（不含引号）并按回车。然后前往 https://smapi.io/log/ 上传您的日志文件，并按照该页面上的步骤分享日志。如果您忘记输入"worldnav log"，也请直接分享日志，因为其内容仍具有参考价值。

请描述您预期会发生什么以及实际发生了什么，同时提供您认为有助于我帮助您或修复任何错误的其他详细信息。即使没有错误或警告，也请分享日志。唯一的例外是如果您报告的是一个拼写错误，则无需提供日志。

遇到导航相关问题或发现世界导航器遗漏了某些内容时该如何处理

请告诉我，但请帮我个忙：一旦你注意到它，请按照上述说明操作，包括在控制台输入"worldnav log"。在你按照上述段落操作并分享给我后，有些情况下我能解决问题，而其他情况下则需要由其他模组或模组作者使用模组作者指南告知World Navigator缺失的信息。

控制台命令

这里有一些你可能觉得有用的控制台命令：

• worldnav log - 请在报告问题时使用此信息！
• worldnav cancel - 如果发生异常情况导致无法访问菜单，此命令可取消正在进行的导航，其效果与通过游戏内菜单执行取消操作相同
• worldnav menu - 打开世界导航器菜单
• worldnav schedule <NPC名称> - 打印指定NPC的日程数据（名称支持模糊匹配）
• worldnav cat [filter] - 打印当前在世界导航器中注册的类别和兴趣点，可选择通过提供的子串过滤器对类别ID进行限制

谢谢

感谢为我的工作提供鼓励、帮助、测试以及更多支持的众多人士。感谢Sunberry Village的创作者们允许我在他们的Discord服务器上分享此模组的开发版本，并获取来自其他模组作者和玩家的宝贵反馈。感谢星露谷物语、SMAPI、Content Patcher和StardewUI的创作者与贡献者，没有他们，这一切都不可能实现。感谢星露谷物语Discord服务器上的模组作者们提供的额外意见。感谢我在本模组代码中实现的各种算法的创作者，尤其是2016年描述了Anya算法的论文作者，我正是利用该算法编写了自己的实现版本。

源代码

模组作者指南