Интеграция с AuthMeReloaded

AuthMe и AuthMeReloaded — это один и тот же плагин (часто эти названия используют как синонимы). AuthMeReloaded является продвинутым форком оригинального плагина AuthMe и является рекомендуемым решением для управления аутентификацией на серверах Minecraft.

Примечание: Эта интеграция доступна только для Spigot и его форков (Paper, Folia, Purpur и т. д.). Она недоступна для прокси-серверов, таких как Bungeecord или Velocity.

🎯 Что такое AuthMeReloaded?

AuthMeReloaded — это комплексный плагин аутентификации, который добавляет функционал входа и регистрации на серверах Minecraft. Это самое популярное и надежное решение для аутентификации в сообществе Minecraft.

При интеграции с Pano процесс аутентификации становится бесшовным: игроки могут регистрироваться, входить в систему и управлять своими паролями через ваш веб-сайт, пока плагин автоматически обрабатывает аутентификацию в игре.

⚡ Особенности

При включении интеграции с AuthMeReloaded Pano обеспечивает:

• ✅ Бесшовную аутентификацию — Процессы входа и регистрации контролируются Pano.
• ✅ Управление паролями — Изменение паролей прямо на веб-сайте.
• ✅ Контроль для администраторов — Администраторы могут сбрасывать пароли игроков из панели управления.
• ✅ Автоматическую синхронизацию — Данные игроков синхронизируются между игрой и вебом.
• ✅ Поддержку команд плагина — Выполнение специфических команд AuthMe из Pano.
• ✅ Автонастройку (Zero-Touch) — Pano автоматически корректирует настройки AuthMe, не требуя ручного вмешательства.

📦 Требования

Перед включением интеграции с AuthMeReloaded убедитесь, что у вас есть:

1. AuthMeReloaded, установленный на вашем сервере Minecraft (Spigot/Paper/Folia).
2. Pano MC Plugin, установленный и подключенный к вашему экземпляру Pano.
3. Версия AuthMeReloaded 5.6.0 или выше (всегда используйте последнюю версию).

⚠️ Важно: Pano поддерживает последнюю версию AuthMeReloaded. Убедитесь, что ваш плагин AuthMe обновлен. Последняя протестированная версия — v5.6.0.

🔧 Руководство по настройке

Шаг 1: Установка AuthMeReloaded

Скачайте и установите AuthMeReloaded на ваш сервер Minecraft:

• Скачать со SpigotMC
• Скачать с GitHub

Поместите файл AuthMe-<версия>.jar в папку plugins/ вашего сервера и перезапустите его.

Шаг 2: Подключение сервера Minecraft к Pano

Если вы еще этого не сделали, установите Pano MC Plugin на сервер и подключите его к Pano:

1. Установите Pano MC Plugin на сервер Minecraft.
2. В панели управления перейдите в раздел Серверы → нажмите кнопку +.
3. Следуйте шагам подключения в окне.

Подробные инструкции см. в Руководстве по установке.

В данной документации предполагается, что Pano MC Plugin уже установлен и подключен.

Шаг 3: Проверка активации интеграции в панели

1. Войдите в панель администратора Pano.
2. Перейдите в раздел Панель → Настройки сервера → Интеграция с игрой.
3. Найдите раздел Auth Integration. Здесь вы можете настроить:
   • Auth Integration (включено по умолчанию): Главный переключатель интеграции.
   • Require Verified (включено по умолчанию): Если включено, игроки должны иметь подтвержденный адрес электронной почты для входа на сервер.
   • Kick After Register (включено по умолчанию): Если включено, игроки будут автоматически кикнуты с сервера сразу после успешной регистрации в игре. Это используется для того, чтобы игроки подтвердили свою почту перед началом игры.
4. Проверьте настройки и нажмите Save.

💡 Примечание: Интеграция аутентификации и её поднастройки включены по умолчанию. При обнаружении AuthMeReloaded на сервере Pano автоматически подключится к нему и применит эти правила.

Вот и всё! Pano MC Plugin автоматически обнаружит AuthMeReloaded и начнет управлять процессами аутентификации.

🔄 Что происходит после включения?

После активации интеграции Pano выполнит следующие действия:

1. Обнаружение и подключение к плагину AuthMe

Pano MC Plugin автоматически определяет, установлен ли AuthMeReloaded. После обнаружения он регистрирует слушателей команд и событий AuthMe, обеспечивая связь между Pano и AuthMe.

2. Изменение конфигурации AuthMe (Zero-Touch)

Pano использует подход с нулевой настройкой (zero-touch) — он автоматически корректирует определенные значения в конфигурации AuthMe для обеспечения совместимости. Перед внесением изменений Pano создает резервную копию вашего файла config.yml под именем authme-backup.yml в папке плагина Pano (plugins/Pano/).

Будут изменены следующие настройки:

Настройка	Новое значение	Причина
settings.security.passwordHash	CUSTOM	Требуется для интеграции проверки паролей Pano
settings.registration.type	PASSWORD	Pano поддерживает только аутентификацию по паролю (функции почты обрабатываются веб-сайтом)
settings.security.minPasswordLength	6	Обеспечивает минимальный стандарт безопасности аккаунта
settings.security.passwordMaxLength	128	Стандартизированная максимальная длина для совместимости на всей платформе
settings.restrictions.allowedNicknameCharacters	[a-zA-Z0-9_]*	Ограничивает никнеймы буквами, цифрами и подчеркиванием для совместимости

⚠️ Не изменяйте эти настройки вручную. Они необходимы для полной интеграции и совместимости. Их изменение может нарушить работу системы или вызвать конфликты с другими плагинами.

3. Управление аутентификацией

Когда интеграция активна, Pano берет на себя управление следующими процессами:

• Регистрация игроков — новые игроки регистрируются через ваш веб-сайт.
• Вход игроков — аутентификация обрабатывается Pano и синхронизируется с AuthMe.
• Смена пароля — игроки могут менять пароли прямо на сайте.
• Восстановление пароля — забытые пароли можно сбросить через почту (если настроен SMTP).
• Управление паролями администратором — администраторы могут сбросить пароль любого игрока через панель.

✅ Поддерживаемые функции

Pano поддерживает следующие команды и функции AuthMe:

• ✅ /register <пароль> <подтверждение> — Регистрация нового аккаунта.
• ✅ /login <пароль> — Вход в аккаунт.
• ✅ /logout — Выход из аккаунта.
• ✅ /changepassword <старыйПароль> <новыйПароль> — Смена пароля.
• ✅ /authme forceLogin <игрок> — Принудительный вход игрока (админ).
• ✅ /authme register <игрок> <пароль> — Регистрация игрока (админ).
• ✅ /authme reload — Перезагрузка конфигурации AuthMe.
• ✅ /authme changepassword <игрок> <новыйПароль> — Смена пароля игрока (админ).

Pano слушает эти команды и синхронизирует действия с базой данных вашего сайта.

❌ Неподдерживаемые функции

Из-за ограничений интеграции следующие команды и функции AuthMe не поддерживаются:

• ❌ /unregister — Удаление регистрации должно выполняться через панель или сайт Pano.
• ❌ /authme unregister <игрок> — Аналогично вышеуказанному.
• ❌ /email — Управление электронной почтой осуществляется через Pano.
• ❌ /totp — Двухфакторная аутентификация не поддерживается.

Если игрок попытается использовать неподдерживаемую команду, он получит уведомление о необходимости использовать веб-сайт.

💡 Рекомендация: Чтобы избежать путаницы, рекомендуется отключить доступ к неподдерживаемым командам с помощью плагина прав доступа или конфигурации команд самого AuthMe. Таким образом, игроки будут иметь доступ только к функциям, совместимым с Pano.

🎯 Лучшая практика: Перенаправление игроков на сайт

Для улучшения пользовательского опыта и повышения безопасности рассмотрите возможность полного отключения регистрации в игре:

Как реализовать:

1. Отключите команду /register через права доступа или настройки AuthMe.
2. Настройте AuthMe так, чтобы заходить могли только уже зарегистрированные игроки.
3. Настройте сообщение на сервере, которое направляет новых игроков на сайт для регистрации.

Почему это лучше:

• ✅ Повышенная безопасность — Веб-регистрация позволяет использовать подтверждение по почте, CAPTCHA и другие меры.
• ✅ Лучший UX — Игроки используют удобные формы с индикаторами сложности пароля и четкими инструкциями.
• ✅ Централизованное управление — Все регистрации проходят через сайт, что упрощает модерацию.
• ✅ Профессиональный вид — Придает вашему серверу современный и законченный вид.

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

settings:
  registration:
    enabled: false  # Отключить регистрацию в игре
  
restrictions:
  allowCommands:
    - /login
    # /register удален из списка разрешенных команд

Затем настройте сообщение при входе: "Пожалуйста, зарегистрируйтесь на нашем сайте: https://yourserver.com/register"

🌐 Сравнение с другими веб-скриптами

В отличие от традиционных веб-скриптов, требующих сложной настройки и ручной синхронизации, интеграция Pano с AuthMeReloaded работает бесшовно:

Особенность	Традиционные скрипты	Pano
Сложность настройки	Высокая — требует настройки БД и PHP-скриптов вручную	Низкая — достаточно поставить галочку
Синхронизация	Ручная или через CRON	В реальном времени через WebSocket
Хеширование паролей	Часто несовместимое или небезопасное	Нативная поддержка CUSTOM хеширования
Поддержка команд	Ограничена или отсутствует	Полная поддержка команд и событий
Автонастройка	Ручная	Автоматическая с резервным копированием

С Pano всё просто работает. Никакого ручного редактирования базы данных или сложной конфигурации.

🔒 Безопасность и совместимость

Безопасность паролей

Pano использует тип хеширования AuthMe CUSTOM, что позволяет безопасно проверять пароли без хранения их в открытом виде или использования слабых алгоритмов.

Система резервного копирования

Перед изменением конфигурации AuthMe Pano автоматически создает резервную копию вашего файла config.yml. Бэкапы находятся здесь: plugins/Pano/authme-backup.yml

Конфликты плагинов

Некоторые аддоны для AuthMe могут конфликтовать с интеграцией Pano, особенно если они изменяют те же значения конфигурации или методы хеширования.

🐛 Устранение неполадок

Интеграция не работает

• Убедитесь, что AuthMeReloaded запущен (/plugins).
• Проверьте, подключен ли Pano MC Plugin к Pano (раздел Серверы в панели).
• Убедитесь, что интеграция включена в настройках сервера в панели Pano.
• Перезапустите сервер после включения интеграции.

Настройки постоянно сбрасываются

• Не меняйте passwordHash и registration.type в конфиге AuthMe вручную — Pano управляет ими автоматически.

Команды не реагируют

• Проверьте, включена ли интеграция.
• Убедитесь, что вы используете точный синтаксис команд, а не алиасы.
• Проверьте, не перехватывают ли команды другие плагины.

💬 Сообщение об ошибках

Если вы обнаружили ошибки или проблемы с совместимостью:

• GitHub: PanoMC/pano-mc-plugin
• Discord: Присоединяйтесь к нам

Вместе мы делаем Pano лучше. 🚀