?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
AuthCodes

AuthCodes

Protect admin accounts with two-factor authentication! AuthCodes adds 2FA via Telegram and Discord bots, ensuring only verified admins can access protected accounts.

3downloads
1follower
3downloads
1follower

Compatibility

Minecraft: Java Edition

26.2
26.1
1.21
1.20
1.19
1.18
1.17
1.16.5

Platforms

Tags

Creators

Details

Licensed MIT
Published yesterday
Updated 3 weeks ago

🔐 AuthCodes

Protect admin accounts with two-factor authentication! AuthCodes adds 2FA via Telegram and Discord bots, ensuring only verified admins can access protected accounts.

✨ Features

  • 🤖 Telegram & Discord Bots — Send 2FA codes via your favorite messenger
  • 🔗 Account Linking — One-time linking with 6-digit code verification
  • 🔑 Two-Factor Login — 8-digit code required every login for protected players
  • 🛡️ Full Restrictions — Blocks all actions during authentication (blocks, inventory, chat, damage)
  • 👀 GodMode — Players are invincible during 2FA
  • 🚪 Command Whitelist — Only auth commands allowed during 2FA
  • 🌍 LuckPerms Integration — Protect specific permission groups
  • 🗄️ H2 + MySQL — Fast local file database or remote MySQL
  • 🔄 Proxy Support — SOCKS4/5, HTTP/HTTPS proxy for bot API calls
  • 🎨 Customization — All messages configurable (EN/RU)
  • ⚙️ Hot Reload — Reload config without server restart
  • 🌐 Localization — English and Russian out of the box
  • 🛡️ PlugMan Safe — Handles errors gracefully during plugin unload

📋 Requirements

Dependency Version
Server Paper/Spigot 1.16.5+
LuckPerms 5.x+
Java 11+

🔐 Permissions

Permission Description Default
authcodes.admin Access to admin commands (reload, forceunlink, forcecode) OP
group.admin Requires 2FA (configurable) -
group.moderator Requires 2FA (configurable) -
authcodes.force Requires 2FA (configurable) -

🎮 Commands

Player Commands

Command Description Example
/authcodes link telegram Start account linking via Telegram /authcodes link telegram
/authcodes link discord Start account linking via Discord /authcodes link discord
/code <8-digit> Enter 2FA code during login /code 58291743
/authcodes unlink Unlink your own account /authcodes unlink

Admin Commands

Command Description Example
/authcodes reload Reload plugin config /authcodes reload
/authcodes forceunlink <player> Force unlink a player's account /authcodes forceunlink Notch
/authcodes forcecode <player> Force send new 2FA code to a player /authcodes forcecode Notch

📝 Usage examples:

# Player links their Telegram account
/authcodes link telegram
# → Receives 6-digit code in chat
# → Enters code in Telegram bot

# Player logs in and receives 2FA code
# → Code sent to Telegram/Discord
# → Enter in chat:
/code 58291743

# Player unlinks their account
/authcodes unlink

# Admin forces new 2FA code for player
/authcodes forcecode Notch
# → Notch receives new 8-digit code

# Admin unlinks a player
/authcodes forceunlink Notch

# Admin reloads config
/authcodes reload

⚙️ Configuration

config.yml 
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

🔄 How It Works

First Login (Linking)

  1. Player joins server with required permission
  2. Plugin prompts: /authcodes link telegram or discord
  3. Player enters command → receives 6-digit code in chat
  4. Player enters code in Telegram/Discord bot
  5. Account linked! (1 attempt, 5 minute expiry)

Subsequent Logins (2FA)

  1. Player joins server with linked account
  2. Plugin sends 8-digit code to Telegram/Discord
  3. Player enters /code <digits> in chat
  4. Restrictions lifted! (3 attempts, 60 second timeout)

🛡️ Safety

  • Graceful Shutdown — All resources properly closed on server stop
  • PlugMan Compatible — Handles NoClassDefFoundError and other errors during unload
  • Async Safe — All bot operations run asynchronously, no server lag
  • Thread Management — Polling threads properly interrupted on shutdown
🇷🇺 Русская текст

🔐 AuthCodes

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

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

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

📋 Требования

Зависимость Версия
Сервер Paper/Spigot 1.16.5+
LuckPerms 5.x+
Java 11+

🔐 Права

Право Описание По умолчанию
authcodes.admin Доступ к командам администратора (reload, forceunlink, forcecode) OP
group.admin Требует 2FA (настраивается) -
group.moderator Требует 2FA (настраивается) -
authcodes.force Требует 2FA (настраивается) -

🎮 Команды

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

Команда Описание Пример
/authcodes link telegram Начать привязку через Telegram /authcodes link telegram
/authcodes link discord Начать привязку через Discord /authcodes link discord
/code <8-значный> Ввести код 2FA при входе /code 58291743
/authcodes unlink Отвязать свой аккаунт /authcodes unlink

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

Команда Описание Пример
/authcodes reload Перезагрузить конфиг плагина /authcodes reload
/authcodes forceunlink <игрок> Принудительно отвязать игрока /authcodes forceunlink Notch
/authcodes forcecode <игрок> Принудительно отправить новый код 2FA игроку /authcodes forcecode Notch

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

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

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

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

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

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

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

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

config.yml 
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-потоки корректно прерываются при завершении