MineAuth - REST API и OAuth 2.0 для сервера Майнкрафт

MineAuth - это плагин для серверов Paper и Purpur, который решает задачу, о которой рано или поздно задумывается каждый владелец крупного проекта: как вытащить данные из Minecraft наружу, на сайт, в личный кабинет игрока или в Discord-бота. Плагин поднимает прямо на сервере REST API и работает как полноценный сервер авторизации с поддержкой OAuth 2.0 и OpenID Connect. Проще говоря, игрок заходит на ваш сайт, жмёт "Войти через Minecraft-аккаунт сервера", подтверждает вход - и сайт получает безопасный доступ к его игровым данным. Скачать MineAuth стоит тем, кто строит вокруг сервера экосистему: веб-магазин, форум, лаунчер или панель управления.

Зачем это вообще нужно

В ванильном Майнкрафт нет никакого способа связать игровой аккаунт с внешним сервисом. Хочешь показать игроку его баланс на сайте? Придумывай костыли. Хочешь сделать перевод денег через Discord-бота? Ещё костыльнее. MineAuth закрывает эту дыру: он выступает посредником между игрой и вебом, причём делает это по-взрослому, через стандарт OAuth 2.0 - тот самый протокол, по которому работают кнопки "Войти через Google" на обычных сайтах.

Главная фишка в том, что игрок сам контролирует доступ. Он видит страницу авторизации, понимает, какие данные запрашивает приложение, и подтверждает вход. Никаких паролей от сервера на сторонних сайтах, никаких кривых самописных токенов.

Что умеет плагин

• OAuth 2.0 и OIDC сервер - полноценная авторизация с выдачей токенов, в свежих версиях добавили name-клейм в OIDC и ужесточили безопасность OAuth-флоу.
• REST API с OpenAPI-документацией - плагин отдаёт спецификацию в формате yaml, так что сгенерировать клиент под свой сайт или бота - дело пары минут.
• Интеграция с Vault - игроки могут проверять баланс и переводить деньги друг другу через API. Это база для веб-экономики сервера.
• Интеграция с QuickShop-Hikari - данные магазинов игроков тоже доступны через API, что открывает дорогу к веб-витрине сервера.
• Аддоны под популярные плагины - есть интеграции с LuckPerms, BetonQuest, GriefPrevention, PureTickets и VotingPlugin. В свежих релизах появился endpoint /quests/me для квестов и сервисная авторизация для машинных запросов.
• Телеметрия OpenTelemetry - в версии 0.2.30 добавили улучшенный мониторинг, полезно для больших сетей, где нужно следить за нагрузкой на API.

Совместимость и версии

Актуальная ветка MineAuth поддерживает Minecraft Java 1.21.8 - 1.21.11, встречаются сборки линейки 26.1.x и 26.2. Плагин ставится на Paper или Purpur, для работы экономики нужен Vault и любой экономический плагин на его основе. Проект живой: последнее обновление вышло буквально несколько дней назад, разработчики активно добавляют фичи и закрывают дыры в безопасности.

Важный нюанс

Это не плагин "поставил и забыл" в духе косметических добавок. MineAuth - инструмент для админов, которые реально пишут или заказывают веб-часть своего проекта. Если у вас нет сайта, бота или панели, которым нужны данные из игры, плагин вам ничего не даст. А вот если вы давно мечтали сделать личный кабинет игрока с балансом, квестами и статистикой - это, пожалуй, самое прямое решение на рынке. Для серверов, где экономика построена на Vault и магазинах QuickShop, MineAuth вообще must-have: связка "игровой магазин + веб-витрина" работает из коробки.

Ещё момент: раз API крутится на самом сервере, следите за тем, чтобы порт был корректно открыт и прикрыт HTTPS-прокси, если выносите авторизацию в интернет. Токены OAuth - штука чувствительная, относиться к ним стоит как к паролям.

Скачать MineAuth можно под Paper/Purpur для Minecraft 1.21.8 и новее. Если строите сервер с веб-экосистемой - берите на заметку, альтернатив с таким же набором интеграций сейчас практически нет.