家务足迹

[center][/center]
[center] [/center]
[center] [/center]
[center]标记一片区域，预览其中的任务，让你的农夫执行计划。[/center]

## 功能
- 按区域计划任务： 按住空格键并在你想工作的区域上拖动鼠标。ChoreTrail 会扫描该区域并找出所有它能处理的任务。

• 真实的游戏玩法，而非捷径： 你的农夫仍然会走到每个目标前，挥动正确的工具，并消耗与真实操作相同的体力、水和物品。移动、动画或物品使用方面没有任何跳过。
• 可视化的计划： 在开始之前，动作图标会显示将要发生的事情。当前目标会悬浮在地面上，一条轨迹——颜色和样式由你设定——会标记出路线。
• 智能路线规划： 任务会根据可达性、需要步行的距离以及需要切换工具的次数来排序。如果在途中遇到障碍物或地图发生变化，它会重新规划路线，并在允许时打开大门。
• 工具感知选择： 可以只使用你手中的工具，或者让 ChoreTrail 从你的库存中选取所有支持的工具。
• 快速类型选择： 空格 + 双击目标，附近所有相同类型的任务也会被添加。
• 矩形和涂绘模式： 绘制一个规整的矩形或涂绘自定义形状。Shift 键增加选区，Control 键减少选区。
• 充能工具： 升级后的锄头和喷壶会在你选中完整覆盖区域后释放充能效果——包括“触及”附魔。
• 安全的放置规划： 箱子、机器、洒水器、稻草人、工作台和树液采集器会按照游戏原有的方式放置，并叠加路线和逃生检查。
• 软接管： 随时轻触移动键即可立即恢复控制——队列的其余部分会等待你。
• 可选的自卫功能： 开启后，ChoreTrail 会在杂务进行中暂停，用你携带的最强近战武器挥击进入攻击范围的怪物。它不会追击怪物——只会坚守原地。
• 计划面板： 查看队列，删除不需要的任务，查看已完成或跳过的任务，并解决任何模棱两可的情况。
• GMCM 支持： 所有设置都可以通过通用模组配置菜单在游戏内调整。

工作原理

• 按住 空格键 并用 鼠标左键 拖动来标记普通工具使用的目标。
• 使用 空格键 + 鼠标右键 进行上下文操作和手持物品操作，如收获、装载机器、种植或放置设备。
• 松开鼠标按键以检查该区域并创建可见的任务计划。
• 查看动作图标，然后在需要确认时按下 空格键 + 回车键。
• 你的农夫会沿路线行进，并通过游戏的正常机制执行每项已验证的任务。

支持的杂务

• 作物与土壤： 翻耕可用土地、播种、施肥、浇水、收获成熟作物、采摘果实，以及收割用镰刀收获的作物。
• 农场清理： 敲碎石头、矿石节点、树枝、资源簇和矿井容器；砍伐成熟树木；割除杂草、草丛和枯萎的作物。
• 采集与探索： 收集可采集物品、挖掘文物点、使用淘金点，并搜索可用的垃圾桶。
• 机器： 收集完成的产品，并在手持物品被接受时装载兼容的原版或数据驱动的设备。
• 蟹笼： 收取捕获物并添加兼容的鱼饵，遵循游戏自身的蟹笼规则。
• 动物： 抚摸农场动物和宠物，在需要时使用挤奶桶或剪刀，给宠物碗加水，并在空食槽中放置干草。
• 功能性放置： 放置手持的箱子、数据驱动设备、洒水器、稻草人、工作台和支持的树液采集器。

操作方式

• 空格键 + 鼠标左键拖动 - 为手持工具标记目标。
• 空格键 + 鼠标右键拖动 - 标记上下文和手持物品的目标。
• 空格键 + 鼠标中键 - 在手持工具和库存工具的目标选择之间切换。
• Shift / Control - 在下次选区中添加或移除对象。
• 空格键 + V - 在矩形和涂绘选择模式之间切换。
• 空格键 + 双击 - 快速选择与点击目标匹配的附近任务。
• 空格键 + 回车键 - 确认并开始可视化的计划。
• 空格键 + K - 打开计划面板。
• 空格键 + L - 锁定或解锁第一个预览的任务类型。
• 空格键 + P - 暂停或恢复执行器。
• 空格键 + 退出键 - 取消预览或跳过当前目标。
• 空格键 + 删除键 - 清除当前计划和选区。
• 空格键 + O - 显示或隐藏 ChoreTrail 的渲染。
• 任何移动键 - 触发软接管并保留剩余队列。

手柄操作也已包含，并可在 GMCM 中更改。默认的手柄修饰键是左扳机。为避免与普通游戏操作冲突，独立单键快捷键默认是禁用的。

安装方法

• 安装 SMAPI 4.1.0 或更高版本。
• 下载 ChoreTrail 并将文件夹解压到你的 Stardew Valley/Mods 目录。
• 通过 SMAPI 启动游戏。
• （可选）安装通用模组配置菜单以便在游戏内更改所有设置。

配置选项

• 工具目标模式 - 仅使用手持工具，或使用库存中所有已启用的支持工具。默认值：手持工具。
• 工作配置 - 将计划筛选为工具使用、收获、收集、清理杂物、土壤准备、浇水、机器、动物、放置、上下文操作或智能行为。默认值：使用手持工具。
• 队列排序 - 选择任务优先级的方式。默认值：最近可达。
• 自动启动安全计划 - 在选区结束后立即启动无冲突、非破坏性的计划。默认值：关闭。
• 自动选择工具 - 让执行器选择所需的工具。默认值：仅从库存中选择。
• 自动补水喷壶 - 当喷壶为空时，路线会引导至可达的原生水源或水井。默认值：开启。
• 体力/时间安全 - 在农夫达到设定的体力或时间限制前暂停。默认值：10点体力和凌晨2:00。
• 杂务期间自卫 - 当怪物进入设定的近距离范围时进行防御。默认值：关闭。
• 任何地图操作 - 包含未知的地图互动，如门、书籍和墓碑。默认值：关闭。
• 砍伐时包含树苗 - 允许在自动斧头计划中处理未成熟的野生树木。默认值：关闭。
• 视觉设置 - 配置动作图标、路线可见性、不透明度、间距、已通过标记、引导标记、目标悬浮效果、HUD 位置以及自定义图标集。

兼容性

• 需要星露谷物语 1.6.14 或更高版本以及 SMAPI 4.1.0 或更高版本。
• 基于星露谷物语 1.6.15 和 SMAPI 4.5.2 构建。
• 每个安装的实例只控制其本地的农夫——无需共享多人游戏队列或对等消息。
• 自动与兼容的数据驱动和探测器兼容的原版或 Modded 机器配合使用。
• 游戏玩法使用公开的 SMAPI 和游戏 API。唯一的 Harmony 钩子是针对 ChoreTrail 自身 GMCM 页面标签的窄范围渲染器。
• 其他模组可以通过公共的 ChoreTrail API 添加自己的功能和执行器。

重要说明

• 计划默认保持在单一地点内，并在你传送时清除。
• 未知的自定义对象不会被处理，除非它们暴露了支持的游戏协议或在 ChoreTrail 中注册了功能提供器。
• ChoreTrail 会等待 NPC 并围绕他们重新规划路线，但不会尝试预测他们的日程。
• 任何具有破坏性或模糊不清的操作默认都会等待你的确认。
• ChoreTrail 已发布并经过测试，但有时仍会出现错误。如果你遇到可复现的问题，请在 Bugs 版块中报告。

---

为星露谷物语社区制作，作者 [b]xzqute[/b]