GMusic Modern JukeBox, Music & Note Block Plugin - GMusic 现代音乐盒与音符方块插件

GMusic 是一款功能强大的点唱机与音乐插件，允许你在 Minecraft 中使用音符盒音效播放你喜爱的歌曲。它拥有美观的 GUI 界面，可用于切换歌曲、调整音量、设置随机播放模式等。所有设置和功能均可通过插件配置与语言文件自定义，支持从 1.13 到 1.21.11 的 Bukkit、Spigot 与 Paper 服务端，无需任何额外 API 或插件即可运行。

💡核心特性

• 高度可定制：通过配置文件与语言文件调整几乎所有设置。
• 性能优异：经过优化，对服务器性能影响小。
• 易于使用：提供直观的命令和完整的 Tab 自动补全。
• GUI 控制：使用 /music 打开功能齐全的音乐控制界面。
• 格式转换：无需其他软件，直接在插件内转换 .mid 或 .midi 文件。
• 播放控制：支持播放、停止、暂停、恢复、随机播放、倒序播放歌曲。
• 智能功能：

- 动作栏信息提示。

- 按歌曲标题搜索。

- 玩家加入时自动恢复上次播放的歌曲或播放随机歌曲。

- 播放时可实时调整音量、播放模式、粒子效果、倒序等选项。

- 粒子效果与歌曲播放同步显示。

- 可标记收藏歌曲并使用“最爱”播放列表。

- 支持服务器全局随机电台。

• 环境音效：根据玩家所处环境（如水中）自动调整音乐音量与音效。
• 界面交互：在 GUI 中点击鼠标中键可将选项重置为默认值。
• PlaceholderAPI 支持：提供丰富的占位符，用于在其他插件中显示音乐信息。

🎮占位符列表

以下为 GMusic 提供的 PlaceholderAPI 占位符：

• %gmusic_option_volume% – 显示当前音量。
• %gmusic_option_join% – 显示欢迎音乐开启状态。
• %gmusic_option_playmode% – 显示当前播放模式。
• %gmusic_option_particles% – 显示粒子效果状态。
• %gmusic_option_reverse% – 显示倒序播放状态。
• %gmusic_option_toggle% – 显示玩家是否能听到点唱机音乐。
• %gmusic_playing% – 显示玩家是否正在听音乐。
• %gmusic_playing_title% – 显示当前播放歌曲的标题。
• %gmusic_playing_id% – 显示当前播放歌曲的 ID。
• %gmusic_playing_author% – 显示当前播放歌曲的作者。
• %gmusic_playing_original_author% – 显示当前播放歌曲的原作者。
• %gmusic_playing_description% – 显示当前播放歌曲的描述。
• %gmusic_playing_paused% – 显示当前歌曲是否已暂停。

🔧特殊点唱机与唱片

• 自定义点唱机：可给予玩家特殊的点唱方块，使其在方块周围播放音乐。

- 音乐音量会随玩家远离点唱机而衰减，衰减范围可在配置中调整。

- 玩家可使用 `/music toggle` 切换是否收听点唱机音乐。

• 自定义唱片：可将任何歌曲作为音乐唱片给予玩家。

- 这些唱片与原版 Minecraft 唱片功能相同，可放入普通点唱机中播放。

❓歌曲导入与转换

如何导入歌曲？

GMusic 使用独有的 .gnbs 文件格式来读取和播放歌曲。

• 若你已有 .gnbs 文件，将其放入插件目录下的 gnbs 文件夹并重载插件即可。
• 若你拥有 .nbs 文件（最常见的格式），只需将其放入 convert 文件夹，GMusic 将在下次重载时自动完成转换与导入。

如何获取歌曲文件？

• 你可以在互联网上搜索 .nbs 或 .gnbs 格式的歌曲文件，也有许多现成的歌曲合集可供下载。

如何转换其他音频格式？

• .mid 或 .midi 文件：直接放入 convert 文件夹，插件会自动转换。
• .mp3 文件：目前插件无法直接读取，需先使用第三方工具（如 Note Block Studio）将其转换为 .nbs 格式，再放入 convert 文件夹。

`.gnbs` 格式有何特殊之处？

• 新格式 .gnbs 支持中断单个音符的播放，提供了全新的播放选项。
• 支持创建可重复调用的“段落”，以及循环播放特定音轨。
• 该格式未加密，可直接用文本编辑器查看和编辑。

⭐命令列表

玩家命令 (`/music`)

• /music play <Song> – 播放指定 ID 的歌曲。
• /music playing – 查看当前播放的歌曲。
• /music random – 播放随机歌曲。
• /music stop – 停止当前歌曲。
• /music pause – 暂停当前歌曲。
• /music resume – 恢复已暂停的歌曲。
• /music skip – 跳过当前歌曲，播放下一首。
• /music toggle – 切换是否收听点唱机音乐。

管理员命令

• /amusic download <Type> <Song> <Path> – 从 URL 下载文件。
• /amusic jukebox <Player> [<Amount>] – 给予玩家指定数量的自定义点唱机。
• /amusic disc <Song> <Player> [<Amount>] – 给予玩家指定数量的特定歌曲唱片。
• /amusic radio – 打开服务器电台控制界面。
• /amusic play <Player> <Song> – 为指定玩家播放歌曲。
• /amusic playing <Player> – 查看指定玩家当前播放的歌曲。
• /amusic random <Player> – 为指定玩家播放随机歌曲。
• /amusic stop <Player> – 停止指定玩家的歌曲。
• /amusic pause <Player> – 暂停指定玩家的歌曲。
• /amusic resume <Player> – 恢复指定玩家已暂停的歌曲。
• /amusic skip <Player> – 为指定玩家跳过当前歌曲。
• /amusic toggle <Player> – 切换指定玩家收听点唱机音乐的能力。
• /gmusicreload – 重载所有配置与语言文件。

✨权限节点

通用权限

• GMusic.* – 包含所有权限（OP 默认拥有）。
• GMusic.Update – 接收更新通知。
• GMusic.GMusicReload – 使用 /gmusicreload 命令。

音乐播放权限 (默认给予所有玩家)

• GMusic.Music.* – 包含所有 /music 子命令权限。
• GMusic.Music – 使用 /music 命令。
• GMusic.Music.Play – 使用 /music play。
• GMusic.Music.Playing – 使用 /music playing。
• GMusic.Music.Random – 使用 /music random。
• GMusic.Music.Stop – 使用 /music stop。
• GMusic.Music.Pause – 使用 /music pause。
• GMusic.Music.Resume – 使用 /music resume。
• GMusic.Music.Skip – 使用 /music skip。
• GMusic.Music.Toggle – 使用 /music toggle。

管理员音乐权限

• GMusic.AdminMusic.* – 包含所有 /amusic 子命令权限。
• GMusic.AdminMusic – 使用 /amusic 命令。
• GMusic.AdminMusic.Play – 使用 /amusic play。
• GMusic.AdminMusic.Playing – 使用 /amusic playing。
• GMusic.AdminMusic.Random – 使用 /amusic random。
• GMusic.AdminMusic.Stop – 使用 /amusic stop。
• GMusic.AdminMusic.Pause – 使用 /amusic pause。
• GMusic.AdminMusic.Resume – 使用 /amusic resume。
• GMusic.AdminMusic.Skip – 使用 /amusic skip。
• GMusic.AdminMusic.Toggle – 使用 /amusic toggle。

交互权限

• GMusic.JukeBox – 使用自定义点唱机方块。
• GMusic.Disc – 使用自定义音乐唱片。

🔧已知问题与反馈

• 当前版本：暂无已知的未修复问题。
• 报告问题：如果你发现任何 Bug，请立即在插件讨论区留言、发送私信或加入 GPlugins Discord 服务器反馈，以便开发者尽快修复。

✨新增功能建议

如果你有新的功能想法，欢迎在插件讨论区提出、发送私信或加入 GPlugins Discord 服务器进行交流。

❓语言文件

切换语言

• 在 config.yml 中，将 Lang.lang 选项设置为目标语言代码。

添加新语言

• 复制现有的任一语言文件。
• 将其重命名为你需要的名称。
• 编辑文件中的消息文本。
• 在 config.yml 中将 Lang.lang 选项指向你新创建的文件。

---

附加信息

• 支持版本：全面兼容 Minecraft 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20 及 1.21。
• 官方 Discord：欢迎加入 GPlugins Discord 服务器获取支持与更新。
• 支持开发者：如果你喜欢这个插件，请留下好评以支持后续开发！

GMusic-API 为开发者提供了便捷的接口，允许您围绕 GMusic 插件创建自定义功能。它采用静态方法设计，无需复杂初始化即可直接调用。

🎮项目依赖集成

您可以通过 Gradle 或 Maven 将 GMusic-API 添加到您的项目中。

Gradle 集成

在 build.gradle 或 build.gradle.kts 文件中添加以下配置：

• 首先，添加 JitPack 仓库：

  repositories {
      maven(url = "https://jitpack.io/")
  }

• 然后，添加依赖项（请将 VERSION 替换为实际版本号）：

  compileOnly("com.github.Gecolay.GMusic:core:VERSION")

Maven 集成

在 `pom.xml` 文件中添加以下配置

• 首先，添加 JitPack 仓库：

  <repository>
      <id>jitpack.io</id>
      <url>https://jitpack.io</url>
  </repository>

• 然后，添加依赖项（请将 VERSION 替换为实际版本号）：

  <dependency>
      <groupId>com.github.Gecolay.GMusic</groupId>
      <artifactId>core</artifactId>
      <version>VERSION</version>
      <scope>provided</scope>
  </dependency>

🔧API 使用指南

GMusicAPI 是一个包含静态方法的工具类，无需初始化即可直接使用。

基础调用

您可以直接通过类名调用其方法，例如获取 API 实例：

GMusicAPI.getInstance();

方法列表与文档

要查看所有可用的 GMusicAPI 方法及其详细说明，请查阅最新的 API 文档：

GMusicAPI