DreamVoice

🎙️ DreamVoice

Масштабное расширение пространственного звука, акустической физики и распознавания речи для Simple Voice Chat в Minecraft (Paper и Fabric)! Привнесите настоящую звуковую физику, звукоизолированные комнаты, офлайн-распознавание речи с ИИ, обнаружение ключевых слов, 3D-направленные динамики, скрытые шпионские микрофоны, рации, горячо загружаемые DSP-фильтры голоса, акустический визуализатор в реальном времени и воспроизводимые аудиокассеты прямо на ваш сервер Minecraft.

🌟 Что такое DreamVoice?

DreamVoice превращает голосовой чат по близости в по-настоящему иммерсивный аудиоопыт нового поколения. Разработанный для ролевых серверов, выживальческих SMP, игр на расследование и загадки, а также сюжетных мини-игр, он сокращает разрыв между механиками Minecraft и реальной аудиофизикой и распознаванием речи. С полноценной поддержкой как серверов Paper / Purpur (в виде плагина), так и серверов Fabric (в виде мода), звук больше не проходит магически сквозь толстые стены — он огибает открытые дверные проёмы, приглушается через твёрдые материалы, затухает внутри звукоизолированных комнат и реалистично взаимодействует с окружением. Игроки могут запускать внутриигровые события, произнося ключевые слова вслух, анализировать записанные кассеты на кафедрах для создания написанных книг, исследовать акустику в реальном времени с помощью внутриигрового 3D-визуализатора и экспортировать аудио в файлы MP3/OGG/WAV. Внешние моды на выживание и технологии могут даже создавать крафтящиеся динамики, жучки, рации и кассетные проигрыватели, которые бесшовно взаимодействуют с DreamVoice.

✨ Основные возможности

🧱 1. Реалистичная звуковая физика и звукоизолированные стены (VoiceWall)

• Умное звуковое затухание: Звук реалистично останавливается или приглушается за сплошными блоками камня, дерева, стекла и металла (STRICT_BLOCK или REALISTIC).
• Акустическая трассировка и дифракция: Звук естественно проходит через открытые двери, окна и огибает углы.
• Высокочастотное затухание в воздухе: Далекие голоса естественно теряют высокие частоты, звуча теплее и приглушённее через открытое пространство на расстоянии.
• Визуальная отладка частицами: Проверяйте распространение звука через рейкаст в реальном времени с помощью визуальных частиц и статистики в экшн-баре через /voicewall debug [player].

👁️ 2. 3D-акустический визуализатор в реальном времени (/voice visualizer)

• Живой 3D-рейкастинг: Отрисовывает динамические потоки частиц в реальном времени, показывая пути звука по прямой видимости, столкновения со стенами, маршруты дифракции через проёмы и сферы слышимости динамиков.
• Ручной режим с учётом производительности: Чтобы защитить FPS клиента и убрать визуальный шум, частицы отрисовываются только когда игрок держит инструмент визуализатора (Компас) в основной руке.

🏰 3. Акустические комнаты и звукоизолированные зоны

• Звукоизолированные и реверберирующие зоны: Определяйте пространственные кубоиды с настраиваемым процентом изоляции (isolationPct) и параметрами реверберации (decay, roomSizeMs, wetGain).
• Акустические пресеты: В комплекте встроенные пресеты (soundproof, studio, cathedral, bunker).
• Динамическое наложение фильтров: Автоматически применяет вокальные эффекты (например, приглушение, эхо, пещерную реверберацию) при входе в определённые комнаты и убирает их при выходе.

🗣️ 4. Распознавание речи и обнаружение ключевых слов в реальном времени (KWS)

• Обнаружение ключевых слов в реальном времени: Лёгкое фоновое распознавание ключевых слов на базе офлайн-моделей Vosk с ограниченной грамматикой ([unk], нулевые галлюцинации).
• События по голосовой активации: Запускает события для кастомных ролевых заклинаний, дверей с голосовой активацией, кодовых фраз и механик мини-игр.
• Умное аудиостробирование: RMS-шумовой гейт (minEnergyThreshold) и автоматическая очистка фонетического буфера на паузах (silenceResetMs) для устранения фантомных срабатываний.
• Интерактивные станции транскрипции кассет: Кликните правой кнопкой по кафедре или музыкальному блоку с аудиокассетой, чтобы проанализировать речь и получить постраничную написанную книгу с временными метками и именами говорящих.
• Гибридный движок: Работает на 100% офлайн внутри JVM (Vosk) или может передавать транскрипцию внешнему контейнеру Whisper Sidecar.

📢 5. 3D-локационные динамики и физические трансляции

• Размещайте направленные 3D-динамики в любом месте мира на статичных координатах.
• Прикрепление к сущностям: Устанавливайте динамики на движущийся транспорт, дроны, стойки для брони или NPC!
• Двойные каналы: Говорите через микрофон, одновременно воспроизводя фоновую музыку/звуковые эффекты без коллизий.
• Трансляции с трибуны и интеркома: Точки трансляции направляют голоса в радиусе захвата к целевым динамикам или по всему серверу.

👻 6. Голосовые проекции и камеры безопасности

• Проецируйте свой голос удалённо на любой целевой блок или движущуюся сущность.
• Слушайте, что слышит камера или удалённая точка — идеально для камер видеонаблюдения, интеркомов, дронов-наблюдателей или магических проекций.

🕵️ 7. Скрытые прослушки и жучки

• Устанавливайте скрытые микрофоны на секретных координатах или крепите жучок прямо на NPC или игрока.
• Слушайте секретные разговоры в реальном времени или записывайте их прямо на внутриигровую аудиокассету!
• Кросс-модульное распространение: Прослушки реалистично перехватывают голоса, исходящие от голосовых проекций.

📼 8. Аудиокассеты и экспорт аудио в нескольких форматах

• Записывайте живые голосовые разговоры с прямым Opus-стримингом без затрат CPU (OpusAudioPlayer).
• Создаёт физический предмет кассеты, который игроки могут держать и воспроизводить правым кликом или загружать в 3D-динамики.
• Асинхронный экспорт аудио: Экспортируйте любую запись сессии прямо в файлы MP3, OGG или WAV через /record export.
• Нарезка по таймлайну: Извлекайте определённые сегменты или последние N секунд из любой записи (/record slice).

📻 9. Рации и радиоканалы

• Подключайте игроков к определённым каналам радиочастот для тактической связи команды, полицейской диспетчерской или выживальческих раций.
• Аутентичный аналоговый полосовой фильтр (300 Гц - 3400 Гц) со щелчками микрофона при нажатии кнопки передачи.
• Направленные передатчики: Двухточечная передача голоса с настраиваемой дальностью.

🎛️ 10. Динамические DSP-фильтры голоса и файловый конвейер

• Преобразуй голоса игроков на лету с помощью 13 встроенных фильтров (alien, cave, deep, disguise, gasmask, ghost, helium, megaphone, muffled, radio, robot, telephone, underwater).

• Файлы с горячей перезагрузкой (.yml, .json, .java):

  • Декларативные DSP-цепочки (lowpass, highpass, gain, overdrive, ring_modulator, delay/echo).
  • Компиляция JDK на лету для пользовательских исходников фильтров .java.
• Экспортёр фильтров: Экспортируй активные фильтры в YAML/JSON-цепочки или исходники Java (/voice filter export).
• Встроенный Soft-Knee Dynamic Limiter предотвращает клиппинг и искажения микрофона.

🛠️ 11. Интерактивный GUI конфигурации (/voice config)

• Открой полноценную визуальную панель GUI для настройки и мониторинга всех модулей без правки конфигов.
• Интерактивный инструмент (Echo Shard) для нацеливания на сущностей, блоки или позиции в реальном времени.

📡 12. Сетевые пакеты Fabric и межмодовая экосистема

• 40+ пользовательских пакетов (@DreamPacket), позволяющих сторонним модам на выживание, технологии и компаньонов создавать и управлять динамиками, жучками, радио, кассетами и фильтрами без жёстких зависимостей компиляции.

🕹️ Краткий справочник команд

📦 Установка

Для серверов Paper / Purpur:

1. Убедись, что твой сервер работает на Paper или Purpur (версия 26.1.2+ с Java 25+).
2. Установи Simple Voice Chat (2.6.20+).
3. Помести DreamVoice.jar в директорию plugins/ твоего сервера.
4. Перезапусти сервер.

Для серверов Fabric:

1. Убедись, что твой сервер работает на Fabric Loader 0.19.3+ для Minecraft 26.1.2+ с Java 25+.
2. Установи Fabric API и Simple Voice Chat Fabric.
3. Помести DreamVoice-fabric-2.0.1.jar в директорию mods/ твоего сервера.
4. Перезапусти сервер.

💻 API для разработчиков

DreamVoice включает единый публичный API (DreamVoiceAPI.get()) для создания пользовательских плагинов, модов Fabric и мини-игр.

📦 Gradle Kotlin DSL (build.gradle.kts)

repositories {
    mavenCentral()
    maven("https://jitpack.io")
    maven("https://repo.papermc.io/repository/maven-public/")
}

dependencies {
    compileOnly("com.github.Dreamin-MC.DreamVoice:api:2.0.1")
}

📦 Gradle Groovy (build.gradle)

repositories {
    mavenCentral()
    maven { url = "https://jitpack.io" }
    maven { url = "https://repo.papermc.io/repository/maven-public/" }
}

dependencies {
    compileOnly "com.github.Dreamin-MC.DreamVoice:api:2.0.1"
}

📦 Настройка мода Fabric (Fabric Loom)

repositories {
    mavenCentral()
    maven { url = "https://jitpack.io" }
}

dependencies {
    modCompileOnly "com.github.Dreamin-MC.DreamVoice:api:2.0.1"
}

📦 Maven (pom.xml)

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
    <repository>
        <id>papermc</id>
        <url>https://repo.papermc.io/repository/maven-public/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.github.Dreamin-MC.DreamVoice</groupId>
        <artifactId>api</artifactId>
        <version>2.0.1</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

📄 Лицензия и ссылки

• Исходный код: GitHub - Dreamin-MC/DreamVoice
• Официальная вики и руководства: DreamVoice Wiki
• JavaDoc API: GitHub Pages - DreamVoice API
• Лицензия: GNU General Public License v3.0