Disc Jockey Plus

Disc Jockey Plus: профессиональный мод для музыки на нотных блоках

Disc Jockey Plus — это неофициальная вилка оригинального мода Disc Jockey, полностью перенесённая на версии Minecraft Java 26.2 и 26.3. Мод добавляет профессиональные инструменты для создания и воспроизведения музыки: встроенную 88-клавишную пианино, визуализацию спектра в реальном времени, конвертацию между форматами NBS и MIDI, а также систему управления тембром и инструментами. Поддерживает более 30 языков, включая русский.

🎹 Встроенная 88-клавишная пианино

Мод предоставляет полноценное виртуальное пианино, охватывающее все 88 полутонов от A0 (−39) до C8 (48). Нота A0 принята за ноль, что обеспечивает строгую привязку к нотам NoteBlock и PianoLib.

Для быстрого тестирования и записи клавиши 1, 2 и 3 жестко закреплены за нотами A0, A#0 и B0. Поддерживается физическая раскладка клавиатуры (C-major): основные ноты на клавишах A S D F G H J K L ; ', чёрные клавиши на W E T Y U O P [ ].

Система автоматически выбирает лучший путь воспроизведения звука: сначала пробует PianoAPI, затем использует кэш PianoLib (pianolib:key_0-key_87), и в случае неудачи откатывается к NOTE_BLOCK_HARP. Это гарантирует, что музыка будет звучать как в меню, так и внутри мира. Доступна функция MIDI-записи с поддержкой педали сустейна, реверберации и ADSR-обертонов.

📊 Визуализация спектра в реальном времени

В интерфейсе мода реализована 16-полосная визуализация спектра с эффектом удержания пиков и экспоненциальным затуханием. Рендеринг происходит плавно без наложения изображений (ghosting).

Пользователь может переключаться между пятью стилями отображения прямо из GUI:

1. BAR (столбики)
2. WAVE (волна)
3. RING (кольцо)
4. MIRROR (зеркальное отображение)
5. PARTICLE (частицы).

Визуализация работает как в главном меню, так и в качестве HUD внутри игры (управляется настройкой spectrumAlwaysVisible). Она синхронизирована с процессом как основного воспроизведения, так и режима предпрослушивания.

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

Мод поддерживает воспроизведение файлов с расширением .nbs (нотные блоки). Доступны полный набор операций: воспроизведение, пауза, остановка, возобновление, цикл, случайный выбор и автозапуск очереди.

Встроенная система ремонта NBS (Clamp / Fold) работает неdestructively (безопасно). Если высота нот выходит за пределы допустимого диапазона 0-24, мод выполняет автоматическое фолдирование октав во время воспроизведения. Оригинальный файл не изменяется, на диск ничего не записывается, создаётся лишь временный кэш foldedNotes. Команды управления этим процессом включают fold auto (авто-ремонтирование), fold scan (проверка всех файлов) и fold info (отчёт по одному файлу).

🎼 Конвертация между MIDI и NBS

Интегрирована функция двусторонней конвертации музыкальных форматов.

Для экспорта из NBS в MIDI используется стандартный формат .mid, который включает маркеры темпа, такта (4/4) и разделители тактов. Файл сохраняется в папку midi/ и открывается автоматически.

Импорт MIDI в NBS осуществляется через встроенный выборщик файлов. Мод читает события нот, генерирует Song и корректно обрабатывает пустые файлы или ошибки парсинга, не прерывая работу.

🎚️ Система предпрослушивания

Позволяет прослушать треки как в меню, так и внутри мира. При выходе из мира используется источник звука SoundSource.MASTER, а после входа в мир автоматически переключается на playLocalSound.

Управление осуществляется клавишами:

• M: включение/выключение звука предпрослушивания.
• P: включение/выключение циклического воспроизведения предпрослушивания (настройки клавиш можно менять в разделе Controls).

Важно: режим предпрослушивания и воспроизведение трека являются взаимоисключающими; запуск одного автоматически останавливает другой.

🎷 Управление инструментами и тембром

Команда instrument позволяет подсчитать количество нотных блоков с указанным тембром в радиусе действия игрока.

Функция remapInstruments (переназначение инструментов) позволяет создать, удалить или просмотреть текущее состояние картинга. Это полезно для серверов, где определение типа инструмента может отличаться. Пример: можно сопоставить один тип инструмента с другим (например, с медными духовыми), чтобы обойти различия в детекции на сервере.

⚡ Настройки скорости и тональности

Команда speed изменяет скорость воспроизведения и предпрослушивания (по умолчанию 1.0). Эта настройка общая для обоих режимов.

Команда transpose позволяет изменить тональность текущего трека с использованием фолдирования октав. Алгоритм специально настроен так, чтобы сохранить ноту #F24 и не обрезать её при переносе октав.

🧰 Набор утилит и управление

Мод включает множество команд для удобного управления работой:

• reload: перезагрузка всех загруженных треков (поддерживает горячее обновление при изменении файлов).
• spectrum: включение/выключение отображения спектра в GUI.
• sleep: установка таймера остановки воспроизведения или отмена таймера.
• now / info / progress: вывод информации о текущем треке, его описания и текущего положения воспроизведения.
• clampstatus / fold status: проверка статуса ремонта треков.
• unclamp: отмена текущего процесса ремонта.
• help: вывод справки по всем командам.

🛡️ Защита от читов и технические детали

В мод внесены улучшения системы защиты от читов по сравнению с оригиналом, что делает его более устойчивым к манипуляциям на серверах.

Технически модуль построен на двухуровневой архитектуре спектра: SpectrumDataSmoother (обеспечивает плавность через удержание пиков и затухание) и SpectrumVisualizer (объединяет данные для воспроизведения и предпрослушивания). Для безопасного открытия окон используется механизм Main.openScreenOnNextTick, который откладывает запросы на следующий тик, предотвращая ошибки, возникающие при закрытии чата. Код написан с учётом обфускации (ProGuard keep rules), чтобы избежать ошибок VerifyError при запуске.

📜 Список основных команд

⚠️ Важные оговорки

Мод работает только с файлами, имеющими расширение .nbs. Система ремонта (Clamp/Fold) является временной и не меняет исходный файл на диске. Все привязки клавиш можно настроить в разделе "Controls".

Связанные материалы

• Better ModList — похожий мод

Автор: SQL_Minecraft · Лицензия: MIT