BattleMusic (1.12-1.18) - BattleMusic - 战斗音乐插件

💡战斗音乐：为你的史诗战斗配乐

各位勇士，你是否曾梦想在激烈的战斗中拥有专属的背景音乐？BattleMusic 让你的每一次与 Minecraft 怪物的交锋都变得更加紧张刺激、身临其境。它支持多种音源，包括原版游戏音效、资源包自定义音效、MCJukebox 音乐以及 NoteBlockAPI 的音符盒歌曲。

🎮功能特性

• 多音源支持：可配置使用原版音效、资源包自定义音效、MCJukebox 音乐或 NoteBlockAPI 音符盒歌曲作为战斗音乐。
• 动态播放：音乐随战斗开始而响起，随战斗结束而停止，营造沉浸式体验。
• 随机播放：可从列表或文件夹中随机选择音乐播放，增加战斗的不可预测性。
• 灵活配置：提供重载命令，方便管理员在服务器运行时调整设置。

🔧如何使用

获取与体验

• 在线演示：

- 观看 [MCJukebox 演示视频](https://www.youtube.com/watch?v=o8nXm6jqQlw)

- 观看 [自定义资源包音效演示视频](https://www.youtube.com/watch?v=8v5fXrqQlw)

- 观看 [音符盒歌曲演示视频](https://www.youtube.com/watch?v=9v6fXrqQlw)

• 亲自尝试：目前暂无公开运行 BattleMusic 的服务器。若希望你的服务器被列入展示列表，请直接联系开发者。

配置与命令

详细的配置方法、命令和权限设置，请查阅插件的 文档部分。

❓版本兼容性与注意事项

对 1.18 - 1.11 版本的支持

开发者无法保证插件在 1.18 至 1.11 版本中功能完全正常。这并非缺乏维护意愿（1.18 仍是开发者最喜爱的版本），而是由于技术限制：

• 在这些版本的 Minecraft 中，无法停止一个已开始播放的资源包音效，这与 BattleMusic 的动态停止机制冲突。
• 解决方案：如果你在这些版本中使用 MCJukebox 或 NoteBlockAPI 作为音源，插件仍可正常工作。换言之，在 1.18-1.11 版本中，无法使用资源包自定义音效功能。

✨开发历程与更新日志

以下是已实现的功能与想法

• ✓ 使用史诗级音符盒音乐！ (由 @hung1612 提议) - 已于 v2.0 (2019/12/16) 完成。
• ✓ 播放随机音乐 (由 @hung1612 提议) - 已于 v2.1 (2019/12/17) 完成。
• ✓ 重载命令 (由 @hung1612 提议) - 已于 v2.4 (2019/12/18) 完成。
• ✓ 战斗结束时的音乐与命令 (由 @Kevin_H 提议) - 已于 v3.1 (2022/05/07) 完成。

欢迎使用 BattleMusic！本插件可在玩家战斗时播放史诗般的背景音乐，提升游戏体验。如有任何问题或疑问，可通过 Spigot 私信或 Discord (Léo Major#1234) 联系开发者。

BattleMusic 本身不直接播放声音，它通过三种不同的声音播放器工作：资源包声音、MCJukebox 和 NoteBlockAPI。如果你不确定选择哪个，可以参考以下各自的优缺点。

💡声音播放器对比

资源包声音

• 优点

- 可以播放任何音乐，无格式限制。

- 无需额外插件支持。

• 缺点

- 玩家必须下载资源包才能听到音乐。如果音乐数量多，资源包可能会很大。

- 音乐开始时可能产生延迟（源自 Minecraft 本身，而非 BattleMusic）。

MCJukebox

• 优点

- 可以播放任何音乐，无格式限制。

- 支持音乐淡出效果。

• 缺点

- 需要安装 MCJukebox 插件。

- 玩家需要打开网页浏览器才能收听音乐。

NoteBlockAPI

• 优点

- 无需玩家下载或进行任何操作。

- 产生的延迟极少甚至没有。

• 缺点

- 需要安装 NoteBlockAPI 插件。

- 只能播放 `.nbs` 格式的音乐，这大大限制了音乐选择，除非你自己创作音乐。

🎮命令列表

管理与设置

主命令：/battlemusic 或 /bm

• /battlemusic reload - 重载 BattleMusic 配置文件。
• /battlemusic version - 显示 BattleMusic 版本。
• /battlemusic remove <sound> - 从默认战斗音乐列表中移除一个音效。
• /battlemusic remove <实体名称> <sound> - 从指定实体类型的音乐列表中移除一个音效。
• /battlemusic remove <实体名称> <自定义名称> <sound> - 从具有自定义名称的实体音乐列表中移除一个音效。
• /battlemusic show - 显示默认战斗音乐的音效列表。
• /battlemusic show <实体类型> - 显示指定实体类型的音效列表。
• /battlemusic show <实体类型> <自定义名称> - 显示自定义实体的音效列表。

启用与禁用

• /battlemusic-enable 或 /bm-enable - 为自己启用战斗音乐。
• /battlemusic-enable <玩家> - 为指定玩家启用战斗音乐。
• /battlemusic-disable 或 /bm-disable - 为自己禁用战斗音乐。
• /battlemusic-disable <玩家> - 为指定玩家禁用战斗音乐。

✨添加音乐

添加资源包音乐

你需要一个包含自定义音效的资源包。请自行研究如何制作带音效的资源包。以下是配置示例：

• 使用命令测试音效是否能正常播放：/playsound <sound> player @p
• 如果测试成功，即可使用以下命令将相同音效添加到配置中：

- `/battlemusic add <sound>` - 添加到默认战斗音乐。

- `/battlemusic add <实体名称> <sound>` - 添加到指定实体类型。

- `/battlemusic add <实体名称> <自定义名称> <sound>` - 添加到具有自定义名称的实体。

添加 MCJukebox 音乐

需要安装 MCJukebox 插件。首先你需要将音乐文件上传到网络。音效参数即为文件的 URL。

• /battlemusic add mcjukebox:<音效URL> - 添加到默认战斗音乐。
• /battlemusic add <实体名称> mcjukebox:<音效URL> - 添加到指定实体类型。
• /battlemusic add <实体名称> <自定义名称> mcjukebox:<音效URL> - 添加到具有自定义名称的实体。

添加 NoteBlockAPI 音乐

需要安装 NoteBlockAPI 插件。你需要下载 .nbs 文件并放入 plugins/battlemusic/music/ 文件夹。音效参数即为文件名。

• /battlemusic add noteblock:<文件名> - 添加到默认战斗音乐。
• /battlemusic add <实体名称> noteblock:<文件名> - 添加到指定实体类型。
• /battlemusic add <实体名称> <自定义名称> noteblock:<文件名> - 添加到具有自定义名称的实体。

🔧权限节点

• battlemusic.* - 授予所有 BattleMusic 命令的权限。
• battlemusic.setup - 授予所有 BattleMusic 设置命令的权限。
• battlemusic.disable.other - 允许为自己或他人启用/禁用战斗音乐。
• battlemusic.disable - 允许为自己启用/禁用战斗音乐。

⭐配置示例

以下是配置文件 config.yml 的部分示例：

ignore-creative: true
# 创造模式玩家是否触发战斗音乐
run-away-time: 15
# 停止战斗后，音乐取消前的等待时间（秒）
disable-music:
# 不希望触发史诗音乐的实体列表。比如鸡就不需要！
- iron_golem

mcjukebox:
  fade: 3
  # 使用 MCJukebox 时的淡出时间（秒）
  volume: 100
  # 音乐音量（最大 100）
  commands-after-fight:
  # 战斗结束后执行的命令。{player} 代表玩家名
  - "jukebox sound {player} https://audio.jukehost.co.uk/O35LQERiX8eIDm1UsZ3h8LcTtgjGrftA"

ignore-playervsplayer: false
# 是否忽略玩家对玩家的战斗

music:
  sound:
    - mcjukebox:https://audio.jukehost.co.uk/h3alZYbHiw6Q1G9vWvMs2uaqJ1oLJn1R

zombie:
  LouShunt:
    sound:
      - mcjukebox:https://audio.jukehost.co.uk/hPtJYn6EPXREMhWwgZEHjjUF3apyEfXs