Synapse Link - Discord & LuckPerms Role Sync icon

Synapse Link - Discord & LuckPerms Role Sync -----

Sync Discord Roles to LuckPerms automatically. No external scripts, just one plugin.



Synapse Link
open-source

The ultimate bridge between your Discord Community and your Minecraft Server.

Are you tired of manually assigning ranks to your donors or staff members? Are you frustrated with complex "sync" plugins that require you to host a separate Node.js bot, open weird ports, or install Python scripts?

Stop the hassle. Synapse Link is here to simplify your life.

Synapse Link is a powerful, standalone plugin that runs a Discord Bot directly inside your server. No external dependencies, no complicated setups. Just drop the .jar, configure your roles, and let the magic happen.​

Why Synapse Link? (The "Factor X")

Most sync plugins are either too simple (and lack features) or too complex (requiring external bots).
  • VS Others: Unlike other plugins that freeze your server when connecting to Discord, Synapse Link is built with a 100% Asynchronous Architecture.
  • No Lag: Reloading the plugin configuration (/synapse reload) happens in the background. Your TPS will never drop because of a Discord connection.
  • Smart Sync: We don't spam the Discord API. Synapse Link intelligently updates only the players who are currently online, keeping your bot safe from Rate Limits.
Demo & Setup

Key Features
  • All-in-One Solution: Runs the Discord Bot directly within the plugin. No Pterodactyl standalone servers or external scripts needed.
  • Instant Role Sync: When you assign a Role in Discord (e.g., VIP), the player receives the LuckPerms group in-game automatically.
  • High-End Security System:
    • IP & Geo-Lock: If a linked player joins from a different country or suspicious IP, the account acts as "Locked" until verified via Discord.
    • One-Time Code: Secure linking process using a short-lived 5-minute code.
  • Multi-Language: Native support for English and Spanish (es).
  • SQLite Database: fast and local data storage. No MySQL setup required (unless you want to).
  • AuthMe Support: detects when a player logs in/registers to remind them to link their account.
Commands & Permissions
/link (Default) -> Generates a one-time code to link the account.
/synapse reload "synapse.reload" -> Reloads the configuration and restarts the bot asynchronously.

Configuration (Simple & Clean) "config.yml"
Code (Text):
# Replace the sample value to launch the bot alongside the plugin.
lang: en # Available options: en, es
bot:
  token: "YOUR_TOKEN_DISCORD" # Discord bot token from the Discord developer portal.
link:
  code-lifetime-seconds: 300 # Code expiration time. (5 minutes = 300 seconds)
ranks: # Use your Discord role IDs
  owner: "12341245124"
  admin: "3124124124"
  mod: "2312412412"
  helper: "12412412421"
rank-sync:
  interval-seconds: 300 # Interval (in seconds) to validate Discord roles against LuckPerms groups.
Installation
  1. Download Synapse-Link.jar.
  2. Drop it into your plugins folder.
  3. Start the server to generate the config.
  4. Create a Discord Bot (Developer Portal) and paste the Token in config.yml.
  5. Set up your Roles mapping.
  6. Run /synapse reload. Done!
Dependencies to be installed:
  • Authme Reloaded. (5.6.0 or +) HERE
  • LuckPerms. (5.4 or +) HERE
Resource Information
Author:
----------
Total Downloads: 14
First Release: Nov 21, 2025
Last Update: Nov 21, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings