Notica

Notica

Fabric-мод для проигрывания песен из нотных блоков в формате .nbs для ваших игроков. Этот мод совместим с ванильным сервером, то есть ванильные игроки тоже могут зайти без установленного мода. Игроки с установленным модом получают меньшее потребление сети, а также лучшее качество воспроизведения.

Демо

▶YouTube · плеер загрузится по нажатию

Возможности

Воспроизведение файлов NBS

Проигрывайте любую песню, созданную в Open Note Block Studio, на сервере или в одиночной игре. Поместите файлы .nbs в директорию config/notica/songs. Используйте команду `/music play for [players]`, чтобы проиграть песню.

Примечание: этот мод не включает в себя файлы песен, вам нужно скачать их самостоятельно. Множество NBS-песен можно найти на Noteblock World.

Клиентское воспроизведение песен

При подключении ванильного клиента каждая нота отправляется игроку отдельным пакетом. Это создаёт огромное количество отправляемых пакетов, что вызывает лаги и снижает качество воспроизведения.

Однако если у игрока установлен мод, ноты песни упаковываются в чанки и отправляются более крупными, но куда более редкими пакетами. Этот процесс похож на буферизацию видео.

Улучшенное качество воспроизведения

У ванильного Minecraft есть некоторые ограничения, влияющие на качество воспроизведения песен. Во-первых, ноты можно проигрывать только в определённом диапазоне октав (F#3 до F#5). Во-вторых, звуки должны иметь целочисленную позицию в мире, что вызывает звуковые артефакты, когда игрок движется во время воспроизведения. Кроме того, стереопанорамирование нот значительно хуже, потому что позиции нот округляются до ближайших целых значений.

У клиентов с установленной Notica этих ограничений нет, так как ноты проигрываются напрямую через OpenAL — звуковой движок, используемый Minecraft: Java Edition. Воспроизведение песен будет звучать так же, как в Open Note Block Studio.

Пользовательские инструменты

Любой звук Minecraft можно использовать как пользовательский инструмент в файлах .nbs. Notica поддерживает все возможности, связанные с пользовательскими инструментами, из спецификации формата файлов nbs (до версии 5).

Произвольный темп песни

Как и другие серверные проигрыватели nbs, Notica не ограничена определёнными темпами песен. Этот мод обеспечивает точность таймингов воспроизведения, запуская проигрывание песен асинхронно. Пакеты отправляются без синхронизации с серверным потоком, что иначе снова ограничило бы темп до 20 тиков в секунду.

Зацикливание песен

Версия 4 формата NBS вводит опции зацикливания, такие как вкл/выкл, максимальное число повторов и тик начала цикла. Этот мод поддерживает эти опции и будет автоматически зацикливать соответственно.

Подсказка: если песня зациклилась бесконечно, вы можете остановить её с помощью /music stop прямо в игре.

Расширенный диапазон октав

Как упоминалось ранее, Minecraft накладывает ограничение на высоту нот, ограничивая диапазон октав от F#3 до F#5. У игроков с модами этого ограничения нет, но ванильные игроки всё ещё затронуты. Ноты вне ванильного диапазона по умолчанию будут транспонированы для ванильных игроков, чтобы их можно было проиграть. Ванильные клиенты всё же могут проигрывать ноты вне ванильного диапазона, установив ресурспак extended notes. Ресурспак с дополнительными нотами можно установить, включив воспроизведение расширенного диапазона командой /music set extended_range true (только для ванильных игроков).

Позиционное воспроизведение музыки

Песни можно воспроизводить через «колонки» в точках мира. Колонка может иметь фиксированную позицию или быть привязана к сущности. Если сущность колонки движется, песня движется вместе с ней.

Эффект Доплера

Песни, привязанные к сущностям, могут включать эффект Доплера, который искажает высоту звука в зависимости от движения сущности относительно игрока. В настройках мода это можно расширить, чтобы учитывать также движение игрока. Это включит полную симуляцию эффекта Доплера с использованием OpenAL.

Команды

Все команды /music требуют OP или соответствующего разрешения, указанного в таблице выше.

Воспроизведение

Воспроизвести песню для себя:

/music play <song>

Воспроизвести песню для конкретных игроков или всех игроков онлайн:

/music play MySong.nbs for @a
/music play MySong.nbs global

Аргумент `— это путь к файлу.nbsотносительно директорииconfig/notica/songs`. Автодополнение по Tab предложит доступные файлы.

Песни, запущенные с global, также автоматически воспроизводятся для игроков, которые заходят на сервер, пока песня играет.

Громкость и параметры воспроизведения

Укажите громкость от 0.0 до 1.0 после аргумента слушателя:

/music play MySong.nbs for @a 0.7

Доступны два варианта воспроизведения: individual и streamed. По умолчанию используется streamed.

При воспроизведении individual каждая нота проигрывается напрямую через звуковую систему Minecraft, которая имеет лимит в 256 одновременно играющих звуков. Этот пул общий для всех остальных звуков игры. В песнях с большим количеством одновременных нот некоторые ноты могут пропадать, когда пул заполнен, и в этом случае другие звуки игры также могут обрезаться.

При воспроизведении streamed собственный аудиомикшер создаёт единый аудиопоток из всех нот. Это позволяет обрабатывать песни с любым количеством одновременных нот, сохраняя высокое качество звука, и не мешает другим звукам игры. Песни с большим количеством стереопанорамирования могут звучать немного иначе при воспроизведении individual по сравнению с streamed.

/music play MySong.nbs for @a 0.8 individual
/music play MySong.nbs for @a 0.8 streamed

Потоковое воспроизведение также поддерживает два режима стереомикширования: spatial (по умолчанию) и equal_power:

/music play MySong.nbs for @a 0.8 streamed equal_power

ID песен

У каждой активной песни есть ID. Если явный ID не указан, ID формируется из имени файла и имени игрока, выполнившего команду. Запуск песни таким способом автоматически останавливает все песни, уже играющие для затронутых слушателей.

Чтобы воспроизводить несколько песен одновременно, укажите явный ID с помощью ключевого слова id. Это также пропускает автоостановку:

/music play Ambient.nbs for @a 0.5 individual id myserver:ambient
/music play Theme.nbs for @a 0.8 id myserver:theme

ID также используется с /music stop и /music seek для выбора конкретной песни.

Позиционное воспроизведение

Песни можно воспроизводить через колонку в фиксированной позиции мира или привязанную к движущейся сущности:

/music play MySong.nbs at position 100 64 200
/music play MySong.nbs at position 100 64 200 for @a
/music play MySong.nbs at entity @e[type=armor_stand,limit=1]
/music play MySong.nbs at entity @e[type=armor_stand,limit=1] for @a

После громкости можно настроить дальность и радиус колонки. range (от 16 до 128) — максимальное расстояние в блоках, на котором песню можно услышать. radius (от 0 до 15) применяется к стереопесням и определяет, насколько далеко друг от друга размещаются левый и правый каналы колонки в мире:

/music play MySong.nbs at position 0 64 0 for @a 0.8 64 8

Использование режима монофонического канала сводит песню к единому точечному источнику. Это заставляет колонку вести себя как одна точка в пространстве, а не как разнесённая стереопара. Учтите, что сведение в моно сделает звук немного тише. Моно требуется для включения эффекта Доплера на колонках, привязанных к сущностям:

/music play MySong.nbs at position 0 64 0 for @a 0.8 streamed mono

#### Эффект Доплера

Сущности-говорящие с поддержкой моно потокового воспроизведения поддерживают эффект Доплера, который изменяет высоту тона в зависимости от скорости сущности относительно каждого слушателя. Для этого на клиенте должен быть установлен Notica:

/music play MySong.nbs at entity @e[type=minecart,limit=1] for @a 0.8 streamed mono doppler

### Остановка

Остановить все песни, играющие сейчас для вас:

/music stop

Остановить песни для конкретных игроков, все песни на сервере или конкретную песню по ID:

/music stop for /music stop all /music stop id /music stop for

Песни, запущенные с `global`, можно остановить только с помощью `/music stop id` или `/music stop all`.

### Добавление слушателей

Добавить игроков к уже играющей песне без её перезапуска:

/music add

### Перемотка

Перейти к определённой позиции в песне, используя `s`/`sec` для секунд, `m`/`min` для минут или `t`/`ticks` для тиков. Обычное число перематывает к абсолютной позиции; префикс `+` или `-` перематывает относительно текущей позиции:

/music seek 1m30s /music seek +10s /music seek -30t /music seek 50sec+3ticks

Перемотать для конкретных игроков или конкретной песни:

/music seek +10s /music seek +10s

### Клиентские настройки

Эти команды доступны всем игрокам и не требуют никаких прав.

Установить личную громкость воспроизведения (от 0 до 100 процентов):

/music set volume 75

Включить ресурспак с расширенным диапазоном октав (только для ванильных игроков, см. [Расширенный диапазон октав](#extended-octave-range)):

/music set extended_range true

## Права
Чтобы воспроизводить или останавливать музыку, вам нужно быть оператором сервера (иметь OP) или иметь соответствующие права:

| Действие                | Требуемое право             |
|-----------------------|---------------------------------|
| Воспроизведение музыки            | notica.command.music.play       |
| Воспроизведение позиционных песен | notica.command.music.play.positional   |
| Воспроизведение музыки другим  | notica.command.music.play.other |
| Остановка музыки            | notica.command.music.stop       |
| Остановка музыки для других | notica.command.music.stop.other |
| Перемотка музыки            | notica.command.music.seek |
| Перемотка музыки для других | notica.command.music.seek.other |


## Похожие проекты
- [Nota](https://modrinth.com/mod/nota) от PinkGoosik (Fabric, Quilt)
- [NoteBlockAPI](https://modrinth.com/plugin/noteblockapi) от koca2000 (Bukkit и производные)
- [NoteBlockMusicPlayer](https://modrinth.com/plugin/noteblockmusicplayer) от koca2000 (Bukkit и производные)

## API для разработчиков
Notica предоставляет API для разработчиков, чтобы другие моды могли использовать возможности Notica.
Документацию по API можно найти на [GitHub](https://github.com/LCLPYT/notica).