模组:创建 SMAPI 模组

“ “我这里还有很多事情需要处理。” — 罗宾 不完整的翻译 本文或部分尚未完全翻译成中文。 欢迎您通过编辑帮助其建设。 最后编辑1059 Studio于2021-04-12 10:15:09.

←目录

要为游戏创建 SMAPI 模组？教程就在这。要使用模组，请参阅 使用教程。要创建内容包模组，请参阅 模组:Content Patcher

介绍

什么是 SMAPI 模组？

SMAPI 模组 使用改装接口来扩展游戏逻辑。可以在游戏中发生某些情况时做出响应（例如，将对象放置在世界中），定期运行代码（例如每个更新周期一次），更改游戏的资源和数据等。SMAPI 模组使用 C＃ 编写，使用 .NET Framework 和 Stardew Valley 将 XNA / MonoGame 用于游戏逻辑（绘制到屏幕，用户输入等）。

为什么模组使用 SMAPI？

SMAPI 可以做许多事情，例如：

1. 将模组加载到游戏中。没有 SMAPI 就无法加载代码模组。
2. 提供接口和事件，能够以其他方式与游戏互动。有一些简化的接口，可用于更改游戏资源/数据，玩家配置，转换，反映等。这些内容将在本指南的后面部分介绍。
3. 在跨平台兼容时进行重构，这样一来就不必担心游戏在 Linux/Mac/Windows 版本之间的差异。
4. 重构模组以更新它。在常见情况下，SMAPI 会检测并修复游戏更新所破坏的模组代码。
5. 拦截错误。如果模组崩溃或发生错误，SMAPI 将拦截该错误，在控制台窗口中显示错误详细信息，并且在大多数情况下自动恢复游戏。这意味着减少游戏意外崩溃，并且可以更轻松地解决错误。
6. 提供更新检查。当有新版本可用时，SMAPI 会自动提醒玩家。
7. 提供兼容性检查。SMAPI 会自动检测模组何时不兼容，并在它导致问题之前将其禁用，以防止游戏爆炸。

我能制作一个模组吗？

是的！本指南将帮助你逐步创建一个简单的模组。然后你可以继续学习，让它做您想做的事即可。 如果你是编程新手，许多模组开发人员开始时几乎没有或完全没有编程经验。如果你下定决心，当然可以沿途学习，但是您应该为陡峭的学习曲线做好准备。刚开始时不要太过于自信，弄清楚它的时候，最好从一个小的模组开始。一开始很容易变得不知所措并放弃。模组社区非常热情，所以不要害怕问问题！

如果你已经具备编程经验，那应该没问题。具有 C＃ 或 Java 的编程经验将使事情变得容易，但这并不重要。如果不熟悉 C＃，则可以浏览下面的“学习C＃”参考资料以填补所有空白。

Can I make a mod without SMAPI?

Yep. Many SMAPI mods support 'content packs', which let you provide JSON text files, images, etc which they use. For example, you can use Content Patcher to edit the game's images and data with zero programming needed. The rest of this guide is about creating a new SMAPI mod; for content packs, see Modding:Content Patcher (or the mod documentation if creating a content pack for a different mod).