NoteBlockMusicPlayer - 官方音乐播放器

RadioSongs

RadioSongs 是一款基于 NoteBlockAPI 的官方 NBS 音乐播放器插件，允许您在服务器中设置多个音乐电台，播放 .nbs 格式的音符盒音乐，为玩家带来丰富的听觉体验。

💡功能特性

• 电台播放：在配置文件中定义的特定坐标点播放音乐。
• 多层级电台：支持全服电台和世界电台。
• 播放列表管理：
• 可重复播放的播放列表。
• 支持随机顺序播放。
• 可配置歌曲之间的暂停间隔。
• 多电台支持：可同时运行多个电台。
• 游戏内编辑：支持在游戏内直接编辑播放列表。
• 全息显示：在电台位置显示可配置的全息图。
• 区域提示：当玩家进入电台区域时，在行动栏显示消息。
• 高度自定义：
• 可自定义所有提示消息。
• 可自定义全息图外观。
• 音量控制：
• 每个电台可设置不同的音量。
• 允许玩家自行调整电台音量。
• 权限控制：可使用权限来限制收听特定电台。

🔧计划开发的功能

• 实现 NoteBlockAPI 的所有功能。
• 为每位玩家设置独立的播放列表。
• 背包式播放列表编辑器。
• 为指定玩家、世界或全服播放单首歌曲。
• <在此提出您的建议>

🎮依赖项

• 必需依赖：
• NoteBlockAPI (1.6.0 或更高版本)

• 可选依赖：
• DecentHolograms (用于显示全息图)
• Holographic Displays 与 ProtocolLib (ProtocolLib 为独立全息图所必需)
• PlaceholderAPI (用于在消息中使用变量)

❓支持与下载

• 开发构建版下载：请访问 此处。
• 支持与反馈：请通过私信 (PM) 联系作者，或加入其 Discord 服务器。

✨语言支持

感谢以下贡献者的翻译工作

• English - koca2000
• German/Deutch - FNaFerYT (1.4)
• French/Français - maximilien47201 (1.4)
• Bosnian/Bosanski - Castro2535 (1.5)

⭐致谢与捐赠

特别感谢以下捐赠者：

• sannielollie - 15$
• Marlile - 10$

如果您喜欢这个插件并愿意支持开发，欢迎 进行捐赠。作者是一名学生，将非常感谢每一份支持，您的名字也会被列在此处。

NoteBlockMusicPlayer (NBMP) 是一款功能强大的 Minecraft 插件，它允许服务器管理员在游戏中创建各种类型的音乐电台，包括位置电台、世界电台和全服电台。玩家可以收听音乐，管理员可以通过丰富的命令和配置进行管理，并支持 PlaceholderAPI 以实现深度自定义。

🎮命令列表

位置电台命令

• /positionradio help - 显示位置电台的所有命令帮助。
• /positionradio enable <radio name> - 启用指定的位置电台。需要权限：positionradio.enable
• /positionradio disable <radio name> - 禁用指定的位置电台。需要权限：positionradio.enable
• /positionradio reload - 从配置文件重载位置电台。需要权限：positionradio.admin
• /positionradio skip <name of radio> - 跳过指定电台当前正在播放的歌曲。需要权限：positionradio.skip

服务器电台命令

• /serverradio help - 显示服务器电台的所有命令帮助。
• /serverradio enable <radio name> - 启用指定的服务器电台。需要权限：serverradio.enable
• /serverradio disable <radio name> - 禁用指定的服务器电台。需要权限：serverradio.enable
• /serverradio reload - 从配置文件重载服务器电台。需要权限：serverradio.admin
• /serverradio skip <name of radio> - 跳过指定电台当前正在播放的歌曲。需要权限：serverradio.skip

世界电台命令

• /worldradio help - 显示世界电台的所有命令帮助。
• /worldradio enable <radio name> - 启用指定的世界电台。需要权限：worldradio.enable
• /worldradio disable <radio name> - 禁用指定的世界电台。需要权限：worldradio.enable
• /worldradio reload - 从配置文件重载世界电台。需要权限：worldradio.admin
• /worldradio skip <name of radio> - 跳过指定电台当前正在播放的歌曲。需要权限：worldradio.skip

播放列表命令

• /nbmp playlist help - 显示播放列表的所有命令帮助。
• /nbmp playlist reload - 从配置文件重载播放列表。需要权限：nbmp.playlist.admin
• /nbmp playlist songs <name of playlist> - 显示指定播放列表中的歌曲列表。需要权限：nbmp.playlist.list
• /nbmp playlist list - 显示所有播放列表的列表。需要权限：nbmp.playlist.list
• /nbmp playlist add <name of playlist> <name of song> - 向播放列表中添加歌曲。需要权限：nbmp.playlist.add
• /nbmp playlist remove <name of playlist> <name of song> - 从播放列表中移除歌曲。需要权限：nbmp.playlist.add
• /nbmp playlist create <name of playlist> - 创建新的播放列表。需要权限：nbmp.playlist.create

全息图命令

• /nbmp hologram reload - 从配置文件重载全息图。需要权限：nbmp.hologram.admin

全局命令

• /nbmp reload - 重载 config.yml 配置文件。需要权限：nbmp.admin
• /radio volume <0-100> - 为执行命令的玩家设置所有电台的音量（0-100）。需要权限：radio.volume
• /radio volume - 显示执行命令的玩家当前所有电台的音量。需要权限：radio.volume
• /radio toggle - 为执行命令的玩家静音或取消静音所有电台。需要权限：radio.toggle

💡权限列表

玩家权限

• radio.volume - 默认：true
• radio.toggle - 默认：true
• nbmp.radio.* - 默认：true

管理员权限 (默认 OP)

• nbmp.admin
• positionradio.admin
• positionradio.enable
• positionradio.skip
• positionradio.hologram (显示位置电台的管理员全息图)
• serverradio.admin
• serverradio.enable
• serverradio.skip
• worldradio.admin
• worldradio.enable
• worldradio.skip
• nbmp.playlist.reload
• nbmp.playlist.list
• nbmp.playlist.create
• nbmp.playlist.add
• nbmp.hologram.reload

电台收听权限

• nbmp.<world/server/position>.<radio name> - 用于控制玩家是否可以收听特定电台。

🔧PlaceholderAPI 支持

NoteBlockMusicPlayer 1.9.0+ 版本支持在文本和全息图中使用 PlaceholderAPI，并提供了以下专属占位符：

玩家收听信息

• %nbmp_hear_song_name% - 返回玩家正在收听的歌曲名称。
• %nbmp_hear_song_author% - 返回玩家正在收听的歌曲作者。
• %nbmp_hear_song_elapsed% - 返回玩家正在收听的歌曲已播放时间。
• %nbmp_hear_song_length% - 返回玩家正在收听的歌曲总长度。

电台当前信息

• %nbmp_[pos,world,server]_song_name_<name>% - 返回指定名称和类型电台的当前歌曲名称。
• %nbmp_[pos,world,server]_song_author_<name>% - 返回指定名称和类型电台的当前歌曲作者。
• %nbmp_[pos,world,server]_song_elapsed_<name>% - 返回指定名称和类型电台的当前歌曲已播放时间。
• %nbmp_[pos,world,server]_song_length_<name>% - 返回指定名称和类型电台的当前歌曲总长度。

⭐配置文件

config.yml

language: en
config_Playlists: playlists.yml
config_WorldRadio: globalRadio.yml
config_ServerRadio: globalRadio.yml
config_PositionRadio: positionRadio.yml
config_Holograms: holograms.yml
defaultPlayerVolume: 100
savePlayerVolumes: false
use10OctaveRange: false # 需要资源包支持

positionRadio.yml (位置电台配置)

positionradios:
  test_radio:
    enable: false
    world: world
    x: 0
    y: 100
    z: 0
    radius: 16 # 在此半径内的玩家可以听到音乐
    hologram: example_hologram # 使用 none 禁用全息图
    hologramOP: example_OP_hologram
    repeat: true # 是否循环播放列表？
    random: false
    actionbar: true
    delay: 0 # 歌曲之间的延迟（秒，支持小数）
    playlist: test_playlist
    volume: 100

globalRadio.yml (世界/服务器电台配置)

worldradios:
  world_radio:
    enable: false
    world: world # 同一时间一个世界只能启用一个世界电台
    repeat: true # 是否循环播放列表？
    random: false # 是否从播放列表中随机选择下一首歌曲？
    actionbar: true
    playlist: test_playlist
    delay: 0 # 歌曲之间的延迟（秒，支持小数）
    volume: 100

serverradios:
  server_radio:
    enable: false # 同一时间只能启用一个服务器电台
    random: false # 是否从播放列表中随机选择下一首歌曲？
    repeat: true # 是否循环播放列表？
    actionbar: true
    playlist: test_playlist
    delay: 0 # 歌曲之间的延迟（秒，支持小数）
    volume: 100

playlists.yml (播放列表配置)

playlist:
  test_playlist:
    - nyan_cat # 歌曲文件必须位于 plugins/NoteBlockMusicPlayer/songs 目录下
    - nyan_cat.nbs

holograms.yml (全息图配置)

hologram:
  example_hologram:
    lines:
      - "Playing: %song_title%"
      - "%song_number%/%songs_count%"
  example_OP_hologram:
    lines:
      - "Playing: %song_title%"
      - "%song_number%/%songs_count%"
      - "{next}Skip song"

songs.yml (歌曲信息配置)

songs:
  nyan_cat:
    author: Kruga
    title: Nyan Cat