介绍

这个 Mod 可以让你通过编辑游戏中的各种触发器来播放特定的音乐。

• 使用方法

6.0版本以前

1. 运行一次游戏来生成必要的配置文件及文件夹；

2. 确保你的音乐文件的后缀是：ogg、wav、mp3。wav和mp3的文件将自动转换为ogg（转换需要一定的时间）；

3. 若文件名中出现大写字母、空格以及中文，则文件可能无法被读取；

4. 所有的音乐文件都放在“config/MusicTriggers/songs/assets/musictriggers/sounds/music”中；

5. 5.0 及以上的版本在游戏中添加了可视化编辑界面（默认R键打开界面）。

6.0版本及以后

1. 运行一次游戏来生成必要的配置文件及文件夹；

2. 音乐文件可以是一下任意一种格式：MP3、 FLAC、 WAV、Matroska/WebM (AAC, Opus or Vorbis codecs)、MP4/M4A (AAC codec)、OGG streams (Opus, Vorbis and FLAC codecs)、AAC streams、Stream playlists (M3U and PLS)；

3. 若文件名中出现空格或中文，则文件可能无法被读取；

4. 所有的音乐文件都放在“config/MusicTriggers/songs”中；

5. 5.0 及以上的版本在游戏中添加了可视化编辑界面（默认R键打开界面）。

你可以在官方维基上了解更多信息。

已知问题

6.3版本

• 会因为无法连接twitch导致游戏崩溃

6.0版本以前

• 1.16 以上的版本的唱片可能出现材质错误的问题。

• 音乐文件可能在转换成 ogg 格式时出现问题。

6.0版本及以后

• 无法调节“Pitch”。

• ”Loops“和”custom discs“无法在可视化编辑界面中进行设置。

• 歌曲的音量可能会被限制在100%而继续无法提高。

• 编辑界面中”play_once“的值并不可以为4、5和6。

• 自定义声音引擎（The custom sound engine ）目前可能只能在系统默认音频设备上播放。

• ”Image cards“目前只接受静态png图片。
  

为什么我的音乐不能播放？

以下是一些与此有关问题的可能解决方法（6.0版本以前）：

• 确保你的歌曲文件以 ogg、wav 或 mp3 为后缀（自动转换成 ogg 的功能目前并不完善，所以最好自己转换）。

• 确保配置文件中的歌曲名称以及音乐文件的名称都是小写的。

• 你的音乐文件可能损坏了，检查日志中是否有一行写着 “Ogg header not recognized in method 'readHeader'.”，如果你是从 wav 或 mp3 格式转换成 ogg，可以尝试重新转换一下。