2FA Plugin

2FA Discord Plugin

Universal Discord-based 2FA plugin for Paper servers.

Overview

2FA Discord Plugin adds a Discord approval step to Minecraft logins on Paper servers.

After a player links their Minecraft account to Discord, future logins can require confirmation through Discord direct messages. The plugin can also temporarily block player actions while approval is pending, kick a login attempt, or block the account through Discord controls.

Features

• Discord-based login confirmation
• Account linking with one-time verification codes
• Temporary login session by IP
• Optional account blocklist
• Admin commands for disabling 2FA and unblocking accounts
• Configurable locale system: en_us and ru_ru
• Database support: sqlite, mysql, postgresql

Requirements

• Java 21
• Paper 1.21.11
• Discord bot token

Commands

• /2fa enable — link your Minecraft account to Discord
• /2fa disable [player/uuid/discord_id] — disable 2FA for a player
• /2fa unblock [player/uuid/discord_id] — remove a 2FA block
• /2fa reload — reload config and services

Permissions

• 2fa.command.enable
• 2fa.command.disable
• 2fa.command.unblock
• 2fa.command.reload

Configuration

Main config: src/main/resources/config.yml

Important options:

• discord.token — Discord bot token
• locale — active locale (en_us or ru_ru)
• session-duration-seconds — how long the IP session stays trusted
• database.type — sqlite, mysql, or postgresql

Locales

Locale files:

• src/main/resources/locale/en_us.yml
• src/main/resources/locale/ru_ru.yml

Default locale: en_us