MCJukebox - 网页点歌台

ImagineMC 是一个以音频体验为核心的服务器，拥有 5 个主题公园和建筑复刻、带 WorldEdit 的创造世界以及多种小游戏。您可以通过访问 imaginemc.org 加入，或使用邀请码 N3TMTCH 加入我们的 Discord。

🎮快速开始指南

• 访问 https://www.mcjukebox.net/admin，创建一个账户，然后创建一个服务器。在服务器管理页面复制您的 API 密钥。
• 在您的服务器上安装 MCJukebox 插件，然后重启或重载服务器。
• 在游戏内或控制台输入 /jukebox setkey <APIKey>，将 <APIKey> 替换为您刚才复制的密钥。
• 完成！现在玩家可以在游戏内输入 /jukebox 来打开网络音乐客户端。

您也可以观看我们的教程视频以获取更直观的指引。

🔧基本命令

• /jukebox music <玩家/@节目名> <音频URL> - 为指定玩家或节目播放音乐。
• /jukebox sound <玩家/@节目名> <音频URL> - 为指定玩家或节目播放音效。
• /jukebox stop <玩家/@节目名> - 为指定玩家或节目停止播放。
• /jukebox - 获取一个能登录网络音乐客户端的专属链接。

关于音频 URL

您需要一个“直链”或“热链接”。像 YouTube、Dropbox 和 SoundCloud 这类服务通常不提供此类链接。

目前我们没有官方的资源推荐，但社区成员 @Moutarde 整理了一份指南，可能会对您有所帮助：https://gist.github.com/Moutard3/b925b090ab1d6d20a5d20f054bae7bca。请注意，使用任何服务时都请务必遵守其条款和条件。

💡权限系统

权限节点基于您要执行的子命令，格式为 mcjukebox.<子命令>。

例如

• 执行 /jukebox music 需要权限 mcjukebox.music。
• 执行 /jukebox sound 需要权限 mcjukebox.sound。

所有玩家默认都拥有使用 /jukebox 命令打开音乐客户端的权限。

⭐节目功能详解

节目是 2.0 版本更新的功能，它允许您向一组玩家同步播放音频，而不仅限于单个玩家。

• 使用 /jukebox show add/remove <玩家名> <@节目名> 来向节目中添加或移除玩家。
• 节目无需预先创建。只需使用上述命令添加玩家，并将 @show 中的 “show” 替换为您想要的节目名称即可。
• 之后，您就可以使用相同的 @节目名 来为该节目组播放音乐或音效。

重要提示：节目功能旨在确保音频同步。为了抵消加载时间的影响，确保所有听众同时听到内容，音乐可能会稍早或稍晚开始播放。

✨WorldGuard 区域支持

如果服务器上检测到安装了 WorldGuard（需要 6.1+ 版本），此功能将自动启用。

• 像往常一样，使用 /region define <区域ID> 定义一个区域。
• 使用 /jukebox region add <区域ID> <音频URL/@节目名> 为该区域注册并关联要播放的音频。
• 完成后，当玩家进入该区域时，音乐将自动播放；离开区域时，音乐会自动停止。
• 您可以使用 /jukebox region remove <区域ID> 来删除区域的音频关联。

🔧开发者 API

本插件提供了内置 API，并在各版本间保持基本一致，以最大限度地避免兼容性问题。

// 以 50% 音量播放歌曲
Media media = new Media(ResourceType.MUSIC, "url");
media.setVolume(50);
JukeboxAPI.play(player, media);

// 停止当前曲目
JukeboxAPI.stopMusic(player);

Skript 集成

如果您正在寻找 Skript 集成方案，这个由社区创建的资源可能会有所帮助：https://forums.skunity.com/resources/750。