申请会员ID：黎明落幕

1、申 请 I D：黎明落幕
2、个人邮箱：2565704424@qq.com
3、原创技术文章：
免责声明：本文仅基于Steam正版《星露谷物语》搭配官方开源SMAPI框架进行技术学习交流；不分享游戏本体、MOD资源、破解相关内容，全部操作仅适用于正版单机离线环境，禁止商用。文中所有故障解决方案均为个人长期实操整理总结。
市面上存在大量星露谷物语模组基础安装教程，大多只讲解注册站点、资源下载、模组部署基础步骤。本文不再复述基础安装流程，重点记录模组部署完成后高频出现的程序兼容、配置文件故障、存档数据异常、外设按键冲突等问题的实操排查方案，所有方案均为本人实际踩坑后验证可行。
Mods文件夹指的是Stardew Valler文件夹里面的Mods文件夹。

一、模组部署过程容易被忽略的隐性坑点

1.大量功能性模组需要配套前置模组支持，典型示例：内容补丁器为高频必备功能组件，需要放置在Stardew Valley\Mods目录内；而SMAPI属于独立外部运行框架，承担模组加载调度工作，不能放入Mods文件夹，很多新手容易混淆两者存放位置。

2.肖像替换美化模组与其他模组处理不同。如果都装模组了，那么大部分人都会选择把原版npc的肖像替换掉，我以BaZhua's  Marriable Men Portraits序号20236
美化举例，与众不同的是它不是放入Mods文件夹，而是放入"Stardew Valley\Content\Characters"文件夹，替换掉原版的.xnb文件

3.大量海外开发模组原生仅支持英文，想要正常显示中文，需要配套对应的汉化资源。以村民扩展对话模组（Nexus序号2544）为例，本体为英文资源，需要搭配序号14426汉化补丁使用。

怎么知道这个模组是不是自带汉化？
①查看模组文件夹内的 i18n 文件夹有没有zh.json文件。

图1
模组本体通常只有一个 default.json (英文原版)。汉化补丁通常包含一个 zh.json 文件。

图2
汉化目的就是让模组在读取时，能识别并加载 zh.json 里的中文内容。
②如果是content.json，可以直接用记事本打开，如果里面是中文，则汉化完成，不是中文就需要去N网下对应汉化模组然后替换。

图3

通用两种汉化部署方案：
方案一：模组本体文件夹、汉化补丁文件夹，二者同时放入Mods目录；
方案二：提取汉化补丁内zh.json，复制至模组本体的i18n文件夹内。

二、存档数据异常的修复流程
游戏运行卡死、交互功能失效很多情况由存档损坏、脏数据导致，完整修复操作流程：
按住你键盘上的 Win+ R 键，
这时屏幕左下角会弹出一个小的“运行”窗口，里面有一个输入框，输入代码 %AppData%\StardewValley\Saves

第一步：备份
在进行任何修改之前，你需要把你当前的存档文件夹原样拷贝一份到桌面。
找到这个文件夹路径：AppData\Roaming\StardewValley\Saves\满天星(农场名字)_443657102
备份完成

第二步：清理损坏的存档点
进入原来的存档路径：AppData\Roaming\StardewValley\Saves\满天星_443657102。
在文件夹内找到那个显示 0 KB 的文件，直接右键删除它，或者直接把它移到回收站。

第三步：恢复备份文件（替换数据）
我们将使用最近一次成功的自动保存备份，打开该文件夹，选中里面的所有文件（按 Ctrl + A 全选）。
按 Ctrl + C 复制这些文件。
回到上一层，即 满天星_443657102 这个文件夹的根目录。
按 Ctrl + V 粘贴。
电脑会提示你“目标包含同名文件”，选择替换目标中的文件。


三、实操总结：容易被教程遗漏的兼容性与外设问题

1. 模组维护周期与游戏版本适配
资源站点存在大量高热度但停止维护的旧模组。随着游戏官方持续版本更新，多年未更新的模组会出现兼容性故障。例如carry chest模组热度较高，但作者2021年后停止更新，无法适配当前最新游戏版本。下载模组前建议留意作者最后更新时间，规避版本不兼容问题。

2. JoyToKey实现手柄多热键扩展方案，主要针对装了多个模组，手柄按键不够用，可以一个按键出现两个效果也不影响使用：
手柄分为Switch模式、Xbox 360模式，主要介绍xbox模式：
局内可以更改按键效果，需要加绑定按键的模组。但是会出现有些按键设置了但是按了没反应，需要下载映射软件JoyToKey。需要把手柄切换为xbox模式，按下手柄的某个按键，在JoyToKey闪烁，说明连接上了。

图4
这个软件效果是针对多模组想用手柄玩的人，做到不浪费手柄的按键，假设在绑定按键中，设定键盘上的字母P是召唤拖拉机，在JoyToKey找到多余按键，把原本的None改为P，这样每当按下鼠标多余按键，会相当于按下键盘P键以实现手柄控制。

图5→图6→图7

图5


图6

图7

我目前换了两个手柄，对于两个手柄，都只有两个多余的键位。
又比如我加了事件查询的模组，快捷键是键盘Q键，手柄上→是人物向右走，但是人物走动已经由L-Stick摇杆控制，↑↓→←很少用到，那可以在JoyToKey中设置→键绑定键盘Q键，那么用手柄时，就可以一个键位两个效果，按下→后人物会向右移动一点同时弹出事件查询，非常方便！

注：手柄上的T键、O键属于需要和其他键位混合使用的，无法作为玩游戏时候的单独键位。

四、SMAPI运行日志故障分析方法

启动游戏时SMAPI控制台红色文本代表运行报错，紫色文本代表模组存在版本更新提示。如果控制台报错内容冗长，可导出日志文本进行分析。

完整流程：
1. 找到日志文件的存储位置
SMAPI 会将每一次运行的记录自动保存在电脑上，通常路径如下：
路径：打开你的游戏根目录（即AppData\Roaming\StardewValley），找到一个名为 logs 的文件夹。

图8
文件内容：在这个文件夹里，你会看到以 .txt 结尾的日志文件，文件名通常包含日期和时间。
2. 使用 SMAPI 的官方在线解析工具
如果你想让别人帮你分析这些红字报错，最标准的方法是上传到官方日志站：
打开浏览器，进入 smapi.io/log。
按照网页上的指示操作：
你可以通过输入你日志文件的路径上传。
或者直接将 logs 文件夹中最近生成的那个 .txt 文件内容复制并粘贴到网页上的文本框中。
点击 "Save and parse log" 按钮。
解析完成后，网页会生成一个专属链接。你可以把这个链接复制给别人，别人就能直接看到你的错误信息，而不需要你自己截图或复制满屏的红字。

星露谷关于模组的问题：
①序号520的生日快乐模组，是一个玩家可以设置自己生日，npc给玩家送礼物的模组，但是它最新版本和游戏最新版本不兼容，会出现邮箱一直有封信又点不了的情况。
②序号7842邮件服务和它的前置模组序号1536邮件框架，它们会出现邮箱一直一封信点的了但是读了信还是会在邮箱里。

针对这3个模组带来的问题解决方案：
因为生日快乐模组如果装了，是在开局第一天镇长就会来问你生日，而你设置了你的生日后，这个内容就存进了游戏数据，哪怕发现这个模组会有问题把它从Mods文件夹删掉了，在你生日的那天还是会出现出现点不了的信，除非换新档，如果舍不得，必须手动修改存档文件：
按下 Win + R 键，输入 %appdata%\StardewValley\Saves 并回车。
找到当前游玩的存档文件夹（里面有名为 SaveGameInfo 和你角色名字的一长串英文文件夹）。
备份这两个文件到任意位置（防止改坏）。
用记事本打开以你角色名命名的那个文件。
在里面按 Ctrl + F 搜索关键词（如birthday或者mail），找到相关的代码段并整行删掉，保存后重新进游戏即可。

如图9搜索“mail”

如图10.图11把关于邮件两个模组选中删掉，以<string>……</string>为一个整体。


补充说明：清理生日相关代码后，游戏日历依旧残留生日标记属于正常现象；若第二年故障再次出现，重复相同流程清理遗留信息即可。

Hmily

抱歉，未能达到申请要求，申请不通过，可以关注论坛官方微信（吾爱破解论坛），等待开放注册通知。