SonicPulse

SonicPulse

Профессиональный мод для стриминга аудио и реактивной визуализации для Minecraft Fabric, поддерживающий Minecraft 26.3 ("Wilderness Bound") и 1.21.4. Стримь музыку с YouTube, SoundCloud, Bandcamp, Vimeo, интернет-радио и локальных файлов — всё прямо из Minecraft, с потрясающей реактивной HUD-лентой, пульсирующей в такт биту.

✨ Возможности

🎵 Стриминг аудио

• Воспроизведение с YouTube – Вставь любую ссылку на YouTube, и трек заиграет мгновенно
• SoundCloud / Bandcamp / Vimeo – Прямой стриминг по URL для всех основных платформ
• Интернет-радио (M3U) – Загружай и сохраняй плейлисты M3U-потоков со встроенными пресетами BBC
• Воспроизведение локальных файлов – Просматривай и стримь файлы .mp3, .flac и .wav со своего компьютера
• Избранное и история – Сохраняй, переименовывай, меняй порядок и перезапускай треки одним кликом

🌊 Реактивный визуализатор HUD

• Эквалайзерные полосы в реальном времени – Анимированные FFT-полосы частот, отрисовываемые прямо на HUD-ленте
• Несколько визуальных стилей – Block, Line, Wave, Mirror, Peak, Dots и другие
• Фоновые эффекты – Pulse flash, Aura gradient drift, VHS glitch, Heatmap и Starfield
• Аудио-реактивный скин – Граница и фон HUD динамически реагируют на музыку
• Цветовые темы – Более 20 подобранных палитр для полос, текста заголовка и акцентов
• Логотип SonicPulse – Анимированный текстовый логотип с настройкой каждого цвета

🎧 DSP-аудиодвижок

• Эквалайзер Bass & Treble – Слайдеры усиления по частотам (от –100% до +100%)
• Расширение стерео – Расширение звуковой сцены от Mono (0%) до Super Wide (200%)
• Автоприглушение под водой – Автоматический low-pass фильтр при погружении
• Буферизация потока – Настраиваемый буфер предзагрузки (0–15 с) для защиты от заиканий на медленном соединении
• Полоса прогресса буфера – Индикатор загрузки в реальном времени внизу HUD

⚙️ Управление деком

• Транспортные кнопки в конфиге – ⏮ Назад, ▶/⏸ Играть/Пауза, ⏹ Стоп, ⏭ Вперёд прямо в экране настроек
• Быстрые ярлыки – Кнопки Play Favs и Play Local в шапке в один клик
• Режимы сессии – Remote, Radio, Favourites, History и Local отслеживаются для каждой сессии

🎮 Клавиши по умолчанию

СОВЕТ: Клавишу конфига можно переназначить в Options ➔ Controls ➔ Key Binds в категории SonicPulse.

📦 Установка и совместимость

Выбери файл релиза, соответствующий твоей версии Minecraft:

Для Minecraft 26.3 (v1.1.0)

• Minecraft: 26.3
• Fabric Loader: >= 0.19.5
• Fabric API: >= 0.161.0+26.3
• Java: 25 LTS

Для Minecraft 1.21.4 (v1.0.0)

• Minecraft: 1.21.4
• Fabric Loader: >= 0.16.9
• Fabric API: 0.119.4+1.21.4
• Java: 21

Шаги

1. Установи Fabric Loader для своей версии Minecraft.
2. Скачай Fabric API и положи его в папку .minecraft/mods.
3. Скачай подходящую версию SonicPulse (SonicPulse-1.1.0.jar для 26.3 или SonicPulse-1.0.0.jar для 1.21.4).
4. Положи .jar-файл в папку .minecraft/mods.
5. Запусти Minecraft через профиль Fabric.
6. Нажми P в игре, чтобы открыть экран настроек SonicPulse и начать стриминг! Примечание: SonicPulse включает собственный аудиодвижок (LavaPlayer) — внешний сервер или дополнительное приложение не требуются.

---

⚙️ Настройка

Нажми P в игре, чтобы открыть полный экран настроек. Девять отдельных вкладок держат все настройки под рукой:

Вкладка	Содержимое
📡 REMOTE	Вставка ссылок YouTube / SoundCloud / прямых URL, недавние стримы
🎨 VISUAL	Видимость HUD, скины, логотип, название трека, стиль EQ-полос, фоновые эффекты, цвета
📐 LAYOUT	Порядок элементов (Logo / Track / Bars), масштаб HUD, ширина HUD
🕒 HIST	Повтор или удаление недавно проигранных треков
★ FAVS	Управление избранным — порядок, переименование и быстрый запуск
📻 RADIO	M3U интернет-радио с пресетами BBC и 4 слотами для своих станций
♫ LOCAL	Просмотр и воспроизведение аудиофайлов с компьютера
⚙ ENGINE	Буферизация потока, полоса буфера, Bass EQ, Treble EQ, Stereo Width, приглушение под водой
i ABOUT	Информация о версии, проверка обновлений, QR-код для донатов

Подробнее о визуальных эффектах

Эффект	Что делает
PULSE	Реактивная вспышка на бит — настраиваются интенсивность и затухание
AURA	Медленно смещающийся градиент; настраиваются скорость и палитра оттенков
VHS	Глитч с раздвоением пикселей на басовых ударах, опционально CRT-развёртка
HEATMAP	Тепловой цветовой градиент, синхронизированный с амплитудой частот
STARFIELD	Частицы-искры, вылетающие на басовых ударах — настраиваются количество и затухание

---

📋 Планы

Рассматривается для будущих обновлений:

• Environmental Reverb – Виртуальные пресеты Hall, Cave и Large Room
• Discord Rich Presence – Опциональное отображение названия трека и исполнителя в статусе
• Sync-Link Chat Sharing – Обмен ссылками на стримы прямо в чате Minecraft
• Server Radio – Вещание на весь сервер для мультиплеера
• 3D Positional Audio – Затухание по расстоянию, привязанное к блокам Jukebox
• Dynamic Metadata Fetching – Автоматическая разметка сырых URL без встроенной информации о треке
• Redstone-Sync Visuals – Музыкально-реактивные Redstone-триггеры на основе амплитуды

---

🤝 Участие

Вклад и отзывы всегда приветствуются!

• Сообщить об ошибке: Открой issue на GitHub с шагами воспроизведения и соответствующими логами.
• Предложить функцию: Делись идеями в разделе issues на GitHub.
• Pull Requests: Форкни, напиши код и отправь PR!

---

📄 Лицензия

Проект распространяется под MIT License.

📊 История версий

v1.1.0 – (2 октября 2026)

• НОВОЕ: Полная совместимость с Minecraft 26.3 ("Wilderness Bound")
• НОВОЕ: Обновлённый тулчейн до Java 25 LTS и Gradle 9.8.0 с Fabric Loom 1.18.2

• NEW: Рендеринг переведён на GuiGraphicsExtractor из Minecraft 26.3 и Matrix3x2fStack из JOML
• NEW: Регистрация HUD обновлена до HudElementRegistry.attachElementAfter(VanillaHudElements.CHAT, ...)
• NEW: Система сетевых пакетов переведена на CustomPacketPayload с Identifier.fromNamespaceAndPath
• NEW: Переключатель авто-заглушения под водой во вкладке Engine
• NEW: Слайдер стереоширины DSP (0% моно → 100% обычный → 200% суперширокий)
• NEW: Кнопки быстрого запуска «Play Favs» / «Play Local» в шапке конфига
• NEW: Кнопка доната во вкладке About со ссылкой на PayPal через встроенный в Minecraft ConfirmLinkScreen
• NEW: Проверка версий в реальном времени — опрашивает API Modrinth и показывает значок обновления, если вышла новая версия
• FIXED: Воспроизведение YouTube зависало на 39% — обновлено до dev.lavalink.youtube 1.18.2 и стабилизирован Android-клиент
• FIXED: Зависание буфера при ошибке загрузки потока — onTrackException теперь сразу сбрасывает состояние буферизации
• FIXED: Отрисовка QR-кода на экране About (исправлены UV-координаты и рамка)
• CHANGED: Виджеты ConfigScreen переведены на Button, EditBox и AbstractSliderButton

v1.0.0 – (декабрь 2024 / январь 2025)

• NEW: Первый релиз для Minecraft 1.21.4
• NEW: Профессиональная потоковая передача аудио и реактивная лента визуализатора
• NEW: Удалённое воспроизведение аудио на базе LavaPlayer и источника YouTube
• NEW: Внутриигровой экран конфига с настраиваемыми цветовыми палитрами, темами и макетами
• NEW: Аудиоконвейер DSP в реальном времени с эквалайзером, расширением стерео и заглушением под водой
• NEW: Интеграция с ModMenu и поддержка собственных привязок клавиш

☕ Поддержка

Нравится SonicPulse? Угостите Стива кофе — QR-код и кнопка есть на вкладке About в игре, или воспользуйтесь ссылкой ниже. ☕ Угостить Стива кофе (PayPal)

🙏 Благодарности

• Создано с использованием Fabric и LavaPlayer
• Поддержка YouTube через lavalink-devs/youtube-source
• Вдохновлено сообществом моддеров Minecraft