**NoteBlockAPI** is a library that allows other plugins to play songs from **.nbs files** made in OpenNoteBlockStudio. The original author of the NoteBlockAPI is xxmicloxx. His old outdated Bukkit thread can be found here.<\/p>\n
# Features<\/p>\n
NoteBlockAPI can be used in your project to play songs:<\/p>\n
* from .nbs files
\n* with custom instruments (using resource pack)
\n* with extended octave range (using resource pack)
\n* with timings that Minecraft’s redstone doesn’t support<\/p>\n
# Planned features<\/p>\n
These features are currently not present in NoteBlockAPI but are planned in future.<\/p>\n
* support for MIDI file format
\n* support for Folia<\/p>\n
# How to use NoteBlockAPI or any plugin that use it<\/p>\n
If your or someone’s plugin uses NoteBlockAPI, you need to install it on your server by coping its .jar to plugins directory. The rest is up to the plugin you use together with the NoteBlockAPI. Since this is only a library it has no configuration or commands.<\/p>\n
If you are a developer that wants to use NoteBlockAPI in their project, take a look to NoteBlockAPI’s wiki for more information.<\/p>\n
# How to get nbs songs<\/p>\n
There are several ways how you can get .nbs songs.<\/p>\n
1. Create your song or cover in OpenNoteBlockStudio
\n2. Convert your song from midi to nbs in OpenNoteBlockStudio
\n3. Download premade nbs songs from internet<\/p>\n
# Builds<\/p>\n
* **Release:** Modrinth, SpigotMC
\n* **Development build:** Jenkins<\/p>\n
# Known issues<\/p>\n
* Playback of songs with more than 20 TPS (ticks per second) may be laggy because of BukkitScheduler – will be resolved in NoteBlockAPI v2.0<\/p>\n
# Support<\/p>\n
If you need any help or if you have an issue while using NoteBlockAPI, you can create an issue on Github, join my Discord server or send me a PM on Spigot forums.<\/p>\n","protected":false},"excerpt":{"rendered":"
Library that allows playback of nbs songs<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"noteblockapi","_minecraft_project_id":"7FN5Qhm4","_minecraft_author":"koca2000","_minecraft_license":"LGPL-3.0-only","_minecraft_downloads":5435,"_minecraft_follows":9,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"noteblockapi.zip","_minecraft_size_bytes":369322,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T03:14:11.114307Z","_minecraft_date_created":"2024-01-06T21:44:54.148660Z","_minecraft_date_modified":"2026-03-25T15:24:51.917520Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/noteblockapi","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-06T17:04:25+00:00","_minecraft_import_hash":"5d03cb7d3e9e520809b922abfa28e8c8","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,873,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864,83],"class_list":["post-113905","mod","type-mod","status-publish","hentry","mod_category-bukkit","mod_category-library","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1"],"yoast_head":"\n