DiscordAuthMeBridge

DiscordAuthMeBridge

DiscordAuthMeBridge is a lightweight Minecraft plugin that allows players to securely link their Minecraft accounts with Discord using AuthMe and a Discord bot.

✨ Features

• 🔗 Link Minecraft accounts with Discord
• 🔐 Requires the player to be authenticated through AuthMe
• 🤖 Discord bot integration using JDA
• 🔑 Temporary link codes with configurable expiration time
• 🗄️ SQLite database for storing account links
• 🛡️ Prevents the same Discord account from linking multiple Minecraft accounts
• 🛡️ Prevents the same Minecraft account from linking multiple Discord accounts
• 🎯 Restricts Discord linking commands to a configured Guild and Channel
• ⚡ Lightweight and easy to configure

🔄 How It Works

1. Login to Minecraft

The player must first log in through AuthMe.

1. Generate a link code

Run:

/link

The plugin generates a temporary code.

Example:

Discord Link

Your link code is:

X7K92P

In Discord, type:

/linkcheck X7K92P

1. Confirm on Discord

In the configured Discord channel, use:

/linkcheck X7K92P

The bot verifies the code and creates the account link.

1. Account linked

The Minecraft UUID and Discord ID are stored in the plugin's SQLite database.

📋 Commands

Minecraft

Command| Description "/link"| Generate a Discord linking code

Discord

Command| Description "/linkcheck "| Confirm a Minecraft ↔ Discord link

🔐 Security

DiscordAuth does not need or access the player's AuthMe password.

Authentication is checked through the AuthMe API:

authMeApi.isAuthenticated(player)

Link codes are temporary and expire after the configured amount of time.

Each Discord account and Minecraft account can only have one active link.

⚙️ Configuration

Token-Bot: "PUT_BOT_TOKEN_HERE"

Guild-ID: ""

Channel-ID: ""

Link-Code: Expires-In: "5m"

Configuration Options

Option| Description "Token-Bot"| Discord bot token "Guild-ID"| Discord server ID where linking is allowed "Channel-ID"| Discord channel where "/linkcheck" can be used "Link-Code.Expires-In"| Link code expiration time

📦 Requirements

• Minecraft: 1.21+
• Server: Spigot/Paper
• Java: 21+
• AuthMe: Required
• Discord Bot: Required

🗃️ Storage

DiscordAuth uses SQLite and automatically creates:

plugins/DiscordAuth/links.db

No external database server is required.

🚀 Installation

1. Install AuthMe on your server.
2. Put "DiscordAuth.jar" into your "plugins" folder.
3. Start the server once.
4. Configure "config.yml".
5. Create/configure your Discord bot.
6. Restart the server.
7. Players can use "/link" to begin linking their accounts.

💬 Support

If you encounter a problem, provide your server version, plugin version, console error, and configuration with your bot token removed.

---

DiscordAuth — Simple, lightweight Minecraft ↔ Discord account linking.