简介

ChaosMusicPlayer 是一个用于便捷播放音乐的 Minecraft 服务端插件

特点:

• 无需客户端安装任何mod
• 可以播放任意音乐
• 多人一起听
• 便捷的自定义设置

兼容性说明:

• 已确认 1.13.x 及以下版本可以运行但音质全损
• 已确认兼容 1.19, 1.18.2, 1.16.5
• 理论兼容 1.16.x ~ 1.19.x
• 1.14.x 到 1.15.x 不确定功能兼容性 可以自行测试
  • 注: spigot 1.15.x 及以下不支持依赖库下载 需要修改依赖设置后重新打包
• 注: 1.16.5 及以下非完全兼容 音质会略微降低

注:

• 对音质有要求的可以使用 客户端mod
  • 需要以下版本或更高的 fabric
    • fabric 1.18.2
    • fabric loader 0.14.8
    • fabric-api 0.59.1+1.18.2
  • 前置 Fabric Language Kotlin
• 因实现方法受 Minecraft 同时播放声音数(247)的限制 造成播放复杂音乐时噪音较多

BUG反馈, 建议:

• 交流群: 263798831
• GitHub Issues

下载:

• GitHub Releases

使用教程:

1. 下载后放到 任意 文件夹里
2. 使用 jre 运行
   • 注: 需要安装有ffmpeg(见下方获取wav文件的第一步)
3. 运行后找到生成的 generateResourcePack 文件夹
4. 进入 generateResourcePack/output
5. 其中的 ChaosMusicPlayer.zip 就是要在客户端加载的资源包
6. 将插件放到 服务器目录/plugins 文件夹里
7. 启动服务器
8. 将音乐文件放到 服务器目录/plugins/ChaosMusicPlayer/musics 文件夹里, 仅限wav文件(获取方法见下文)
9. 服务器中输入 /cmp list 即可列出音乐
10. 服务器中输入 /cmp help 可以查看所有命令的详细用法

获取wav文件:

1. 安装 ffmpeg
   1. 下载
   2. 解压到一个不常移动的目录
   3. 添加 解压出来的文件夹 里的 bin文件夹 到 环境变量
2. 打开 cmd 或 shell
3. 运行 ffmpeg -i 输入文件 -c:a pcm_s32le 输出文件.wav
   • 将输入文件替换成下载的音乐文件的路径
   • 输入文件替换成和输入文件一样的路径再加一个.wav即可
   • 注意如果路径中有空格的话需要在前后添加英文双引号"
   • 例: ffmpeg -i C:\test.mp3 -c:a pcm_s32le C:\test.mp3.wav
   • 例2: ffmpeg -i "C:\te st.mp3" -c:a pcm_s32le "C:\te st.mp3.wav"
4. 将输出的wav文件放到 服务器目录/plugins/ChaosMusicPlayer/musics 即可

权限节点:

• chaosmusicplayer.modify 拥有的玩家可以修改所有音乐的参数 默认 op 拥有
• chaosmusicplayer.settings 拥有的玩家可以查看所有音乐的参数 默认拥有

更新记录:

• 2022-11-26 1.1.2
  • 修复:
    • 修复服务端与客户端速率不同步导致的经常性缓存欠载问题
    • 修复主音量调整无效的问题
  • 优化:
    • 理论上通过资源包播放时爆音会降低
• 2022-10-27 1.1.1
  • 修复:
    • 修复非 macOS 下播放异常的问题
    • 修复特定情况下播放卡顿的问题
  • 优化:
    • 优化缓存控制 降低卡顿次数
    • 降低 fabric loader 的版本需求至 0.14.8
• 2022-10-24 1.1.0
  • 新增:
    • 新增客户端 Fabric MOD 大幅优化音质
• 2022-07-25 1.0.3
  • 修复:
    • 重写正弦波生成函数 以优化爆音
• 2022-06-11 1.0.2
  • 优化:
    • 优化兼容性 添加 1.16 的兼容
  • 修复:
    • 修复多声道音频音量不正确的问题
• 2022-06-03 1.0.1
  • 优化:
    • 优化文件大小
  • 修复:
    • 修复支持 Minecraft 1.17 或 Java 11 但实际无法使用的问题
      • 注: 修复后 Minecraft 1.17 仅理论上支持 未经测试
• 2022-06-02 1.0.0
  • 新增:
    • 音乐播放
      • 文件放至 plugins/ChaosMusicPlayer/musics 文件夹内
      • 必须wav格式 线性pcm_signed 或 线性pcm_unsigned
      • 推荐使用 ffmpeg 转换 ffmpeg -i 输入文件 输出文件.wav
    • 音乐参数调节
    • 一起听功能
    • 资源包生成
      • 在文件目录下执行 java -jar ChaosMusicPlayer-1.0.0.jar

许可协议:

GNU Affero General Public License Version 3