模组:迁移至游戏本体1.3.36

仍需完善

该页面内容由于以下原因仍需进一步完善。
帮助我们扩充内容：

• 机翻修正，链接补齐

制作SMAPI模组

---

• 入门
• 游戏基本架构
• 测试和疑难解答
• 发布
• SMAPI中的API

  基本API：

  • Mod structure（模组结构）
  • Manifest（清单）
  • Events（事件）
  • Config（配置）
  • Content（内容）
  • Data（数据）
  • Input（输入）
  • Logging（日志）
  • Reflection（反射）
  • Multiplayer（多人）
  • Translation（翻译）
  • Update checks（检查更新）
  • Utilities（工具）

  进阶API:

  • Content packs（内容包）
  • Console（控制台命令）
  • Integrations（模组整合）
  • Harmony

• 更多指南

← 模组:目录

当前页面编写的内容面向模组的开发者。模组玩家请阅读模组:模组兼容性。

本页面说明了如何更新你的模组，以兼容星露谷物语 1.3。

SMAPI 模组

大多数 SMAPI 模组不受影响。如果你的模组损坏了，你可能只需要重新编译一个新的 DLL 并发布它即可。（别忘了更新 manifest.json 的版本！）

Content Patcher 内容包

自定义地图图块集

如果你使用 Action: Load 为地图提供自定义图块集，请确保它位于 Maps 文件夹中。例如：

// 不正确
"Target": "Tilesheet"

// 正确
"Target": "Maps/Tilesheet"

矿井图块集

你可能会在你的内容包中看到这个错误：

Microsoft.Xna.Framework.Content.ContentLoadException: Error loading "Maps\mine". File contains xTile.Map but trying to load as Microsoft.Xna.Framework.Graphics.Texture2D.

这是因为 Content/mine.xnb（一个图块集）在星露谷物语 1.3.36 中被删除了，所以游戏会尝试从 Content/Maps/mine.xnb（一个地图）加载它。

你需要更改图块集引用来修复它。（这些说明假设地图文件已解包，并位于内容包内的 assets 子文件夹中。）

1. 如果你的内容包文件夹中已经有一个 mine.png 文件，请删除它。
2. 解包 Content/Maps/Mines/mine.xnb。
3. 将 mine.png 复制到 assets/mine.png 和 assets/Mines/mine.png。
4. 在 Tiled 中打开 .tbin 文件。
5. 在“图块集”窗格中，点击矿井图块集的标签，然后点击底部的编辑图标（看起来像一个扳手）。这应该会在一个单独的标签页中打开图块集。
6. 在顶部，点击图块集 > 图块集属性。这应该会打开一个“属性”窗格。
7. 点击“图像”字段，点击出现的“编辑”按钮，然后在打开的窗口中点击“浏览”。
8. 选择 assets/Mines/mine.png 文件。
9. 保存你对地图的更改。
10. 删除不再需要的 assets/mine.png 文件。

就是这样！在发布前，别忘了从内容包文件夹中删除 assets/mine.png（除非你自定义了它），这样 Content Patcher 就会加载游戏提供的那个文件。

Modding:Migrate to Stardew Valley 1.3.36