SimpleComforKOOK

SimpleComforKOOK — голосовой мост Minecraft в KOOK

Передавайте голос с вашего Minecraft-сервера в голосовые каналы KOOK в реальном времени!

🎙️ Возможности

• Передача голоса в реальном времени: голос игроков Minecraft автоматически передаётся в голосовые каналы KOOK
• Микширование нескольких игроков: поддерживается одновременная речь нескольких игроков с автоматическим микшированием
• Кроссплатформенность: доступны три версии — Fabric, Forge и Bukkit/Spigot
• Низкая задержка: оптимизированная обработка звука обеспечивает плавную передачу голоса
• Автоподдержание соединения: соединение с голосовым каналом KOOK поддерживается автоматически, без ручного переподключения

📋 Подготовка

1. Установите клиент SimpleCom

Игрокам нужно локально установить голосовой клиент SimpleCom для захвата и передачи голоса.

2. Настройте KOOK-бота

Администратору сервера нужно:

1. Создать бота на платформе разработчиков KOOK
2. Получить токен бота
3. Добавить бота на ваш сервер KOOK
4. Получить ID целевого голосового канала

3. Установите сервер SimpleCom

Серверу нужно запустить сервер SimpleCom для приёма голосовых данных игроков.

🚀 Быстрый старт

Пользователи Fabric/Forge

1. Скачайте файл мода соответствующей версии
2. Поместите мод в папку mods
3. Запустите сервер — файл конфигурации создастся автоматически
4. Отредактируйте конфигурацию, указав необходимые данные
5. Перезапустите сервер

Пользователи Bukkit/Spigot

1. Скачайте плагин Bukkit
2. Поместите плагин в папку plugins
3. Запустите сервер — файл конфигурации создастся автоматически
4. Отредактируйте plugins/SimpleComforKOOKConfig/config.yml
5. Перезапустите сервер

⚙️ Конфигурация

Пример конфигурации:

voiceAPIHOST: 127.0.0.1:3003          # Адрес сервера SimpleCom
token: 123456                          # Токен аутентификации SimpleCom
KOOKBOTtoken: your_kook_bot_token     # Токен KOOK-бота
channel_id: your_channel_id            # ID голосового канала KOOK

Как получить ID канала KOOK

1. Нажмите правой кнопкой мыши на голосовой канал в KOOK
2. Выберите «Скопировать ID канала»
3. Вставьте его в файл конфигурации

🎮 Руководство для игроков

1. Установите клиент SimpleCom: скачайте и установите из официального репозитория
2. Подключитесь к серверу: используйте клиент SimpleCom для подключения к Minecraft-серверу
3. Начните говорить: удерживайте клавишу PTT (Push-to-Talk), и ваш голос автоматически передастся в KOOK

⚠️ Важные замечания

• Односторонняя связь: сейчас поддерживается только передача голоса из Minecraft → KOOK, голос из канала KOOK обратно в Minecraft не передаётся
• Требования к сети: для качества голоса нужно стабильное соединение
• Влияние на производительность: обработка голоса потребляет часть ресурсов сервера, рекомендуется использовать на хорошо настроенных серверах

🔧 Технические детали

• Формат звука: 48 кГц, моно, кадры по 20 мс
• Кодек: Opus
• Протокол передачи: RTP over UDP
• Алгоритм микширования: микширование PCM в реальном времени, поддерживается одновременная речь нескольких игроков

📦 Поддерживаемые версии

Fabric

• Minecraft 1.20.1
• Fabric Loader 0.14.x+

Forge

• Minecraft 1.20.1
• Forge 47.x.x+

Bukkit/Spigot

• Minecraft 1.16.5+
• Paper/Spigot

🐛 Сообщения об ошибках

Пожалуйста, оставляйте отзывы в GitHub Issues.

📄 Лицензия

Проект распространяется под лицензией GNU General Public License v3.0.

🔗 Полезные ссылки

• Репозиторий GitHub: https://github.com/xiaofanforfabric/SimpleComforKOOK
• Клиент SimpleCom: https://github.com/xiaofanforfabric/SimpleCom-core
• Платформа разработчиков KOOK: https://developer.kookapp.cn/

Автор: xiaofan
Поддержка: если этот мод вам помог, поставьте Star ⭐