# 作者：FlyLight、Wn1027
# 旧版本：LF Music 服务器添加音乐 0.6
# 开源地址：Gitee_LF_Music
# 不要在评价区反馈bug，反馈bug请到讨论/反馈区，
# 本插件反馈QQ群: 641223836
# 众开发者插件定制群：799946510
提示：wine环境下可能存在问题。
一、插件功能（0.14.0版本）：
- /mucmenu 或 任意唱片点击地面 打开主菜单。
1、音乐盒播放：像唱片机一样的3D环绕音。
2、普通BGM播放：和后台手机播放器app一样能跟随玩家播放。
3、指定范围：选择指定范围内的玩家播放音乐，可以和朋友一起享受音乐而不打扰服内其他玩家。半径很大时，远处的玩家的音源会被放置在ta自己旁边，音量为选项中的最小音量。
4、自定义全服背景音乐：设置中开启自定义背景音乐，选择歌曲界面进行添加，随机间隔播放。
5、歌词显示：放入.lrc歌词文件后，屏幕上方Boss栏会显示歌词。
6、快速增删音乐：添加音乐后输入指令自动更新音乐包，重启服务器即可完成音乐增删。
7、服务器自定义：命令/playsound record.musicname @s ~~~ 以及 /music play music.game.musicname
服主可使用命令方块来在指定地点添加音乐效果。
8、音频自动转换：如你放入ffmpeg.exe，则可自动转换音频格式为.ogg。
9、播放顺序：列表循环、单曲循环、随机播放（需 ffmpeg.exe 自动获取音乐时长或手动填入音乐时长信息）
10、播放列表自动保存：添加喜欢的音乐吧~
11、下载在线音乐：/mucmenu curl "xxx.mp3" "http://xxxxxxx.xxx/xxx.mp3"
二、使用步骤：
1、安装本插件（LF_Music）
下载本插件并放入./plugins下，启动服务器自动生成所需目录与配置文件。
2、安装音乐资源包
（请使用上个历史版本的资源包！否则服务器可能会崩溃2024.2.5）
点这里(lightServerMusic) 下载上个历史版本的音乐资源包 解压放入服务端根目录 ./resource_packs/下，
并修改./plugins/LF_Music/config.json中 "serverRES"项的路径为：./resource_packs/serverMusicRE/ 。
验证放置正确：./resource_packs/serverMusicRE/ 下应有4个文件。
（或者放入./worlds/存档名/resource_packs/下， 并修改./plugins/LF_Music/config.json中 "serverRES"项的路径： ./worlds/存档名/resource_packs/serverMusicRE/ ）
3、安装ffmpeg.exe（可选，推荐安装）
在ffmpeg官网，或点这里下载ffmpeg.exe，放入./plugins/LF_Music/tools/下。
（ffmpeg.exe 用于音频格式自动转换，以及音乐时长自动读取）
（面板服可能不适用此程序，无法使用的话请使用格式工厂等软件转换音频为.ogg格式。）
4、添加想要的音乐
（1）如你已放入ffmpeg.exe：
将音乐文件（.mp3、.flac等）放入 ./plugins/LF_Music/DATA/music/ 下，并重命名为英文（文件名不能为中文，需字母数字下划线，不能以数字开头）。
（注： 可能ffmpeg音频格式自动转换有问题，如自动转换后的音乐无法播放，请按照下文方法手动将音频转为.ogg格式）
（2）如你没有放入ffmpeg.exe：
如你的面板服无法使用ffmpeg.exe，请将想要导入的音乐(.mp3格式) 使用格式工厂等软件，转为 .ogg格式（低质量即可，一首歌1MB多，尽量减小资源包大小）
然后再将转换后的音乐文件(.ogg格式) 放入 ./plugins/LF_Music/DATA/music/ 下，并重命名为英文（文件名不能为中文，需字母数字下划线，不能以数字开头）。
5、更新资源包
控制台输入命令 /refmusic 。自动转换音频格式，以及获取音频时长，以及导入音乐并更新资源包。
歌曲的中文命名：你可以在data.json中修改"rename"一项为歌曲的中文名字。游戏中音乐列表显示的就是"rename"这一项的名字。
（可能需要多次执行该指令，请注意data.json中所有歌曲是否导入，以及时长信息是否填入）
（如你没有放入ffmpeg.exe， 你可以手动在./plugins/LF_Music/DATA/data.json 中填写歌曲的时长信息）
6、重启服务端，应用资源包
重启服务端。每次更新后，玩家进服都会下载资源包。如没有下载资源包的提示，则资源包装载失败，请参照常见问题2更换资源包uuid。
7、游戏内播放音乐
玩家使用命令 /mucmenu 或任意唱片点击地面，打开音乐菜单。
8、管理员增删歌曲：
（1）将音乐文件(.ogg格式，如已放入ffmpeg.exe，则其他格式也可以) 放入 ./plugins/LF_Music/DATA/music/ 下，并重命名为英文（文件名不能为中文，需字母数字下划线）
（2）输入 /refmusic 更新资源包，重启服务端。
（3）然后玩家进服会重新下载资源包。
9、歌词显示：
（1）使用下文实用链接中的软件或其他方法下载.lrc歌词文件。（.lrc译文格式参考下图）
（2）将.lrc歌词文件放入 ./plugins/LF_Music/DATA/music/ 下，重命名，歌词文件名与对应歌曲的文件名相同。
（3）无需重载插件或服务器，直接在游戏里播放即可看到歌词。
三、玩家使用提示：
1、如果播放音乐盒与播放BGM 与 原版背景音乐重叠，如果介意，请将游戏设置——音频设置——音乐一项音量设为0，即关闭原版背景音乐。
2、全服循环播放的音量与游戏设置——音频设置——音乐的音量有关。
四、常见问题：
1. 播放原理：插件调用 /playsound record.MusicName @a[r=1] ~~~ 命令播放资源包内的自定义音乐。
如播放失败，请用此命令检查。
2. 配置全部正确，但每次/refmusic后进服没有下载资源包的提示，播放新加入的音乐也没有声音。
初步判断为资源包装载BUG，请按以下步骤更改资源包的uuid，uuid字符为16进制数。
（1）更改 ./plugins/LF_Music/config.json中的 PackUUID，譬如将尾数72改成73。uuid单个字符应为16进制字符。
（2）控制台输入 refmusic 重新更新资源包。
（3）重启服务端。
（4）你可以删除./worlds/Bedrock level/world_resource_packs.json中的原uuid了（f3f55c4c-991a-4158-9ae3-5cf7b2848072，不删也没事）。
3. 其他没有声音的情况
如果每次/refmusic后进服都有下载资源包的提示，却播放无声音，则考虑以下问题：
（1）检查LiteLoader是否与当前游戏版本匹配，试试重装LL。
（2）检查.ogg音乐文件名，需字母数字下划线，不能为中文或中文状态下的符号，不能以数字开头。
（3）检查config.json中的worldJson一项，是否在当前服务器存档目录下。
（4）.ogg音乐不能通过改后缀得到，需使用专业软件或网站转格式。
（5）检查游戏设置内音频设置的各项音量。
4、歌词乱码：
（1）检查 .lrc 文件编码是否为utf-8编码，可以用记事本打开，另存为utf-8编码。
五、实用链接：
1、音乐搜索下载器 - 多站合一音乐搜索,音乐在线试听
2、格式工厂无广告免安装版
3、OGG在线转换
4、如何下载网易云和QQ音乐的.lrc歌词
5、ffmpeg官网
6、ffmpeg.exe蓝奏云 （感谢 @椛椛 ᴮᴼᵀ 提供下载链接）
插件图片：
# 旧版本：LF Music 服务器添加音乐 0.6
# 开源地址：Gitee_LF_Music
# 不要在评价区反馈bug，反馈bug请到讨论/反馈区，
# 本插件反馈QQ群: 641223836
# 众开发者插件定制群：799946510
提示：wine环境下可能存在问题。
一、插件功能（0.14.0版本）：
- /mucmenu 或 任意唱片点击地面 打开主菜单。
1、音乐盒播放：像唱片机一样的3D环绕音。
2、普通BGM播放：和后台手机播放器app一样能跟随玩家播放。
3、指定范围：选择指定范围内的玩家播放音乐，可以和朋友一起享受音乐而不打扰服内其他玩家。半径很大时，远处的玩家的音源会被放置在ta自己旁边，音量为选项中的最小音量。
4、自定义全服背景音乐：设置中开启自定义背景音乐，选择歌曲界面进行添加，随机间隔播放。
5、歌词显示：放入.lrc歌词文件后，屏幕上方Boss栏会显示歌词。
6、快速增删音乐：添加音乐后输入指令自动更新音乐包，重启服务器即可完成音乐增删。
7、服务器自定义：命令/playsound record.musicname @s ~~~ 以及 /music play music.game.musicname
服主可使用命令方块来在指定地点添加音乐效果。
8、音频自动转换：如你放入ffmpeg.exe，则可自动转换音频格式为.ogg。
9、播放顺序：列表循环、单曲循环、随机播放（需 ffmpeg.exe 自动获取音乐时长或手动填入音乐时长信息）
10、播放列表自动保存：添加喜欢的音乐吧~
11、下载在线音乐：/mucmenu curl "xxx.mp3" "http://xxxxxxx.xxx/xxx.mp3"
二、使用步骤：
1、安装本插件（LF_Music）
下载本插件并放入./plugins下，启动服务器自动生成所需目录与配置文件。
2、安装音乐资源包
（请使用上个历史版本的资源包！否则服务器可能会崩溃2024.2.5）
点这里(lightServerMusic) 下载上个历史版本的音乐资源包 解压放入服务端根目录 ./resource_packs/下，
并修改./plugins/LF_Music/config.json中 "serverRES"项的路径为：./resource_packs/serverMusicRE/ 。
验证放置正确：./resource_packs/serverMusicRE/ 下应有4个文件。
（或者放入./worlds/存档名/resource_packs/下， 并修改./plugins/LF_Music/config.json中 "serverRES"项的路径： ./worlds/存档名/resource_packs/serverMusicRE/ ）
| 插件文件路径 | 说明 |
| ./plugins/LF_Music/config.json | 插件配置 |
| ./world/存档名/world_resource_packs.json | 服务器存档资源包配置文件（音乐包uuid: f3f55c4c-991a-4158-9ae3-5cf7b2848072 与音乐包内的uuid一致，删除资源包时请删除json中的该项） |
| （二选一）./resource_packs/serverMusicRE/ | 音乐资源包 |
| （二选一）./worlds/存档名/resource_packs/serverMusicRE/ | 音乐资源包 |
3、安装ffmpeg.exe（可选，推荐安装）
在ffmpeg官网，或点这里下载ffmpeg.exe，放入./plugins/LF_Music/tools/下。
（ffmpeg.exe 用于音频格式自动转换，以及音乐时长自动读取）
（面板服可能不适用此程序，无法使用的话请使用格式工厂等软件转换音频为.ogg格式。）
4、添加想要的音乐
（1）如你已放入ffmpeg.exe：
将音乐文件（.mp3、.flac等）放入 ./plugins/LF_Music/DATA/music/ 下，并重命名为英文（文件名不能为中文，需字母数字下划线，不能以数字开头）。
（注： 可能ffmpeg音频格式自动转换有问题，如自动转换后的音乐无法播放，请按照下文方法手动将音频转为.ogg格式）
（2）如你没有放入ffmpeg.exe：
如你的面板服无法使用ffmpeg.exe，请将想要导入的音乐(.mp3格式) 使用格式工厂等软件，转为 .ogg格式（低质量即可，一首歌1MB多，尽量减小资源包大小）
然后再将转换后的音乐文件(.ogg格式) 放入 ./plugins/LF_Music/DATA/music/ 下，并重命名为英文（文件名不能为中文，需字母数字下划线，不能以数字开头）。
5、更新资源包
控制台输入命令 /refmusic 。自动转换音频格式，以及获取音频时长，以及导入音乐并更新资源包。
歌曲的中文命名：你可以在data.json中修改"rename"一项为歌曲的中文名字。游戏中音乐列表显示的就是"rename"这一项的名字。
（可能需要多次执行该指令，请注意data.json中所有歌曲是否导入，以及时长信息是否填入）
（如你没有放入ffmpeg.exe， 你可以手动在./plugins/LF_Music/DATA/data.json 中填写歌曲的时长信息）
6、重启服务端，应用资源包
重启服务端。每次更新后，玩家进服都会下载资源包。如没有下载资源包的提示，则资源包装载失败，请参照常见问题2更换资源包uuid。
7、游戏内播放音乐
玩家使用命令 /mucmenu 或任意唱片点击地面，打开音乐菜单。
8、管理员增删歌曲：
（1）将音乐文件(.ogg格式，如已放入ffmpeg.exe，则其他格式也可以) 放入 ./plugins/LF_Music/DATA/music/ 下，并重命名为英文（文件名不能为中文，需字母数字下划线）
（2）输入 /refmusic 更新资源包，重启服务端。
（3）然后玩家进服会重新下载资源包。
9、歌词显示：
（1）使用下文实用链接中的软件或其他方法下载.lrc歌词文件。（.lrc译文格式参考下图）
（2）将.lrc歌词文件放入 ./plugins/LF_Music/DATA/music/ 下，重命名，歌词文件名与对应歌曲的文件名相同。
（3）无需重载插件或服务器，直接在游戏里播放即可看到歌词。
三、玩家使用提示：
1、如果播放音乐盒与播放BGM 与 原版背景音乐重叠，如果介意，请将游戏设置——音频设置——音乐一项音量设为0，即关闭原版背景音乐。
2、全服循环播放的音量与游戏设置——音频设置——音乐的音量有关。
四、常见问题：
1. 播放原理：插件调用 /playsound record.MusicName @a[r=1] ~~~ 命令播放资源包内的自定义音乐。
如播放失败，请用此命令检查。
2. 配置全部正确，但每次/refmusic后进服没有下载资源包的提示，播放新加入的音乐也没有声音。
初步判断为资源包装载BUG，请按以下步骤更改资源包的uuid，uuid字符为16进制数。
（1）更改 ./plugins/LF_Music/config.json中的 PackUUID，譬如将尾数72改成73。uuid单个字符应为16进制字符。
（2）控制台输入 refmusic 重新更新资源包。
（3）重启服务端。
（4）你可以删除./worlds/Bedrock level/world_resource_packs.json中的原uuid了（f3f55c4c-991a-4158-9ae3-5cf7b2848072，不删也没事）。
3. 其他没有声音的情况
如果每次/refmusic后进服都有下载资源包的提示，却播放无声音，则考虑以下问题：
（1）检查LiteLoader是否与当前游戏版本匹配，试试重装LL。
（2）检查.ogg音乐文件名，需字母数字下划线，不能为中文或中文状态下的符号，不能以数字开头。
（3）检查config.json中的worldJson一项，是否在当前服务器存档目录下。
（4）.ogg音乐不能通过改后缀得到，需使用专业软件或网站转格式。
（5）检查游戏设置内音频设置的各项音量。
4、歌词乱码：
（1）检查 .lrc 文件编码是否为utf-8编码，可以用记事本打开，另存为utf-8编码。
五、实用链接：
1、音乐搜索下载器 - 多站合一音乐搜索,音乐在线试听
2、格式工厂无广告免安装版
3、OGG在线转换
4、如何下载网易云和QQ音乐的.lrc歌词
5、ffmpeg官网
6、ffmpeg.exe蓝奏云 （感谢 @椛椛 ᴮᴼᵀ 提供下载链接）
插件图片：
