SDV追踪器

SDV Tracker Sync

一个用于 SDV Tracker（一个100%完成度网页清单）的配套模组。 在每个游戏日结束时，它会将你已完成的内容推送到你的追踪器账户，从而让清单自动更新，无需你再手动逐项勾选。

此模组本身不执行任何操作。 它需要在 sdv.fullclear.io 注册一个免费账户——模组携带该账户的令牌，没有令牌则无法发送任何数据。如果你正在寻找游戏内覆盖层或独立追踪器，此模组并非此类工具。

---

追踪器能为你提供什么

• 万物一清单。 博物馆、所有鱼类、全部收集包、制作与烹饪配方、全部130颗金色核桃、心动事件和村民。物品按来源分类排序，标明出处与时间，并标记出常见遗漏项。
• 合作模式。 Stardew 将整个合作农场保存在主机存档中，因此农工没有自己的存档。主机的同步会填充所有人的数据；每位农民都有独立列，每一行显示谁完成了什么。
• 实时世界地图。 游戏过程中，它会绘制农场中每个人的位置，包括姜岛。
• 未来一周预览。 作物与机器成熟时间、天气、节日、生日，以及“酱料女王”的教学内容——均基于你的实际存档，而非通用日历。
• 礼物追踪器，可记录本周你已送礼的对象，以及每位村民的喜好。
• 只读分享链接，可发布到任何地方，不含密码、令牌，无任何风险。

---

模组发送的内容

绝不会发送你的存档文件。 模组仅读取内存中的已加载游戏，并仅发送派生事实。具体如下：

• 每天结束时： 已完成清单项、种植内容及成熟时间、机器正在生产的产品、你的送礼冷却时间、技能等级，以及农民的名称与外观（供网站绘制）。在合作农场中，主机会为每位农工发送相同信息。
• 游戏过程中（若你保持开启）： 你的位置坐标、生命值与体力、游戏内时钟、手持物品与背包内容。这用于绘制实时地图。这些数据从不存储。 服务器仅在内存中保留两分钟后即遗忘。将 StreamLiveState 设为 false 可禁止发送实时数据，仅保留存档导入功能。

---

安装方法

1. 安装 SMAPI 4.0.0 或更高版本。
2. 在 sdv.fullclear.io 注册一个免费账户。
3. 将此压缩包解压至 Stardew Valley/Mods/ 目录。
4. 在追踪器网站上，打开 Co-op Party → Sync from the game，然后点击 Download config.json。你的服务器地址和账户令牌已包含在该文件中。
5. 将该文件放入 Stardew Valley/Mods/SdvTrackerSync/ 目录，替换模组自行生成的文件。
6. 加载你的存档。首次同步将在你睡觉时进行，或在 SMAPI 控制台中运行 sdvtracker_sync 立即同步。

追踪器上的同一区域会显示上次同步时间，一目了然是否正常工作。

---

设置项

全部位于 Mods/SdvTrackerSync/config.json 中。追踪器会为你自动填写；以下是各开关的含义。

• ServerUrl — 你的追踪器地址。默认为 https://sdv.fullclear.io。
• Token — 你账户的同步令牌。
• SyncOnDayEnd（true）— 在一天结束时同步。设为 false 则仅通过控制台命令执行。
• SyncFarmhands（true）— 发送合作农场中其他农民的数据。仅主机可操作。
• SyncProducers（true）— 木桶、酒桶、树液采集器及其可收取时间。
• SyncGifts（true）— 保持礼物追踪器同步。
• StreamLiveState（true）— 游戏过程中报告你的位置。设为 false 则地图上永远不会显示你。
• LiveIntervalMs（3000）— 报告位置的频率，单位为毫秒。
• AutoBind（true）— 自动认领你在已加入农场中的农民身份。
• VerboseLogging（false）— 用于排查同步未按预期执行的问题。

控制台命令

• sdvtracker_sync — 立即推送，无需等待一天结束。
• sdvtracker_reload — 重新读取 config.json，无需重启。
• sdvtracker_live — 显示实时数据流是否运行，以及此游戏代表哪位玩家。
• sdvtracker_bind — 在已加入的农场中，指定你所扮演的农民身份。

---

多人游戏

主机应安装此模组。 Stardew 仅在主机电脑上保存游戏，因此只有主机的同步能查看所有农民的进度。农工无需安装，但安装后可为该玩家增加实时位置显示，并允许其自动认领自己的农民身份。

---

兼容性

• Stardew Valley 1.6+，SMAPI 4.0.0+
• Windows、macOS、Linux
• 单人及多人模式
• 无已知冲突。此模组不修改游戏，仅读取游戏状态并发出网络请求。

保持更新： 追踪器会在 Sync from the game 页面提示你的安装版本落后，且模组会在每次加载存档时记录一条 SMAPI 警告（若存在新版本）。

---

卸载方法

删除 Mods/SdvTrackerSync/ 目录。此模组不会向你的存档写入任何内容，也不会在游戏内做任何更改，因此存档不会受到影响。你的追踪器账户及其中所有数据将保持原样；你可以继续手动勾选或在网站上导入存档文件。