hVoiceChat (Эйч войсчат)

Плагин для серверов Майнкрафт, объединяющий голосовой чат Simple Voice Chat и Plasmo Voice. Игроки с любым из этих клиентских модов слышат находящихся рядом игроков из другой системы, сохраняя обычную связь с пользователями того же голосового чата.

Возможности

• Двусторонний голосовой чат по близости между Simple Voice Chat и Plasmo Voice.
• Сохранение дистанции голоса; для шёпота в Simple Voice Chat используется примерно треть обычной дистанции.
• Ограничение дистанции передаваемого голоса от 1 до 128 блоков.
• Защита от двойного воспроизведения и эха у игроков, установивших оба голосовых мода.
• Определение клиента каждого игрока и одноразовые награды за использование голосового чата.
• Режимы награды: ANY, BOTH, SIMPLE и PLASMO.
• Отдельные действия для игроков с Simple Voice Chat, Plasmo Voice или обоими модами.
• Защита от повторного получения награды по UUID, а при antiIPAbuse: true — и по IP-адресу.
• Хранилище SQLite или MySQL.
• Статусы и счётчики PlaceholderAPI, включая %voicechataddon_voice%, %voicechataddon_voice_total%, %voicechataddon_voice_simple%, %voicechataddon_voice_plasmo% и %rel_voicechataddon_voice%.
• Синхронизация мута с LiteBans: заглушённый игрок не может передавать голос через обе системы.
• Настраиваемые действия: сообщения, команды консоли и игрока, звуки, титры, строка действия, босс-бар, частицы, эффекты, фейерверки и операции Vault.

Приватные группы и каналы двух голосовых модов не объединяются: мост передаёт только голос по близости. Он работает в пределах одного серверного бэкенда и не передаёт звук между разными бэкенд-серверами.

Команды

• /voice — проверяет голосовой мод игрока и выдаёт одноразовую настроенную награду.
• /voice reload — перезагружает настройки, состояние моста и кэш голосовых статусов.
• /voicechataddon <player> — показывает подробный отчёт об игроке: обнаруженные клиенты, состояние моста и совместимость голосового чата.

Права

• voicechat.addon.reload — доступ к /voice reload.
• voicechat.addon.debug — доступ к /voicechataddon <player>.

Настройка

Главный файл: plugins/voicechat-addon/config.yml.

Для моста добавьте обе системы в settings.voiceChats и включите settings.bridgeVoiceChats: true:

settings:
  voiceChats:
    - PLASMO
    - SIMPLE
  bridgeVoiceChats: true

В settings.mode выберите условие для награды: ANY — любой поддерживаемый голосовой мод, BOTH — оба, SIMPLE — только Simple Voice Chat, PLASMO — только Plasmo Voice. Действия для наград, подсказки об установке и сообщения о муте задаются в разделе actions.

Обычные настройки и действия применяются через /voice reload. После изменения типа базы данных или её реквизитов требуется полный перезапуск сервера. SQLite хранит данные в plugins/voicechat-addon/storage.db; для MySQL указываются host, port, database, username и password.

При включённом antiIPAbuse учитывайте общие сети игроков и корректную передачу настоящих IP-адресов через прокси.

Требования

• Paper или совместимый сервер на Java 21 или новее.
• PlaceholderAPI.
• Simple Voice Chat или Plasmo Voice.
• Для голосового моста нужны обе серверные версии голосовых плагинов на одном бэкенд-сервере; каждому игроку достаточно одного из клиентских модов.
• LiteBans — для запрета голосовой передачи заглушённым игрокам.
• Vault и подключённый плагин экономики — для действий [VAULT].

В сети Velocity плагин размещается на каждом Paper-бэкенде, где нужны его функции.