?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings

DiscordAuthMeBridge

DiscordAuthMeBridge is A bridge between Minecraft, Discord, and AuthMe.

27downloads
0followers
27downloads
0followers

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Creators

Details

Licensed MIT
Published last month
Updated 2 months ago

DiscordAuthMeBridge

DiscordAuthMeBridge is a Minecraft server plugin that connects Minecraft, Discord, and AuthMe through a secure HTTP bridge. It provides account linking, login verification, trusted IP management, and integration endpoints for Discord bots and supported server services.

Built for Paper-based Minecraft servers, the plugin uses AuthMe for authentication, SQLite for persistent account data, and an HTTP API for communication between Minecraft and external Discord bot services.

āœØ Features

šŸ”— Minecraft ā†” Discord Account Linking

  • Link Minecraft accounts with Discord identities.
  • Require the Minecraft player to be online and authenticated through AuthMe before confirming a link.
  • Send interactive confirmation and rejection buttons directly in Minecraft chat.
  • Use temporary link requests with configurable expiration.
  • Enforce a one-to-one relationship between Minecraft accounts and Discord accounts.
  • Store account links in a local SQLite database.

šŸ” Login Security & IP Verification

  • Detect login attempts from unrecognized IP addresses.
  • Maintain trusted IP addresses for individual Minecraft accounts.
  • Send login verification requests to the connected Discord bot.
  • Allow players to approve or reject suspicious login attempts through Discord.
  • Configure verification timeouts and Minecraft kick messages.
  • Store trusted IP information persistently.

šŸ”‘ AuthMe Integration

  • Integrate directly with the AuthMe API.
  • Check whether players are authenticated before completing protected operations.
  • Provide an HTTP endpoint for validating Minecraft credentials against AuthMe.
  • Verify account registration and password validity without storing Minecraft passwords in the plugin database.

šŸŒ HTTP Bridge API

  • Provide an authenticated HTTP interface between Minecraft and external services.
  • Support account-linking requests and IP verification actions.
  • Queue Minecraft events for the Discord bot to retrieve and acknowledge.
  • Expose endpoints for supported rank lookup, rank application, and in-game key delivery integrations.
  • Use a configurable host, port, and shared secret for API access.

šŸ—„ļø Persistent Storage

  • Use SQLite for account links and trusted IP records.
  • Automatically initialize the database and required tables.
  • Avoid the need for a separate database server.

šŸ›”ļø Security & Reliability

  • Validate incoming bridge requests using a shared secret.
  • Reject unauthorized HTTP requests.
  • Expire temporary linking requests automatically.
  • Prevent duplicate account associations.
  • Validate player identity and AuthMe authentication during link confirmation.
  • Execute Minecraft server operations through the Bukkit/Paper scheduler.

āš™ļø Configuration

  • Configure the HTTP bridge host, port, and shared secret.
  • Configure link-code expiration.
  • Enable or disable IP checking.
  • Customize IP verification messages, Discord notification text, and timeouts.
  • Configure optional PIN-related settings.

šŸ”„ How It Works

  1. Connect the Discord bot

Configure the HTTP bridge and shared secret in the plugin configuration. The external Discord bot must use the same bridge credentials.

  1. Request an account link

The Discord bot submits a linking request through the HTTP API, specifying the Discord identity and Minecraft username.

  1. Confirm in Minecraft

The plugin sends an interactive confirmation message to the specified online player. The player can approve or reject the request directly in Minecraft.

  1. Validate and save

When the player confirms, the plugin checks AuthMe authentication, validates the pending request, and ensures neither account is already linked to a different identity.

  1. Notify Discord

After a successful link, the plugin queues a link-completion event for the Discord bot to retrieve and acknowledge.

  1. Verify unfamiliar login addresses

When IP checking is enabled, an untrusted address can trigger a Discord verification request. The player must complete the verification workflow before proceeding with a new login.

šŸ“‹ Commands

Minecraft

  • "/discordauth confirm <requestId>" ā€” Confirm a pending Discord account-linking request.
  • "/discordauth reject <requestId>" ā€” Reject a pending Discord account-linking request.

Note: These are the intended command forms exposed by the linking workflow. Verify command registration in the released JAR before publishing them as supported commands.

HTTP API

The plugin exposes endpoints for:

  • AuthMe credential verification
  • Discord account-linking requests
  • IP verification approval and rejection
  • Rank lookup and rank application
  • In-game key delivery
  • Minecraft-to-Discord event polling and acknowledgement

All protected API requests must include the configured bridge secret.

āš™ļø Configuration

The main configuration file is "plugins/DiscordAuthMeBridge/config.yml".

Important configuration sections include:

  • "Check-IP" ā€” Enables or disables IP checking.
  • "Link-Code.Expires-In" ā€” Configures link-code expiration.
  • "Bridge.Host" ā€” HTTP bridge bind address.
  • "Bridge.Port" ā€” HTTP bridge listening port.
  • "Bridge.Secret" ā€” Shared secret required for protected API requests.
  • "IP-Verification.Timeout" ā€” Expiration time for IP verification requests.
  • "IP-Verification.Kick-Message" ā€” Minecraft kick message for unrecognized IP addresses.
  • "IP-Verification.Discord" ā€” Discord verification message and action labels.
  • "PIN.enabled" ā€” PIN-related feature setting.
  • "PIN.digits" ā€” Configured PIN length.

Use a strong, private bridge secret and never publish it in screenshots, configuration examples, or source archives.

šŸ“¦ Requirements

  • Minecraft server: Verify compatibility with the exact Paper build targeted by the release.
  • Java: 25 for the supplied Maven build configuration.
  • AuthMe: Required.
  • Discord bot: Required for Discord-based verification and bot integration.
  • LuckPerms: Optional dependency for supported rank integrations.
  • SQLite: Included through the plugin's database dependency.

šŸ—ƒļø Storage

The plugin stores account links and trusted IP information in a local SQLite database under its plugin data directory.

No external database server is required.

šŸš€ Installation

  1. Install a compatible Paper server and AuthMe.
  2. Place "DiscordAuthMeBridge.jar" in the server's "plugins" folder.
  3. Start the server to generate the default configuration.
  4. Configure the HTTP bridge, including its host, port, and shared secret.
  5. Configure the external Discord bot to use the same bridge credentials.
  6. Restart the server and check the console for startup errors.
  7. Test account linking and IP verification before deploying to a production server.

šŸ’¬ Support

When reporting an issue, include:

  • Minecraft and server software versions
  • DiscordAuthMeBridge version
  • Java version
  • Relevant console errors
  • Relevant configuration with all secrets and sensitive information removed

DiscordAuthMeBridge ā€” Connecting Minecraft, Discord, and AuthMe with account linking, login verification, and an extensible HTTP bridge.