1.0.3
release
Link
LINK is a fast, secure, and lightweight plugin that allows players to link their Minecraft accounts
21
Link
---
✔ Spigot Support ✔ Folia Support ✔ Velocity Support
---
Overview
LINK is a fast, secure, and lightweight plugin that allows players to link their Minecraft account with Discord using simple verification codes. Built for performance. Designed for real servers.
External libraries are downloaded automatically on first startup and cached locally — keeping the plugin JAR under 90 KB.
Features
- ✅ Live Reload — Generate & verify codes instantly - ✅ Live Reload — Safe and validated account linking - ✅ Live Reload — Clean and simple integration support - ✅ Live Reload — ~90 KB plugin, libraries downloaded on demand - ✅ Live Reload — Spigot, Folia & Velocity compatible - ✅ Live Reload — Automatically assign a role when linked - ✅ Live Reload — Up and running in minutes - ✅ Live Reload — H2 (default), SQLite, MySQL, MariaDB & PostgreSQL - ✅ Live Reload — Control HikariCP and JDA log levels from config - ✅ Live Reload — Reload configs without restarting with `/link reload`
How It Works
1. Run `/link` in Minecraft 2. Receive a unique code 3. Enter the code in Discord 4. Accounts linked instantly
Installation
1. Place the plugin in `/plugins` 2. Start the server (libraries will download automatically on first run) 3. Configure `discord.yml` with your bot token, guild ID and role ID 4. Configure `database.yml` if you want a remote database (H2 works out of the box) 5. Type `/setup` in any Discord channel 6. Done
Configuration
database.yml
```
Link - Database Configuration
#
Driver: sqlite | h2 | mysql | mariadb | postgresql (default: h2)
driver: h2
File-based database path — relative to the plugin's data folder.
The subfolder is created automatically. Only used when driver is 'sqlite' or 'h2'.
file: "h2/link"
Remote connection settings (ignored for SQLite and H2)
host: "localhost" port: 3306 name: "link" username: "user" password: "password" pool: maximum-pool-size: 10 minimum-idle: 2 connection-timeout: 10000 idle-timeout: 600000 max-lifetime: 1800000 keepalive-time: 60000 ```
discord.yml
```
Link - Discord Bot Configuration
Your Discord bot token. Get this from the Discord Developer Portal:
https://discord.com/developers/applications → Bot → Reset Token
Keep this secret — never share it or commit it to version control.
token: ""
The ID of the Discord server (guild) the bot operates in.
To get this: enable Developer Mode in Discord settings,
then right-click your server name → Copy Server ID.
guild-id: 0
The ID of the role to assign when a player links their account.
Right-click the role in Server Settings → Roles → Copy Role ID.
The bot's role must be positioned ABOVE this role in the role hierarchy.
role-id: 0
Customise the embed posted by the /setup command in Discord.
embed: title: "Account Linking" description: "Link your account to get in-game rewards!" color: "#97BA52" button-label: "✅ Authenticate Account" fields: - name: "Linking Guide:" value: " - Launch Minecraftn - Join the server: `play.server.com`n - Run `/link`n - Enter your Auth Code in #link" inline: false - name: "Linking Rewards:" value: " - 🪙 100 Goldn - 💎 10 Gems" inline: false ```
config.yml — Velocity
```
Seconds a player must wait before re-linking after unlinking
cooldown: 3600
Log level overrides (OFF, ERROR, WARN, INFO, DEBUG, TRACE)
logging: hikari: WARN jda: WARN
Per-backend-server commands. %player% is replaced with the player's username.
servers: survival: link-commands: - "say %player% has linked their account!" unlink-commands: - "say %player% has unlinked their account!" ```
config.yml — Spigot / Folia (standalone)
```
mode: velocity-bridge | standalone
mode: standalone
cooldown: 3600
logging: hikari: WARN jda: WARN
link-commands: - "say %player% has linked their account!" unlink-commands: - "say %player% has unlinked their account!" ```
Commands
| Command | Description | Platform | |---|---|---| | `/link` | Generate a linking code | Velocity / Spigot / Folia | | `/link reload` | Reload all config files live | Velocity / Spigot / Folia | | `/unlink` | Unlink your account | Velocity / Spigot / Folia | | `/setup` | Post the linking embed in a channel | Discord |
Developer API
- Access linked account data - Listen to link events - Extend functionality easily
Support
GitHub: HuskyDreaming/Link — Full documentation and source code.
Plugin is featured on (test here): `play.wilden.fun`
---
*Simple • Fast • Reliable*