**NoteBlockAPI** 是一个库，允许其他插件播放从 [OpenNoteBlockStudio](https://opennbs.org/) 创建的 **.nbs 文件** 中的歌曲。NoteBlockAPI 的原始作者是 xxmicloxx。 他的旧的、过时的 Bukkit 帖子可以在 [这里](https://dev.bukkit.org/projects/noteblockapi) 找到。
# 特性
NoteBlockAPI 可以在您的项目中用于播放歌曲：
* 来自 .nbs 文件
* 使用自定义乐器（使用资源包）
* 使用扩展的八度范围（使用 [资源包](https://github.com/koca2000/NoteBlockAPI/blob/master/Instruments.zip)）
* 使用 Minecraft 红石不支持的时间
# 计划中的特性
这些特性目前尚未在 NoteBlockAPI 中实现，但在未来会被计划。
* 支持 MIDI 文件格式
* 支持 Folia
# 如何使用 NoteBlockAPI 或任何使用它的插件
如果您的或某人的插件使用 NoteBlockAPI，您需要通过将 .jar 文件复制到 plugins 目录，将其安装在您的服务器上。 其余的取决于您与 NoteBlockAPI 一起使用的插件。 由于这仅仅是一个库，因此它没有配置或命令。
如果您是一名想要在他们的项目中使用的 NoteBlockAPI 的开发者，请查看 [NoteBlockAPI 的 Wiki](https://github.com/koca2000/NoteBlockAPI/wiki/Getting-started) 以获取更多信息。
# 如何获取 nbs 歌曲
有几种方法可以获取 .nbs 歌曲。
1. 在 [OpenNoteBlockStudio](https://opennbs.org/) 中创建您的歌曲或翻唱
2. 在 [OpenNoteBlockStudio](https://opennbs.org/) 中将您的歌曲从 midi 转换为 nbs
3. 从互联网下载预制的 nbs 歌曲
# 构建
* **发布版:** [Modrinth](https://modrinth.com/plugin/noteblockapi), [SpigotMC](https://www.spigotmc.org/resources/noteblockapi.19287/)
* **开发版:** [Jenkins](https://ci.haprosgames.com/job/NoteBlockAPI/)
# 已知问题
* 超过 20 TPS（每秒滴答数）的歌曲播放可能会因 BukkitScheduler 而出现卡顿 - 将在 NoteBlockAPI v2.0 中解决。
# 支持
如果您需要任何帮助或在使用 NoteBlockAPI 时遇到问题，您可以在 [Github](https://github.com/koca2000/NoteBlockAPI/issues) 上创建一个 issue，加入我的 [Discord 服务器](https://discord.gg/TeUBgb5) 或在 [Spigot 论坛](https://www.spigotmc.org/members/koca2000.31464/) 上给我发送 PM。