🎵 JukeBox 插件介绍 🎵

JukeBox 插件让你只在开启 Minecraft 的情况下就能享受音乐！

版本信息

• 原生 Minecraft 版本: 1.21
• 测试过的 Minecraft 版本: 1.8 - 1.21

功能特点

• 所有歌曲存储在多页面图形界面中，只需点击即可收听！
• 支持多种语言：英语、瑞典语、德语、法语、中文等。
• 玩家特定设置保存在数据文件中，服务器重启时可重新加载。
• 登录时可启用歌曲播放器。
• 下载命令：只需输入 URL，命令会自动完成下载工作。
• 可启用随机播放模式，歌曲随机选择。
• 可暂停/恢复当前音乐。
• 播放列表/收藏歌曲系统，中键点击收藏歌曲即可添加到播放列表。
• 可调节音乐音量（范围 0 - 100%）。
• 可启用粒子效果，并与音乐节奏同步。
• 服务器广播。
• 易于使用的管理命令。
• 启用 JukeBox 音乐时可禁用原版音乐。
• 几乎无延迟；大部分可异步完成的任务都已异步处理。
• 兼容 1.16 以上服务器的十六进制颜色代码。

命令

• /music (别名: /jukebox)：打开 JukeBox。
• /adminmusic ... (别名: /amusic)：
  • reload：重新加载配置和歌曲。
  • player ：查看玩家正在收听的歌曲。
  • play ：为玩家播放歌曲。
  • playlist ：更改玩家正在收听的播放列表。
  • stop ：停止当前播放的歌曲。
  • setItem：设置广播物品。
  • download ：从互联网下载歌曲文件并加载。
  • shuffle|particles| ：切换玩家选项。
  • volume ：设置/减少/增加音量。
  • random ：播放随机歌曲。
  • next ：跳过当前歌曲。

权限

• music.command（默认给予玩家）：访问 GUI。
• music.command.admin（默认给予操作员）：访问 /adminmusic。
• music.adminItem（默认给予操作员）：更改物品格式。

占位符（仅当启用 PlaceholderAPI 时）

• %jukebox_active%：显示格式化的活动歌曲。
• %jukebox_active_title%：显示活动歌曲的标题。
• %jukebox_active_author%：显示活动歌曲的作者。
• %jukebox_active_description%：显示活动歌曲的描述。
• %jukebox_playlist%：显示活动播放列表。
• %jukebox_playeroptions_X%：选项 X 的值：音量、随机播放、加入、粒子、循环。

配置文件示例

# language - 默认可用 : en, fr, de, se, cn, es, ja, sk, lt, hu, pl, id, ru, zh, ko, nl
lang: en
# 强制在加入时播放音乐（玩家无法禁用）
forceJoinMusic: false
# 玩家点击带有唱片的唱片机方块时打开插件 GUI
jukeboxClick: false
# 启动/停止音乐时发送插件消息...
sendMessages: true
# 异步加载文件
asyncLoading: false
# 启用音乐的世界列表（空 = 全部）
enabledWorlds: []
# 音符粒子
noteParticles: true
# 启用或禁用聊天栏消息而不是聊天（1.8 不可用）
actionBar: false
# 启用或禁用服务器广播
radio: true
# 玩家加入时自动播放广播
radioOnJoin: false
# 重新加载玩家离开服务器前收听的歌曲
reloadOnJoin: true
# 定期停止原版音乐 - 可能会导致一点延迟
preventVanillaMusic: false
# GUI 中歌曲的材料。示例：DIRT, GOLD_INGOT。任何无效的材料都会导致随机记录。
songItem: RANDOM_RECORD
# 所有人的歌曲物品名称（变量：NAME, ID, AUTHOR）
itemFormat: "{NAME}"
# 具有 music.adminItem 的玩家的歌曲物品名称（变量：NAME, ID, AUTHOR）
itemFormatAdmin: "{NAME}    | {ID}"
# 格式化歌曲名称（变量：NAME, ID, AUTHOR）
songFormat: "\"{NAME}\", {AUTHOR}"
# 玩家退出时是否保留玩家数据 - 如果启用数据库则始终启用
savePlayerDatas: true
# 数据库配置
database:
  enabled: false
  host: "localhost"
  port: 3306
  database: "jukebox"
  username: "unknown"
  password: "unknown"
  ssl: false
# 给予新玩家的选项
defaultPlayerOptions:
  volume: 70
  join: false
  shuffle: false
  particles: false
  repeat: false

安装

将 NoteBlockAPI 和 JukeBox .jar 文件放入插件目录并启动服务器。将创建两个新文件夹：plugins/JukeBox（包含 config.yml）和 plugins/JukeBox/songs。

要添加歌曲，请从互联网下载 .nbs 文件并将其复制到歌曲文件夹。

别忘了查看文档页面，以找到有关如何下载歌曲、设置区域音乐、向所有人播放曲调的有趣教程。

♪ 祝你有美好的一天 ♥