VoiceCraft.Java

VoiceCraft.Java - это плагин для серверов Майнкрафт, который решает давнюю проблему: как сделать так, чтобы игроки с разными голосовыми клиентами могли слышать друг друга в одном голосовом чате. Если у вас на сервере кто-то использует Simple Voice Chat, кто-то Plasmo Voice, а кто-то вообще заходит с Bedrock через Geyser - раньше они были бы в разных "голосовых вселенных". Теперь нет.

Что это и зачем нужно

VoiceCraft.Java - это прослойка между разными голосовыми модами. Она работает на стороне сервера и синхронизирует позиции, повороты, дистанцию, эхо в пещерах, приглушение под водой и даже статусы (говорит/молчит/заглушён). Всё это - в реальном времени и для всех игроков одновременно.

Особенно полезно для серверов с кросс-плеем (Java + Bedrock). Игроки на Java могут оставить свои любимые моды для голосового чата, а бедрокеры просто подключаются через отдельный клиент VoiceCraft - без установки Java-модов.

Как это работает

Клиент игрока	Как подключается
VoiceCraft клиент	Подключается к бэкенду VoiceCraft и привязывается к игроку через /voice bind
Simple Voice Chat	Напрямую через встроенный адаптер Paper
Plasmo Voice	Напрямую через встроенный адаптер Paper
Bedrock через Geyser	Использует отдельный клиент VoiceCraft, Java-моды не нужны

Все подключённые игроки находятся в одном позиционном аудио-пространстве. Плагин синхронизирует миры Minecraft, координаты, поворот головы, дистанцию, эхо в пещерах, приглушение под водой, айдентику игрока, состояние речи и поддерживаемые состояния mute/deafen.

Особенности

• Кроссклиентный позиционный голосовой чат между VoiceCraft, Simple Voice Chat и Plasmo Voice.
• Голосовой чат для Java и Bedrock игроков в одном разговоре.
• Встроенные адаптеры SVC и Plasmo - не нужен отдельный серверный плагин для голоса.
• Автоматическая загрузка, настройка, запуск и остановка VoiceCraft Server на Paper.
• Прямой режим для одного сервера Paper.
• Режим Velocity и BungeeCord для сетей из нескольких серверов.
• Поддержка UDP релеев для SVC и Plasmo через прокси-сети.
• Синхронизация позиции, измерения, дистанции, эха и звука под водой.
• Локализованные конфиги и сообщения.

Статусы голоса для ванильных игроков и Bedrock

Игроки без SVC или Plasmo могут видеть лёгкие ванильные индикаторы статуса голоса над другими игроками без модов. Эти индикаторы работают через Geyser и показывают: отключён, подключён, говорит, заглушён или приглушён.

Оверлей виден только тем, у кого нет своего мода: игроки с SVC или Plasmo его не видят, чтобы не было наложения с их родными индикаторами. Каждый символ, цвет, высота, интервал обновления и дистанция просмотра настраиваются.

Режимы установки

Paper

Просто установите jar-файл на сервер Paper. Плагин может сам скачать и управлять подходящей версией VoiceCraft Server или подключиться к уже существующему бэкенду.

Включите адаптеры Simple Voice Chat и/или Plasmo Voice в config.yml, если хотите принимать таких клиентов. По умолчанию оба адаптера отключены.

Velocity или BungeeCord

Установите VoiceCraft.Java на прокси и каждый бэкенд Paper. Прокси управляет центральным подключением к VoiceCraft, а бэкенды предоставляют состояние игрока и сессии адаптеров. Опциональные UDP релеи держат клиентов SVC и Plasmo подключёнными при перемещении между серверами.

Требования

• Java 21.
• Paper для голосовых адаптеров и управления VoiceCraft.
• Velocity или BungeeCord только если у вас сеть из нескольких серверов.
• Доступные UDP порты для каждого включённого адаптера.

Когда адаптер VoiceCraft.Java включён, он выступает как серверная точка для этого клиентского мода. Не запускайте оригинальный плагин Simple Voice Chat или Plasmo Voice на том же Paper с теми же каналами или портами - будет конфликт.

Что важно знать

VoiceCraft.Java фокусируется на том, что важно для общего опыта: позиционный звук, идентификация игрока, состояние речи и управление голосом. Клиентские фишки вроде приватных групп Simple Voice Chat остаются внутри своей экосистемы - плагин их не эмулирует для других клиентов.

Поддерживаемые платформы

• Paper
• Purpur
• Velocity
• BungeeCord

Лицензия: GNU Affero General Public License v3.0 или новее.