NoteBlockAPI
Библиотека для воспроизведения .nbs песен в Minecraft. Позволяет плагинам проигрывать музыку с кастомными инструментами и точным таймингом.
NoteBlockAPI - это библиотека для серверных плагинов, которая добавляет возможность воспроизводить песни из файлов .nbs, созданных в программе OpenNoteBlockStudio.
В ванильном Майнкрафт нотные блоки работают через редстоун - длительность ноты ограничена геймтиками, а набор инструментов жёстко привязан к блоку под нотным блоком. Если хочешь сделать на сервере полноценную музыкальную систему с точным таймингом и нестандартными звуками - без этой библиотеки не обойтись.
Что умеет NoteBlockAPI
- Проигрывать песни из .nbs файлов
- Использовать кастомные инструменты через ресурспаки (текстурпаки)
- Расширять диапазон октав (тоже через ресурспак)
- Соблюдать тайминги, которые редстоун не поддерживает - ноты звучат ровно столько, сколько нужно
Как установить
Если какой-то плагин использует NoteBlockAPI, просто скопируй .jar библиотеки в папку plugins на сервере. Дальше всё настроит сам плагин - у NoteBlockAPI нет своих конфигов или команд.
Где взять .nbs песни
- Создать свою композицию или кавер в OpenNoteBlockStudio
- Конвертировать MIDI-файл в .nbs там же
- Скачать готовые песни из интернета (их много в сообществе)
Планируется в будущем
- Поддержка формата MIDI напрямую
- Поддержка Folia (регионная система тиков)
Известные проблемы
При воспроизведении песен с частотой больше 20 TPS (тиков в секунду) возможны лаги из-за BukkitScheduler - это исправят в версии 2.0.
Сборки
- Релиз: Modrinth, SpigotMC
- Сборка для разработки: Jenkins
Если нужна помощь - создавай issue на GitHub или пиши на форуме Spigot (ссылки есть на странице проекта).