模组:目錄

模組是改變星露谷物語的文件包。模組可以添加功能（例如在地圖上顯示 NPC）、改變遊戲機制（例如讓柵欄腐爛得更慢）、進行外觀更改（例如讓你的房子看起來像霍比特人的家）等等。

使用指南

模組使用指南

• 入門
• 疑難解答
• 按鍵綁定
• 兼容性

• 常見問題解答
• 尋求幫助或提出問題
• 加入社區論壇
• 使用 XNB 模組 (不推薦)

創建模組

模組大致可以分為兩類：C# 模組和內容包（依賴於 C# 模組的格式化文本文件）。內容包可以製作新的 NPC、編輯地圖、添加新物品、添加商店等，而 C# 模組可以改變基本的遊戲機制。通常，從製作內容包開始是最簡單的，因為不需要學習如何使用 C# 進行編程。

使用 JSON 創建內容包 為諸如 Content Patcher 之類的框架創建內容包

使用 C# 創建 SMAPI 模組 創建 SMAPI 模組，包括完整的 SMAPI API 和事件參考 如果您不會 C# 而會 Visual Basic，則可以放心使用另一門語言，社區中已經存在使用該語言編寫的模組且運行正常

翻譯模組 為遊戲支持的任何語言提供模組翻譯（對於模組開發者如何啟用和請求翻譯）

• 在查找特定的資料嗎？不妨試着 搜索 模組 命名空間。
• 尋求幫助或提出問題
• 加入社區論壇
• 開原始碼

高階主題

• SMAPI API 參考
• Modding tutorials wiki
• 常用方法（SMAPI 模組）
• 編輯 XNB 文件
• IDE 參考

• 遊戲：
  • 遊戲基本架構（Game fundamentals）
  • 成就（Achievements）
  • 音頻（Audio）
  • 自定義語言（Custom languages）
  • 控制台命令（Console commands）
  • 世界地圖（World map）
  • 遊戲狀態查詢（Game state queries）
  • 物品查詢（Item queries）
  • 觸發動作（Trigger actions）
  • 模板字符串（Tokenizable strings）

• NPC：
  • 概述（Overview）
  • 對話（Dialogue）
  • 事件（Events）
  • 禮物喜好（Gift tastes）
  • 任務（Quests）
  • 行程（Schedules）

• 物品：
  • 物品（Items）
  • 農作物（Crops）
  • 果樹（Fruit trees）
  • 機器（Machines）
  • 配方（Recipes）
  • 野樹（Wild trees）

• 地點和地圖：
  • 地圖（Maps）
  • 農場數據（Farm data）
  • 節日（Festivals）
  • 魚（Fish）
  • 地點（Locations）
  • 電影院（Movie theater）
  • 博物館數據（Museum data）
  • 天氣（Weather）

• 其他內容：
  • 藍圖（Blueprints）
  • 效果（Buffs）
  • 收集包（Bundles）
  • 玩家貼圖（Farmer sprite）
  • 圍欄（Fences）
  • 魚塘（Fish Ponds）
  • 信件（Mail）
  • 商店（Shops）
  • 特殊任務（Special orders）

• 其他實體：
  • 動物（Animals）
  • 怪物（Monsters）
  • 寵物（Pets）

• 專用（通常只用於其他頁面的連結）：
  • 公共數據字段（Common data field types）

版本遷移指南

發行版本	發行時間
SMAPI 2.0	2017.7
遊戲本體 1.3	2018.5
遊戲本體 1.3（XNB 更改）	2018.5
遊戲本體 1.3.36	2019.3
遊戲本體 1.4	2019.11
SMAPI 3.0	2019.11
遊戲本體 1.5	2020.12
在 Windows 上使用 64 位遊戲版本	2021.5
Harmony 2.0	2021.7
遊戲本體 1.5.5	2021.8
SMAPI 4.0	2024.3.19
遊戲本體 1.6	2024.3.19

另請參閱

• 像素藝術資源：
  • 星露谷藝術風格指南
  • Pixel Joint 上的像素藝術教程
  • Medium 上的像素藝術指南
• 內容包資源：
  • 出色的 ID 電子表格
  • 自定義 NPC 節日圖塊位置
• 工具：
  • SMAPI 模組兼容表（你可以編輯它）
  • SMAPI 日誌分析器
  • JSON 驗證器
• Kdau 的關於 Android SMAPI 修改的筆記
• Dem1se 的模組 UI 入門指南

討論

• 星露谷物語百度貼吧 — 為國內網友提供一個可以向大家分享自製模組的心得、提出問題、愉快議論話題的論壇，很多中文大佬都在這裏溜達。
• Discord 頻道 — 提出問題、獲得幫助，與模組製作者和 SMAPI 開發人員討論。