【星露谷】汉化 SMAPI 的教程（给有时间肝的开发者）

全网首发，汉化 SMAPI 最专业教程，是的你没有看错，汉化 SMAPI，不是汉化模组。我自己实在没有心思去汉化 SMAPI 了，所以写个教程希望有时间肝的人能去做。

首先声明汉化 SMAPI 所需的技术和条件：已经能够熟练安装 SMAPI、对 Windows 操作熟练、熟悉程序相关概念、对英语无抗拒（能熟练运用机翻即可）、对代码无抗拒（不会写代码无所谓）、硬盘有好几个 GB 空间可以浪费、全程需要网络。

汉化 SMAPI 只有一种方法：工程重编译，而且每次更新都需要重新来过，如果你打算做，请做足心理准备。本文演示所用环境：Windows 10 专业版 22H2、SMAPI 3.18.2

官网地址：https://visualstudio.microsoft.com/zh-hans选择下载 Community 社区版

等待安装程序安装完毕后进入界面应该会自动进入【工作负荷】的选项卡界面，如果没有就手动点一下相应的选项然后勾选【.NET 桌面开发】

在右侧的可选内容中，按需勾选

转到【单个组件】选项卡页面，必须勾选【.NET 5.0 Runtime】

（可选）建议勾选【.NET 可移植库目标包】

完成后点击窗口最右下角的【安装】或者是【修改】等待下载并安装完成，首次启动请根据自身需要调整设置

可在 Steam 游戏属性中移动安装文件切勿使用盗版资源仅限 Steam 平台，WeGame 平台的版本不可用于汉化 SMAPI

确保游戏为最新版本确保你将要汉化的 SMAPI 版本与已安装的 SMAPI 版本保持一致确保可以用 SMAPI 正确启动游戏

仓库地址：https://github.com/Pathoschild/SMAPI转到 Release 发行版，下载目标版本的 Source code(zip)

解压下载的压缩包

在 src 文件夹中，打开 SMAPI.sln 文件

等待 Visual Studio 完成自动还原

确保【解决方案资源管理器】中所有项目已加载

确保【错误列表】中的错误项为0，警告信息除框架过期外没有其他兼容性问题

汉化之前，必须确保可以正确生成，否则一切都是徒劳点击顶部菜单栏【生成】菜单中的【生成解决方案】

必须生成成功，否则请先解决所有错误

SMAPI 工程所用编程语言为 C#，不需要你会写，你只需要找到每个需要翻译字符串然后更改内容即可，如果能看懂基础语法最好

首先汉化安装程序，展开 SMAPI.Installer 项目

Program.cs 文件中，需要汉化的地方例如

以这种橙棕色显示的文字为字符串，语法上两个英文的双引号中间是字符串，但注意不是所有的字符串都可以汉化，很多地方只是在传递值，一旦修改直接报废，相信做汉化工作的你一眼就能看出哪些是需要汉化的内容。例如上图，可以汉化成如下

InteractiveInstaller.cs 文件中，是安装程序的主体流程，你会找到很多熟悉的内容，依次汉化即可

SMAPI 项目是 SMAPI 的主体程序，此项目中需要汉化的地方很多，而且非常分散，请保持耐心仔细寻找，我在这里列出来没有任何意义，他可能在未来的更新中改动。如果你实在找不到要翻译的句子在哪里，尝试在整个解决方案中搜索

首先还是确保可以生成成功，错误列表里这些语法改进可以全部忽略（只要能跑，就不要去瞎动）

回到文件夹，找到 prepare-install-package.ps1 文件

右键【使用 PowerShell】运行

请务必正确输入目标 SMAPI 版本号，否则将导致一连串的问题

等待生成完毕，时间较长，自动程序运行期间请勿点击窗口内，否则会被暂停，标题栏将会显示【选择 Windows PowerShell】，鼠标右键窗口内可以继续自动程序

生成完成后，窗口自动关闭

回到文件夹根位置，将会多出一个 bin 文件夹，这就是生成的安装程序

此时运行 install on Windows.bat 会报错丢失 install.dat 文件

这个 dat 文件需要手动打包，找到位置：internal\windows\bundle

这个 bundle 文件夹就是 install.dat 文件所包含的内容，现在需要将这些内容以 zip 格式保存到 install.dat 文件，这里注意操作，千万千万千万切记切记切记不要套娃，一旦套娃，全体用户将为你而闪烁（bushi）

直接选中所有内容，右键选择第三方压缩软件的添加到 zip，切记不要选成其他格式了，否则 SMAPI 无法解压

将文件名改为 install.dat

将该文件放到上一级文件夹，可以直接拖到上一级

回到上一级文件夹，此时 bundle 文件夹不再需要，删除它即可

按照此操作，linux 和 macOS 两个文件夹内的操作同理，但是切记不要把 Windows 的 install.dat 文件直接复制过去了，否则全体用户又要为你而闪烁了（bushi）

此时再运行 install on Windows.bat，即可正常运行了

现在你可以将该文件夹压缩成 zip 来发布到网络上