Wawel Auth — гибкая аутентификация и современные скины для Minecraft

Wawel Auth — гибкая аутентификация и современные скины для Minecraft 1.7.10

Многие сборки на версии 1.7.10 до сих пор живут на серверах и в лаунчерах, но стандартная система авторизации Minecraft уже давно ушла вперёд. Wawel Auth решает эту проблему радикально: мод позволяет клиенту и серверу работать с любыми Yggdrasil-совместимыми провайдерами, включая Microsoft, Ely.by, LittleSkin и даже собственный сервер аутентификации, поднятый прямо на игровом хосте. При этом серверная часть не требует обязательной установки мода на клиенте — владельцы серверов могут настроить приём игроков с разных аккаунт-систем без лишних действий со стороны пользователей.

Что умеет Wawel Auth на клиенте

Мод добавляет в экран мультиплеера кнопку «Auth», через которую открывается удобное меню управления учётными записями. Вы можете добавить Microsoft, Ely.by, LittleSkin или любой другой Yggdrasil-совместимый сервер по URL. Локальные учётные записи создаются через кнопку «Manage Local Auth...» — это самый быстрый способ подключиться к серверу, на котором работает серверная часть Wawel Auth. Клиент хранит настройки в двух местах: локальный конфиг config/wawelauth/local.json привязан к конкретному инстансу Minecraft, а общие данные (аккаунты, провайдеры) лежат в системной папке %APPDATA%/wawelauth/ на Windows, ~/Library/Application Support/wawelauth/ на macOS или $XDG_DATA_HOME/wawelauth/ на Linux. Это позволяет переносить учётные записи между разными сборками без повторной настройки.

Кроме гибкой аутентификации, клиентская часть мода даёт современные скины с поддержкой HD-текстур, анимированные плащи для аккаунтов Wawel Auth и опциональные 3D-слои кожи. Загрузка скинов и плащей работает даже на серверах, где Wawel Auth не установлен — достаточно иметь мод на клиенте. Для удобства можно перетаскивать файлы скинов прямо в окно игры (требуется Java 17+).

Серверная часть: свой провайдер и админ-панель

На сервере Wawel Auth разворачивает полноценный Yggdrasil-совместимый провайдер. База данных SQLite, ключи шифрования и текстуры хранятся в папке config/wawelauth/. Главное правило безопасности: никогда не передавайте приватный ключ сервера третьим лицам. При смене ключа клиенты Wawel Auth должны заново подтвердить доверие, а пользователи authlib-injector вообще не смогут подключиться.

Минимальная настройка для локального сервера выглядит так:

• В файле config/wawelauth/server.json включите wawelAuthEnabled: true, задайте serverName, publicBaseUrl (реальный адрес, который видят клиенты) и apiRoot (относительный путь, обычно «auth»).
• Включите админ-панель: admin.enabled: true и задайте токен через server.admin.token или переменную окружения WAWELAUTH_ADMIN_TOKEN.
• В server.properties установите online-mode=true.
• Перезапустите сервер. Если publicBaseUrl не указан, Wawel Auth остановит загрузку мира — это защита от небезопасных конфигураций.

После запуска административная веб-панель доступна по адресу https://ваш-хост:порт/admin (при включённом HTTPS на том же порту). Там можно управлять пользователями, текстурами, инвайтами, вайтлистом, операторами, а также редактировать server.json и server.properties. HTTPS использует самоподписанный сертификат — при первом входе сверьте SHA-256 отпечаток из лога сервера.

Регистрация и инвайты

Политика регистрации задаётся параметром registration.policy: OPEN (свободная), INVITE_ONLY (только по приглашениям) или CLOSED. Для инвайтов есть команды:

• /wawelauth invite create [uses|unlimited] — создать код с ограничением использований или без.
• /wawelauth invite list — показать активные инвайты.
• /wawelauth invite delete <code> — удалить инвайт.
• /wawelauth invite purge — очистить все инвайты.

Игроки регистрируются командой /wawelauth register <username> <password> прямо на сервере.

Резервные провайдеры и совместимость

Сервер может принимать игроков не только из собственной базы, но и из внешних систем. Резервные провайдеры настраиваются в fallback-servers.json и проверяются по порядку. Примеры для Microsoft, Ely.by и LittleSkin уже встроены. Важно: имя провайдера (name) не должно содержать пробелов, так как используется в командах вида /op player@provider. Обычные команды /whitelist и /op отключаются — вместо них работают варианты с указанием провайдера: /whitelist add username@mojang, /op username@ely.by и т.д. Локальные аккаунты обозначаются алиасами local, localauth, wawelauth или self.

Если вы используете лаунчер foxygame.net, установка Wawel Auth становится ещё проще — этот современный и гибкий лаунчер позволяет скачать мод прямо из меню, а затем сразу подключиться к серверу с поддержкой смешанной аутентификации. Благодаря удобному управлению сборками вы можете быстро переключаться между клиентами с разными наборами модов.

Тонкая настройка и ограничения

Через client.json можно скрыть кнопки управления скинами для отдельных провайдеров с помощью regex-фильтров disableSkinUpload, disableCapeUpload, disableTextureReset. Это чисто косметическая опция, если провайдер не поддерживает загрузку текстур. Анимированные плащи работают только на серверах Wawel Auth и используют формат minecraftcapes.net.

Серверная часть также позволяет гибко управлять текстурами: максимальные размеры скинов и плащей, лимиты файлов, настройки HTTP (флаг HTTPS на том же порту, таймауты чтения и TLS-рукопожатия, максимальный размер тела запроса). Для CI-тестов предусмотрены переменные WAWELAUTH_CI=true или GITHUB_ACTIONS=true, которые отключают обязательную проверку publicBaseUrl.

Зависимости и сборка

Для работы мода необходимы UniMixins, FentLib и ModularUI2 (только на клиенте). Каждый релиз включает nodep-сборку, которая не содержит sqlite-jdbc и Bouncy Castle, полагаясь на FalsePatternLib. Сборка из исходников выполняется стандартной командой ./gradlew build.

Итог: зачем нужен Wawel Auth

Wawel Auth стирает границы между разными системами аккаунтов в Minecraft 1.7.10. Вы можете объединить на одном сервере игроков с Microsoft, Ely.by, LittleSkin и локальными учётными записями, не требуя от них установки дополнительных модов. Клиентская часть при этом даёт современные скины, анимированные плащи и 3D-слои даже на ванильных серверах. Администраторы получают удобную веб-панель и гибкую систему инвайтов. Если вы поддерживаете старые сборки или строите сервер с нестандартной аутентификацией, этот мод станет центральным элементом вашей инфраструктуры.

--- **Обновление 19.09.2026:** Добавлено 2 файла для версии 1.7.10 (Forge).