模组:创建 SMAPI 模组

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

←目录

要为游戏创建 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＃”参考资料以填补所有空白。