locale: en  # en or ru

required-permissions:
  - "group.admin"
  - "group.moderator"
  - "authcodes.force"

bots:
  telegram:
    enabled: false
    token: "YOUR_TOKEN"
  discord:
    enabled: false
    token: "YOUR_TOKEN"

database:
  type: "h2"  # h2 or mysql
  h2:
    file: "database.mv.db"
  mysql:
    host: "localhost"
    port: 3306
    database: "authcodes"
    username: "root"
    password: ""

proxy:
  enabled: false
  type: "SOCKS5"
  host: "127.0.0.1"
  port: 1080

🔐 AuthCodes

Защитите аккаунты администрации двухфакторной аутентификацией! AuthCodes добавляет 2FA через Telegram и Discord ботов, гарантируя, что только проверенные админы получат доступ к защищённым аккаунтам.

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

• 🤖 Telegram и Discord боты — Отправка кодов 2FA через любимый мессенджер
• 🔗 Привязка аккаунтов — Разовая привязка с проверкой 6-значного кода
• 🔑 Двухфакторный вход — 8-значный код при каждом входе для защищённых игроков
• 🛡️ Полные ограничения — Блокировка всех действий во время аутентификации (блоки, инвентарь, чат, урон)
• 👀 Режим Бога — Игроки неуязвимы во время 2FA
• 🚫 Белый список команд — Только команды аутентификации во время 2FA
• 🌍 Интеграция LuckPerms — Защита определённых групп прав
• 🗄️ H2 + MySQL — Быстрая локальная файловая БД или удалённый MySQL
• 🔄 Поддержка прокси — SOCKS4/5, HTTP/HTTPS прокси для API ботов
• 🎨 Кастомизация — Все сообщения настраиваются (EN/RU)
• ⚙️ Горячая перезагрузка — Перезагрузка конфига без перезапуска сервера
• 🌐 Локализация — Английский и русский языки из коробки
• 🛡️ Безопасность PlugMan — Корректная обработка ошибок при выгрузке плагина

📋 Требования

🔐 Права

🎮 Команды

Команды игроков

Команды админов

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

# Игрок привязывает свой Telegram аккаунт
/authcodes link telegram
# → Получает 6-значный код в чате
# → Вводит код в Telegram боте

# Игрок заходит на сервер и получает код 2FA
# → Код отправлен в Telegram/Discord
# → Вводит в чат:
/code 58291743

# Игрок отвязывает свой аккаунт
/authcodes unlink

# Админ принудительно отправляет новый код 2FA
/authcodes forcecode Notch
# → Notch получает новый 8-значный код

# Админ отвязывает игрока
/authcodes forceunlink Notch

# Админ перезагружает конфиг
/authcodes reload

⚙️ Конфигурация

locale: en  # en или ru

required-permissions:
  - "group.admin"
  - "group.moderator"
  - "authcodes.force"

bots:
  telegram:
    enabled: false
    token: "ВАШ_ТОКЕН"
  discord:
    enabled: false
    token: "ВАШ_ТОКЕН"

database:
  type: "h2"  # h2 или mysql
  h2:
    file: "database.mv.db"
  mysql:
    host: "localhost"
    port: 3306
    database: "authcodes"
    username: "root"
    password: ""

proxy:
  enabled: false
  type: "SOCKS5"
  host: "127.0.0.1"
  port: 1080

🔄 Как это работает

Первый вход (Привязка)

1. Игрок заходит на сервер с нужным правом
2. Плагин предлагает: /authcodes link telegram или discord
3. Игрок вводит команду → получает 6-значный код в чате
4. Игрок вводит код в Telegram/Discord бот
5. Аккаунт привязан! (1 попытка, 5 минут на ввод)

Последующие входы (2FA)

1. Игрок заходит на сервер с привязанным аккаунтом
2. Плагин отправляет 8-значный код в Telegram/Discord
3. Игрок вводит /code <цифры> в чат
4. Ограничения сняты! (3 попытки, 60 секунд на ввод)

🛡️ Безопасность

• Корректное завершение — Все ресурсы закрываются при остановке сервера
• Совместимость с PlugMan — Обработка NoClassDefFoundError и других ошибок при выгрузке
• Асинхронность — Все операции с ботами выполняются асинхронно, без лагов
• Управление потоками — Polling-потоки корректно прерываются при завершении