可演奏鋼琴 - 樂器框架

讓黑暗鋼琴和立式鋼琴變得可演奏，並允許內容包向遊戲中添加樂器。

可演奏鋼琴 - 樂器框架

🎹 **讓星露谷的鋼琴活起來！** 這個模組讓你能夠用鍵盤演奏黑暗鋼琴和立式鋼琴，還能播放MIDI文件。更重要的是，它爲內容包提供了添加自定義樂器的框架！

---

🎵 安裝指南

• **安裝最新版本的SMAPI** - 前往SMAPI官網
• **下載本模組**並解壓到 `Stardew Valley/Mods` 文件夾
• **使用SMAPI運行遊戲**

🎹 使用方法

**坐在鋼琴前**，按下鍵盤上的任意鍵；使用便攜樂器時，**手持物品並左鍵點擊**。這將打開一個菜單，你可以在**自由演奏模式**和**MIDI播放模式**之間選擇。

🎼 自由演奏模式

在自由演奏模式下，只需按下鍵盤上的鍵即可播放聲音。鍵盤佈局模擬了真實的鋼琴鍵盤：

通過按下 **Ctrl**、**Shift** 和 **Tab** 鍵，你可以在低音、中音和高音之間切換，提供從C3到C9的完整音域範圍。

🎶 MIDI播放模式

在播放模式下，你可以自動播放位於模組歌曲文件夾 (`Playable_Piano/assets/songs`) 中的MIDI文件。只需從列表中選擇一個文件，播放就會開始。

💡 **注意**：如果你使用過此模組的舊版本，在1.3.0版本中歌曲文件夾已移動，你的歌曲可能不會顯示。

⚙️ 自定義設置

你可以通過更改模組本身或其他內容包添加的任何樂器的聲音來自定義模組。

🎵 更改聲音

要更改鋼琴或其他樂器的聲音，只需編輯模組文件夾中的 `config.json` 文件。語法如下：

```

"": ""

```

如果你有自定義聲音文件，將其添加到 `assets/sounds` 文件夾（僅支持 `.wav` 文件），並在配置中寫入不帶擴展名的文件名。如果沒有自定義聲音，可以使用基礎遊戲中的任何聲音，這些聲音可以在維基頁面找到。

例如，如果你想將黑暗鋼琴變成貓鋼琴，只需在配置中添加以下行：

```

"Dark Piano": "cat"

```

🎵 自定義聲音文件

添加自定義聲音文件時需要考慮以下幾點：爲了讓鍵盤與鋼琴鍵盤對齊，選定的 `.wav` 文件應該是C調，最好是C6，這樣MIDI播放的音符纔是正確的。

此外，只添加一個聲音文件將提供從C5到C7的有限音域。要獲得完整的音域支持，你需要添加兩個額外的聲音文件：一個用於低音，一個用於高音。

🛠️ 模組作者指南

如果你想在自己的模組中添加樂器，可以使用Content Patcher或模組的API。更多詳細信息請查看模組的GitHub倉庫上的文檔。

🎯 Content Patcher方法

使用Content Patcher添加自定義樂器，只需在你的 `content.json` 中添加觸發動作。這種方法適用於物品和可坐傢俱。

💻 C# API方法

如果你想要製作無法用Content Patcher添加的樂器（例如作爲地圖一部分的樂器），可以使用提供的API直接打開模組的UI。

🔊 聲音文件

模組自帶鋼琴聲音 `Mushroomy.PlayablePiano_Piano`，以及基礎遊戲中 `toyPiano` 和 `flute` 聲音的擴展音域文件。如果你沒有或不想添加自己的聲音，可以使用這些。

🔧 故障排除

如果自定義樂器似乎無法正常工作，請檢查Playable Piano文件夾中的 `config.json`。模組識別的每個樂器都應該有一行對應的聲音。如果樂器沒有出現在列表中，在SMAPI控制台中輸入 `reset_instrument_sounds` 並再次檢查配置。

✅ 兼容性

• ✅ 支持星露谷1.6.15版本（Linux/macOS/Windows）
• ✅ 支持單人遊戲和（大部分）分屏模式
• ✅ 支持多人遊戲（雙方玩家都需要安裝模組和相應的樂器聲音文件）

---

🎼 **準備好用鋼琴點綴你的星露谷生活了嗎？** 無論是即興演奏還是播放你最喜歡的MIDI曲目，這個模組都將爲你的農場生活增添美妙的音樂色彩！

查看源代碼