Discord 2FA
Discord 2FA is a plugin designed to enhance the security of your Minecraft server by integrating two-factor authentication (2FA) with Discord account
🛡️ Why Discord2FA?
Token-grabbing is one of the biggest threats facing Minecraft players today. With Discord2FA, every login is verified through Discord — meaning even if someone steals a player's Minecraft credentials, they still can't get in without access to their Discord account. Beyond security, Discord2FA makes a great verification gate: players must link and verify through Discord before they can interact with your server, significantly reducing alt accounts and anonymous trolling.
⚙️ Setup
- Download the correct jar for your platform (Spigot, Paper, Velocity...)
- Create a Discord Bot at Discord Developer Portal and invite it to your server
- Configure config.yml with your bot token, guild ID, and channel ID
- Restart your server
🖥️ Supported Platforms
| Platform | Module | Notes |
|---|---|---|
| Paper | paper | 1.16.5+ |
| Spigot | spigot | 1.20.5+ |
| BungeeCord | bungeecord | Proxy; optional verification/post-verification servers |
| Velocity | velocity | Proxy; same options as BungeeCord |
🧩 Permissions
Discord2FA uses grant-by-default permissions for link/unlink and op-only for admin:
| Permission | Default | Description |
|---|---|---|
discord2fa.link | true | Use /link. |
discord2fa.unlink | true | Use /unlink. |
discord2fa.admin | op | Use /discord2fa (version, status). |
🗂️ Configuration
# Language: EN, DE, FR, IT, PL, RO, RS, TR, UA
language: en
# Storage: MYSQL or FILE
storage: "FILE"
fileAsFallback: true
database:
ip: ""
name: ""
user: ""
password: ""
discord:
token: ""
guild: ""
channel: ""
# Commands usable before verification
allowedCommands: ["/link"]
# Require all players to link Discord
forceLink: false
# Skip re-verification for known IPs
rememberIPAddresses: true
Support and Troubleshooting
For any further assistance or troubleshooting, please reach out to our support server on Discord.
