Language

🇬🇧 English🇷🇺 Русский🇺🇦 Українська🇩🇪 Deutsch🇫🇷 Français🇨🇳 中文🇯🇵 日本語🇧🇷 Português🇪🇸 Español
AuthCodes

AuthCodes

Modrinth

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

6 downloads 1 followers updated 26d ago
latest vBeta-1.0.1 Modrinth
Bukkit Paper Purpur Spigot 1.16.5 – 26.2 ManagementTechnologyUtility

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

Versions

Beta
Beta-1.0.1
bukkit, paper, purpur · 1.16.5, 1.17, 1.18 · 26d ago
Add server stop if plugin disabling Add bossbar
5
Beta
Beta-1.0.0
bukkit, paper, purpur · 1.16.5, 1.17, 1.18 · 26d ago
1

Comments 0

No comments yet. Be the first to share your thoughts.

FAQ

How do I install AuthCodes?

Download the file for your Minecraft version and loader from this page, then drop the .jar into your mods (or plugins) folder and launch the game.

Is AuthCodes free?

AuthCodes is free to download on Modgrid — we link straight to the official source, no paywall or bundled installer.

Which Minecraft versions does AuthCodes support?

Works with Bukkit, Paper, Purpur, Spigot. Supports versions 1.16.5–26.2. See the download section on this page for the full list of supported versions and loaders.

Download AuthCodes

Files are served directly from the original source. Modgrid does not host or modify them.