[MD]
只需要把一套压缩好的服务器主题歌曲放入文件包里,玩家就可以随时打开他并听歌,有音符盒UI图标,可以随时暂停,切歌,这一切都在游戏内完成!
本包是当前配套客户端正在使用的 `LocalMusic 1.0.2-test1`,适用于 Minecraft 1.6.4 的 Forge 客户端。它只在安装者自己的电脑播放本地歌曲;服务器不需要安装,也不会向其他玩家同步音乐。包内没有歌曲。
## 安装
1. 完全退出 Minecraft 和启动器,找到启动器实际使用的游戏目录。现有客户端的游戏目录是 `.minecraft`。
2. 将本包里的 `.minecraft` 文件夹内容合并到游戏目录:JAR 进入 `mods`,配置进入 `config`,歌曲目录进入 `music`。不要把整个压缩包放进 `mods`。
3. 确保 `mods` 内只保留一个 `LocalMusic` 版本。更新旧版时,先移走旧版 JAR,再放入本包的 `LocalMusic-1.0.2-test1.jar`。不要将根目录中的旧版 `LocalMusic-1.0.1-test1.jar` 当作安装文件。
4. 已有个人歌曲或设置时,保留原来的 `music/personal` 和 `config/LocalMusic.properties`;本包配置只是默认示例,不必覆盖个人配置。
5. 启动 Minecraft 1.6.4 Forge 客户端并进入世界。无需将 JAR 放进服务端。
## 放入歌曲
- `music/personal`:玩家自己的歌曲,只在本人客户端播放。
- `music/server`:服主随客户端文件一起分发的歌曲,仍是在每位玩家的本地播放。只把歌曲放到服务器磁盘上,玩家不会自动收到。
- 支持 MP3、OGG Vorbis 和 WAV(建议标准 PCM WAV),可使用中文文件名。两个目录中的歌曲会合并成歌单,个人歌曲排在前面;同组按文件名排序,可用 `01-歌名.mp3` 这样的前缀控制顺序。
- 游戏运行时增删歌曲后,在播放器里点“刷新歌单”。
## 播放操作
在游戏世界中按 `Enter` 或 `T` 打开聊天,点击聊天区域左侧的音符圆球,进入音乐面板。面板可切换上一首/下一首、播放/暂停、调整音量、刷新歌单和切换下次自动播放。按 `Esc` 或点击完成关闭面板,音乐会继续播放。按 `F1` 隐藏 HUD 时,音符圆球也会隐藏。
配置文件 `config/LocalMusic.properties` 中,`autoPlay=true` 表示允许下次进入时自动播放,`volume=0.35` 表示独立音量 35%。音量范围为 0 到 1;它不改变 Minecraft 其他音效的音量。
## 排查与移除
- 看不到音符圆球:确认已进入世界、按 `Enter` 或 `T` 打开聊天、没有按 `F1`,并检查游戏实际目录的 `mods` 中只有本版 JAR。1.0.2 修复了单人世界不显示圆球的问题。
- 没有歌曲:确认音频文件放在游戏实际目录的 `music/personal` 或 `music/server`,再刷新歌单。损坏或不支持的文件可查看游戏日志中的 `[LocalMusic]` 信息。
- 要停用时,完全退出游戏后移走 `mods/LocalMusic-1.0.2-test1.jar`;歌曲和设置可保留。
本 JAR 自带 JLayer MP3 解码类及其许可文本 `META-INF/JLAYER-LICENSE.txt`;OGG 使用客户端已有的音频库。本包只包含运行文件和使用说明,不包含项目源码或歌曲。
[/MD]