🎮 Команды и права BaronessAuth

Плагин BaronessAuth предоставляет набор команд для управления аутентификацией игроков. Команды разделены на административные и пользовательские.

👑 Административные команды

🔧 /baronessauth (или /auth)

Право: BaronessAuth.command.baronessauth

Основная административная команда для управления плагином. Предназначена для администраторов сервера.

📋 Подкоманды:

🔄 /auth reload

Право: BaronessAuth.command.baronessauth.reload

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

/auth reload

⚠️ Важно: Некоторые глобальные настройки (например, база данных) можно сменить только через полную перезагрузку сервера.

👤 /auth player [игрок] info

Право: BaronessAuth.command.baronessauth.player.info

Выводит подробную информацию об игроке:

/auth player <игрок> info

📊 Отображаемая информация:

• 👤 Ник игрока
• 📅 Дата регистрации (IP, город, страна)
• 🕐 Последний вход (IP, город, страна)
• 🆔 UUID
• 🎫 Лицензия (да/нет)
• 🔗 Привязки: VK, Telegram, Discord

🔑 /auth player [игрок] setpassword [пароль]

Право: BaronessAuth.command.baronessauth.player.setpassword

Устанавливает игроку пароль, обходя все ограничения по сложности.

/auth player <игрок> setpassword <пароль>

🗑️ /auth player [игрок] delete

Право: BaronessAuth.command.baronessauth.player.delete

Удаляет все данные о регистрации игрока.

/auth player <игрок> delete

⚠️ Внимание: Игрок будет отключен с сообщением о необходимости перезайти.

💾 Команды резервного копирования

📋 /auth backup info [файл]

Право: BaronessAuth.command.baronessauth.backup.info

Отображает информацию о бекапе:

/auth backup info <файл>

📊 Информация:

• 🔢 Версия бекапа
• 📅 Дата создания
• 📏 Размер файла
• 👥 Количество профилей

➕ /auth backup create

Право: BaronessAuth.command.baronessauth.backup.create

Создает резервную копию данных плагина.

/auth backup create

⏱️ Примечание: Процесс не мгновенный, отображается прогресс создания.

📥 /auth backup load [файл] (--force)

Право: BaronessAuth.command.baronessauth.backup.load

Загружает резервную копию.

/auth backup load <файл>
/auth backup load <файл> --force

🚩 Флаги:

• --force - перезаписывает конфликты (данные в бекапе приоритетнее)

⏱️ Примечание: Процесс не мгновенный, отображается прогресс загрузки.

🔗 Команды привязки аккаунтов

🔗 /link [сервис]

Право: Не требуется (доступно всем игрокам)

Позволяет привязать аккаунт к внешним сервисам.

/link vk
/link telegram
/link discord

🌐 Доступные сервисы:

• 📘 VK (ВКонтакте)
• 📱 Telegram
• 💬 Discord

ℹ️ Примечание: Команда автоматически исчезает, если не включены никакие сервисы.

⚡ Ярлыки:

• /vk → /link vk
• /vkontakte → /link vk
• /tg → /link telegram
• /telegram → /link telegram
• /discord → /link discord

🔐 Пользовательские команды

🚪 /logout

Право: Не требуется (доступно всем игрокам)

Сбрасывает сессию игрока, отключая автоматический вход при следующем подключении.

/logout

⏱️ Кулдаун: 10 секунд

🔄 /changepassword [старый пароль] [новый пароль]

Право: Не требуется (доступно всем игрокам)

Позволяет игроку сменить собственный пароль.

/changepassword <старый пароль> <новый пароль>

⏱️ Кулдаун: 4 секунды

🗑️ /unregister [текущий пароль]

Право: BaronessAuth.command.unregister

Позволяет игроку удалить свой аккаунт.

/unregister <текущий пароль>

⚠️ Внимание: Удаляет все данные BaronessAuth, но игровой прогресс остается. ⏱️ Кулдаун: 5 секунд

🛡️ Права доступа

👑 Административные права

👤 Пользовательские права

⚠️ Важные замечания

🔒 Безопасность

• 🚫 Команды /auth предназначены только для администраторов
• ⚠️ Удаление регистрации игрока необратимо
• 🔐 Бекапы содержат конфиденциальные данные

⚡ Производительность

• ⏱️ Создание и загрузка бекапов может занять время
• 🐌 При большом количестве игроков операции могут быть медленными

👨‍💻 Разработчик

В конфигурации есть секция unsafe-developer-commands: false - НЕ ВКЛЮЧАЙТЕ эти команды без прямых указаний разработчика!

🔧 Настройка сообщений

Все сообщения команд настраиваются в соответствующих .yml файлах:

• 📄 baronessauth.yml - основные команды
• 📄 _shared.yml - общие сообщения
• 📄 link.yml - команды привязки
• 📄 logout.yml - выход из системы
• 📄 changepassword.yml - смена пароля
• 📄 unregister.yml - удаление аккаунта

📝 Примеры использования

👑 Административные команды

# 🔄 Перезагрузка плагина
/auth reload

# 👤 Информация об игроке
/auth player Steve info

# 🔑 Установка пароля игроку
/auth player Alex setpassword newpassword123

# 💾 Создание бекапа
/auth backup create

# 📥 Загрузка бекапа
/auth backup load backup_2024-01-15.dat

👤 Пользовательские команды

# 🔗 Привязка к VK
/link vk

# 🔄 Смена пароля
/changepassword oldpass newpass

# 🚪 Выход из системы
/logout

# 🗑️ Удаление аккаунта
/unregister mypassword