Плагин TwitchWhitelist: свяжите Twitch и Minecraft-сервер
Стриминг на Twitch давно перестал быть просто хобби — для многих это полноценная работа и способ строить сообщества. А что если превратить зрителей в активных участников вашего Minecraft-сервера? Плагин TwitchWhitelist делает именно это: он автоматически добавляет подписчиков или зрителей с определёнными баллами канала в белый список сервера. Больше не нужно вручную прописывать ники в консоли — интеграция работает напрямую через Twitch API.
Как работает TwitchWhitelist
Плагин связывает ваш Bukkit-сервер (версия 1.15 и выше) с аккаунтом Twitch Affiliate. Зрители получают доступ к серверу, используя баллы канала (Channel Points). Вы настраиваете награду в панели Twitch, а плагин отслеживает её активацию и автоматически вносит пользователя в whitelist на заданное время. Никаких сторонних ботов или сложных скриптов — всё работает внутри экосистемы Twitch.
Основные возможности
- Автоматическая выдача доступа к серверу через баллы канала.
- Гибкая настройка длительности: от секунд до дней (10, 5M, 10H, 30D).
- Поддержка любых Bukkit-серверов Minecraft 1.15 и новее.
- Простая установка через конфигурационные файлы.
- Безопасная работа с Twitch API без хранения паролей.
Требования к серверу и стримеру
Для запуска плагина вам понадобится сервер Minecraft под управлением Bukkit или его форков (Spigot, Paper) версии 1.15 или выше. Также необходим статус Twitch Affiliate, поскольку только партнёры и филиалы могут использовать баллы канала. Если вы только начинаете стримить, сначала добейтесь получения статуса Affiliate — это откроет доступ к монетизации и расширенным функциям.
Пошаговая настройка TwitchWhitelist
Процесс установки состоит из нескольких этапов. Важно выполнять их последовательно, чтобы избежать ошибок авторизации. Ниже — подробная инструкция.
1. Регистрация приложения в Twitch Dev Console
Перейдите в Twitch Dev Console и создайте новое приложение. В качестве категории можно указать «Game Integration». После создания вы получите Client ID и Client Secret — сохраните их, они понадобятся для конфигурации плагина.
2. Установка VirtualTwitchServer
Скачайте VirtualTwitchServer и запустите его. Это промежуточное звено, которое обрабатывает OAuth-авторизацию. Вы можете запустить его в графическом режиме или через командную строку, передав аргумент -cli. В настройках укажите порт, который будет использоваться для редиректа.
3. Настройка OAuth Redirect URL
Вернитесь в Twitch Dev Console и задайте Redirect URL в формате http://localhost:{PORT}/, где {PORT} — порт, выбранный на предыдущем шаге. Это критически важно для корректной авторизации.
4. Получение токена и заполнение конфигурации
Нажмите кнопку «Login with Twitch» в VirtualTwitchServer, скопируйте сгенерированный токен. Затем откройте конфигурационный файл плагина (config.yml) и вставьте туда Client ID, Client Secret, полученный токен, а также укажите имя вашего Twitch-канала в поле broadcaster_name. Не изменяйте вручную поля app_access_token, user_access_token, reward_id и broadcaster_id, если точно не понимаете их назначение — плагин сам заполнит их после первой успешной авторизации.
5. Настройка времени доступа
В конфигурации задаётся длительность пребывания игрока в вайтлисте после активации награды. Формат гибкий: число без букв — секунды, с буквой M — минуты, H — часы, D — дни. Например, 10 означает 10 секунд, 5M — 5 минут, 10H — 10 часов, 30D — 30 дней. Выберите значение, которое подходит под вашу модель взаимодействия со зрителями.
6. Финальная настройка наград в Twitch
После запуска сервера с плагином перейдите в панель управления Twitch и настройте созданную ботом награду: измените стоимость в баллах, описание, иконку. Саму награду плагин создаст автоматически, вам останется только подкорректировать её внешний вид и цену для зрителей.
Установка плагина через лаунчер FoxyGame
Если вы управляете сервером через удобный лаунчер, например FoxyGame, процесс становится ещё проще. Этот современный и гибкий лаунчер для Minecraft позволяет не только быстро устанавливать клиентские моды, но и централизованно управлять плагинами сервера прямо из меню. Вам не придётся вручную копировать jar-файлы в папку plugins — достаточно выбрать TwitchWhitelist в каталоге дополнений, и лаунчер сам разместит его в нужной директории. Такой подход экономит время и снижает риск ошибок при настройке серверной части.
Практические советы по использованию
Плагин идеально подходит для стримеров, которые хотят вознаграждать активных зрителей доступом к приватному серверу. Вы можете настроить награду так, чтобы зритель получал временный доступ, и после истечения срока его ник автоматически удалялся из whitelist. Это стимулирует зрителей копить баллы и регулярно возвращаться на стрим. Также можно комбинировать с другими плагинами, например, выдавать роль в Discord одновременно с доступом на сервер.
Возможные проблемы и их решение
- Ошибка авторизации: проверьте, совпадает ли Redirect URL в Twitch Dev Console с портом, указанным в VirtualTwitchServer.
- Плагин не добавляет в whitelist: убедитесь, что в конфиге правильно указан broadcaster_name (регистр важен) и что награда активирована зрителем через баллы канала.
- Сервер не запускается: проверьте совместимость версий Bukkit и плагина. TwitchWhitelist требует 1.15 или новее.
Заключение
TwitchWhitelist — это мощный инструмент для стримеров, желающих превратить пассивных зрителей в активных участников игрового процесса. Автоматическая синхронизация белого списка с баллами канала Twitch не только упрощает администрирование, но и создаёт дополнительную мотивацию для аудитории. Благодаря простой настройке и гибким временным рамкам, плагин легко адаптируется под любой формат стримов. А с помощью таких решений, как лаунчер FoxyGame, установка и управление плагинами становятся ещё доступнее, позволяя сосредоточиться на творчестве и общении с сообществом, а не на технических деталях. Интеграция Twitch и Minecraft открывает новые горизонты для взаимодействия — попробуйте и убедитесь сами.