📖About 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:

Default locale: en_us