Clef

基础

 

这个模组添加了播放 ABC 文件的乐器。

 

默认情况下，模组自带多首 ABC 曲目，并且还添加了 Starbound 中的 32 种乐器（已获得许可）。

 

Clef 会读取 /mods/clef/abc 文件夹中的所有 ABC 文件，以及 /mods/clef/instruments 文件夹中的乐器，因此欢迎添加自己的 ABC 曲目或乐器包。此外，Clef 还能够读取 .zip 格式的 Starbound 整合包。 

 

---

获取乐器

 

进入游戏后，若要在创造模式中查看乐器，请打开物品栏，再打开“乐器”创造模式物品栏标签页。在那里，你可以找到 Clef 成功加载的所有乐器。 

 

而在生存模式中，有三种（可配置的）方式可以获得乐器：结构中的箱子战利品、Mob 掉落物，以及乐器播放器（稍后会详细介绍）。

 

乐器可以是双手持握或单手持握。默认配置下，所有双手持握的乐器都会变为单手持握，让你在冒险时也能将它拿在副手栏位！

 

---

使用乐器

 

手持选好的乐器，按下使用键即可打开一个 GUI，你可以在其中选择歌曲、独奏或加入乐队演奏（可选择与其他玩家的播放进度或曲目同步），还可以强制模组重新加载所有 ABC 文件或乐器，最后点击“播放”按钮。双击歌曲列表中的歌曲即可立即开始播放。

 

演奏乐器时，如果是双手持握的乐器，双手都必须空闲才能演奏；如果是单手持握的乐器，则会优先使用主手演奏。若要停止演奏，只需再次使用乐器，或手持乐器攻击即可。

 

右键点击乐队名称，可以循环切换当前正在演奏的乐队。

 

请注意，如果 ABC 文件数量很多，不要重新加载它们；这会导致游戏短暂卡顿。

 

将鼠标悬停在乐器上时按住 Shift，可以查看乐器所属的包，以及该乐器的物品名称。

 

---

乐器播放器

 

乐器播放器的合成配方如下：木板、一个箱子、一个音符盒和一个红石火把。

 

放置后，手持乐器右键点击方块即可将乐器放入其中。乐器播放器最多可容纳 9 件乐器同时演奏，前提是为其提供红石电源。

 

再次右键点击它，会看到一个与乐器 GUI 类似的界面，不过还增加了一些功能，最显眼的是右下角的乐器播放器储存空间。点击其中任意乐器，即可将它弹出到方块顶部。

 

歌曲列表底部还有两个按钮，可用于添加和查看播放列表。查看播放列表时，你可以使用随机播放、循环播放等常见播放列表设置。

 

 

使用乐器播放器制作乐器

 

要使用乐器播放器制作新乐器，你需要在乐器播放器中放入 9 件乐器，然后用一张名称为你想制作的乐器物品名称的命名牌右键点击它。要查看乐器的物品名称，请在物品栏中将鼠标悬停在乐器上并按住 Shift。物品名称与乐器名称不同。

 

你只能制作已加载到你的游戏中或服务器已加载的乐器（可配置）。

 

---

获取更多曲目和乐器

 

Clef 的运作方式是将曲目和乐器存储在模组之外的实际文件中。因此，你可以轻松地将想在游戏中聆听的任何 ABC 文件放入 abc 文件夹，也可以将 Starbound 模组包（zip 格式）放入 instruments 文件夹来添加新乐器。

 

网上有许多 ABC 曲库，尤其是因为 Lord of The Rings Online 和 Starbound 都能播放这些文件。

 

你也可以解包 Starbound 模组的 pak 格式文件，再重新压缩为 Clef 可以读取的 zip 格式。请确保文件结构遵循 Starbound 的文件结构，并且压缩包根目录中包含 sfx、items 文件夹。

 

---

已知问题

 

ABC 文件可能会出现音准或节奏偏差，或播放不正确

音准略有偏差：我已尽力查找原因，但我认为这是声音系统在调整曲调音高时遇到了问题。

节奏略有偏差：Minecraft 每秒最多运行 20 个刻。我找到的一些 ABC 文件中，音符时值远短于此。能做到节奏只有轻微偏差，已经是我能实现的最佳效果。

播放不正确：我使用的 ABC 解析器是从头编写的，因此解析某些文件时难免会出现问题。如果曲子播放不正确，请给我留言（并附上 ABC 文件），我会看看能做些什么。目前这个模组不支持每个 ABC 文件包含多首曲子，也不支持 ABC 文件中的诗节/声部。

 

暂停游戏不会暂停特定曲子

我觉得这是 Minecraft 本身的问题。只要反复暂停和取消暂停游戏，直到曲子暂停即可。

 

请在 GitHub 上报告你发现的其他问题。