JukeBox - Music Plugin - JukeBox - 点歌插件

JukeBox 让你仅需运行 Minecraft 即可享受音乐！本插件提供了一个多页的图形界面来管理所有歌曲，点击即可播放，并包含丰富的个性化设置与播放控制。

💡前置需求与兼容性

• 必需插件：NoteBlockAPI。
• 核心要求：必须使用 Spigot 或其分支（如 Paper），不支持 CraftBukkit/Bukkit。
• 版本注意：最新版与 MC `
• 查看指定玩家正在收听的歌曲。
• play
• 为指定玩家播放一首歌曲。
• playlist
• 切换指定玩家的播放列表（电台/收藏/播放列表）。
• stop
• 停止指定玩家当前播放的歌曲。
• setItem
• 设置“电台物品”。
• download
• 从网络下载歌曲文件并加载。
• shuffle|particles
• 切换指定玩家的随机播放或粒子效果开关。
• volume
• 设置/降低/提高指定玩家的音量。
• random
• 为指定玩家播放随机歌曲。
• next
• 跳过指定玩家当前歌曲。

🔧权限节点

• music.command (默认授予所有玩家)
• 允许使用 GUI 界面。
• music.command.admin (默认授予管理员/OP)
• 允许使用所有 /adminmusic 命令。
• music.adminItem (默认授予管理员/OP)
• 使用管理员格式显示歌曲物品名称。

⭐PlaceholderAPI 变量

若安装了 PlaceholderAPI，可使用以下变量：

• %jukebox_active% - 显示当前播放歌曲的格式化信息。
• %jukebox_active_title% - 显示当前歌曲标题。
• %jukebox_active_author% - 显示当前歌曲作者。
• %jukebox_active_description% - 显示当前歌曲描述。
• %jukebox_playlist% - 显示当前激活的播放列表。
• %jukebox_playeroptions_X% - 显示玩家选项 X 的值（X 可为：volume, shuffle, join, particles, loop）。

❓配置摘要 (`config.yml`)

主要配置选项如下

• lang：设置语言（默认 en）。
• forceJoinMusic：强制玩家加入时播放音乐（玩家不可关闭）。
• jukeboxClick：点击唱片机方块时是否打开插件 GUI。
• savePlayerDatas：是否保存玩家数据（启用数据库后此设置强制生效）。
• database：数据库配置区块，可启用 MySQL 存储。
• defaultPlayerOptions：新玩家的默认选项（音量、登录播放、随机播放等）。
• preventVanillaMusic：是否在播放插件音乐时阻止原版音乐（可能引起轻微卡顿）。

🔧安装与使用

• 将 NoteBlockAPI 和 JukeBox 的 .jar 文件放入服务器的 plugins 文件夹。
• 启动服务器，将自动生成 plugins/JukeBox 和 plugins/JukeBox/songs 文件夹。
• 添加歌曲：从网上下载 .nbs 格式的歌曲文件，放入 songs 文件夹即可。
• 歌曲资源可参考文档中提供的链接列表。

> 提示：请查阅官方文档页面，获取关于下载歌曲、设置区域音乐、全服播放等实用教程。

♪ 祝你使用愉快 ♥

AdminMusic 是一款允许你在 Minecraft 服务器中播放和管理 Note Block 音乐的插件。通过它，你可以为玩家点播歌曲、设置区域音乐，甚至从网络下载新的音乐文件。

💡命令与权限

主命令为 /adminmusic，其子命令语法如下：

• reload - 重新加载插件配置和音乐文件。
• player <玩家名> - 查看指定玩家正在收听哪首歌曲。
• play <玩家名> <歌曲ID> - 为指定玩家播放一首歌曲。
• stop <玩家名> - 停止指定玩家当前收听的歌曲。
• setItem - 设置“收音机”物品。
• download <URL> <目标文件名> - 从互联网下载歌曲文件并加载。
• shuffle|particles|volume <玩家名> - 切换指定玩家的随机播放、粒子效果或音量选项。
• random <玩家名> - 为指定玩家随机播放一首歌曲。

如何为所有玩家播放歌曲

• 找到你想播放的歌曲 ID（打开 /music 界面，歌曲名称末尾的数字即是 ID）。
• 执行命令 /adminmusic play @a <歌曲ID>。

❓常见操作指南

如何编辑歌曲标题与描述

需要软件：OpenNoteBlockStudio (https://opennbs.org/)

• 在电脑上启动 OpenNoteBlockStudio。
• 打开你想要编辑的 .nbs 文件。
• 在窗口顶部的 Settings 菜单中，点击 Song properties...。
• 编辑你想要的字段，然后点击 OK。
• 点击 Save 按钮保存。

如何播放更多音域的歌曲

• 首先，设置一个强制性的服务器资源包，以支持更多音域（例如 NoteBlockAPI 开发者提供的资源包）。
• 在 config.yml 中，启用 useExtendedOctaveRange 选项。
• 重启你的服务器。

如何设置“区域音乐”

所需插件：WorldGuard + WorldGuardExtraFlags (https://www.spigotmc.org/resources/worldguard-extra-flags.4823/)

• 找到你想播放的歌曲 ID（打开 /music 界面查看）。
• 假设你已创建好 WorldGuard 区域，输入命令：

`/region flag <你的区域名> console-command-on-entry /adminmusic play %username% <歌曲ID>`

• 再输入命令：

`/region flag <你的区域名> console-command-on-exit /adminmusic stop %username%`

注意：拥有 WorldGuard 区域标志绕过权限的玩家（默认情况下 OP 玩家拥有此权限）不会触发 WorldGuardExtraFlags 的命令。测试时请取消自己的 OP 状态。

🔧如何下载歌曲 (由 @MimiKyu 提供)

下载现有的 .nbs 文件

• 你需要歌曲的 URL，且必须是 .nbs 格式（不支持 mp3 或 midi）。访问：https://opennbs.org/songs/
• 页面下方有歌曲列表，你可以搜索想要的歌曲。找到后，在“Download”链接上右键，复制链接地址。
• 复制的 URL 通常很长，无法在游戏聊天框中输入。请使用短链接服务（如 https://xurl.es/）将其缩短。
• 进入游戏，使用命令：/adminmusic download <缩短后的URL> <目标文件名>。<目标文件名>是你想在游戏中为这首歌命名的名字。
• 下载完成后，执行 /adminmusic reload 重载。现在使用 /music 就能在播放列表中看到新歌曲了。

转换并上传自定义音乐

如果你想自己创作或寻找更多音乐

• 下载 Open Note Block Studio。
• 你可以在以下网站找到 .mid (Midi) 格式的音乐文件：

- https://www.midiworld.com/

- https://bitmidi.com/

- https://www.mididb.com/

- https://www.cprato.com/

• 使用 Open Note Block Studio 将 .mid 文件转换为 Minecraft 可用的 .nbs 格式（可参考相关教程）。
• 转换后，再次访问 https://opennbs.org/songs/，点击红色的 "Submit a song" 按钮上传你的歌曲。
• 歌曲出现在 "My Songs" 后，重复上述“下载现有的 .nbs 文件”的步骤即可。