Sprache

🇬🇧 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 Follower aktualisiert 26d ago
neueste 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-потоки корректно прерываются при завершении

Versionen

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

Kommentare 0

Noch keine Kommentare. Sei der Erste, der seine Meinung teilt.

FAQ

Wie installiere ich AuthCodes?

Lade die Datei für deine Minecraft-Version und deinen Loader auf dieser Seite herunter, lege die .jar in den mods- (oder plugins-) Ordner und starte das Spiel.

Ist AuthCodes kostenlos?

AuthCodes ist auf Modgrid kostenlos — wir verlinken direkt zur offiziellen Quelle, ohne Paywall.

Welche Minecraft-Versionen unterstützt AuthCodes?

Funktioniert mit Bukkit, Paper, Purpur, Spigot. Unterstützt die Versionen 1.16.5–26.2. Die unterstützten Versionen und Loader findest du im Download-Bereich dieser Seite.

Herunterladen AuthCodes

Dateien werden direkt von der Originalquelle bereitgestellt. Modgrid hostet oder verändert sie nicht.