DiscordSRVOAuth - привязка Discord-аккаунта через OAuth2

DiscordSRVOAuth - плагин для Minecraft-серверов, который решает одну из самых раздражающих задач админа: привязку игрового аккаунта к Discord-профилю игрока. Вместо костылей с кодами в чате и ручной проверкой ника игрок просто проходит авторизацию через официальный Discord OAuth2, и сервер получает подтверждённую связку аккаунтов.

Плагин работает как дополнение к DiscordSRV, так что сначала должен стоять именно он. Сам по себе DiscordSRV связывает чат сервера с Discord-каналом, но OAuth-привязка добавляет нормальный слой верификации: вы точно знаете, что конкретный игрок владеет конкретным Discord-аккаунтом. Это пригодится для выдачи ролей, приватных каналов, вайтлиста по Discord и всяких интеграций вроде бонусов за привязку.

Как установить DiscordSRVOAuth

1. Скачайте плагин DiscordSRVOAuth.
2. Закиньте jar в папку plugins вашего сервера Майнкрафт (перед этим убедитесь, что установлен DiscordSRV, иначе работать не будет).
3. Проверьте, что нужный порт открыт и не занят другим сервисом - OAuth-коллбэк будет идти именно через него.
4. Убедитесь, что URL в конфиге валидный и совпадает с тем, что указан в настройках Discord-приложения.

Нюанс, который часто упускают: если сервер стоит за роутером или панелью хостинга, порт надо не просто открыть, а пробросить. Иначе Discord не сможет достучаться до вашего коллбэка и привязка будет валиться с ошибкой.

Настройка на стороне Discord

Вся магия делается в настройках Discord-приложения, в разделе OAuth2.

Какие значения нужны

Скопируйте Client ID и Client Secret из приложения и вставьте их в конфиг плагина. Дальше настройте Redirects (редиректы) - адрес должен точь-в-точь совпадать с тем, что прописан в конфиге. Один лишний слэш или http вместо https, и авторизация не пройдёт. Это самая частая причина проблем, проверено на практике.

Настройка HTTPS

Для работы OAuth2 Discord требует защищённое соединение, поэтому без HTTPS никуда. Подробности по настройке сертификата смотрите в README проекта - там разобраны варианты с проксированием и выпуском сертификатов.

Совет из практики: если у вас нет опыта с SSL, проще всего поднять обратный прокси через Nginx или Caddy и получить бесплатный сертификат через Let's Encrypt. Caddy вообще делает это автоматически по одной строчке в конфиге.

Кому нужен этот плагин

Если вы держите сервер с Discord-сообществом и хотите автоматизировать выдачу ролей, синхронизировать привилегии или просто избавиться от самозванцев - это must-have дополнение к DiscordSRV. Особенно актуально для приватных серверов с вайтлистом: привязка через OAuth2 надёжнее любых кодов из чата, потому что подделать её нельзя.

И да, если планируете играть с друзьями на своём сервере, учтите: плагин спокойно заработает на BungeeHost (https://bungee.host), а установить его туда можно буквально в один клик через панель. Откроете порт, настроите OAuth - и всё завертится.

Скачать плагин DiscordSRVOAuth стоит каждому, кто уже использует DiscordSRV и хочет довести интеграцию с Discord до ума. Настройка займёт минут пятнадцать с учётом создания приложения в Discord Developer Portal, зато потом привязка аккаунтов происходит без участия админа вообще.