Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!

Link

LINK is a fast, secure, and lightweight plugin that allows players to link their Minecraft accounts with Discord using s

✔ Spigot Support ✔ Paper Support ✔ Purpur 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

Features

✅ Fast Linking — Generate & verify codes instantly
✅ Secure System — Safe and validated account linking
✅ Developer API — Clean and simple integration support
✅ Lightweight — ~90 KB plugin, libraries downloaded on demand
✅ Platform Support — Spigot, Folia & Velocity compatible
✅ Discord Role Sync — Automatically assign a role when linked
✅ Easy Setup — Up and running in minutes
✅ Multi-Database — H2 (default), SQLite, MySQL, MariaDB & PostgreSQL
✅ Configurable Logging — Control HikariCP and JDA log levels from config
✅ Live Reload — Reload configs without restarting with /link reload

How It Works

Run /link in Minecraft
Receive a unique code
Enter the code in Discord
Accounts linked instantly

Installation

Place the plugin in /plugins
Start the server (libraries will download automatically on first run)
Configure discord.yml with your bot token, guild ID and role ID
Configure database.yml if you want a remote database (H2 works out of the box)
Type /setup in any Discord channel
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 Minecraft\n - Join the server: `play.server.com`\n - Run `/link`\n - Enter your Auth Code in #link"
      inline: false
    - name: "Linking Rewards:"
      value: " - 🪙 100 Gold\n - 💎 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.

Simple • Fast • Reliable

Information

Category	Gameplay
Published on	April 12, 2026
License	MIT
Downloads	0
Stars	0
Watchers	0

Supports Folia

Pinned Versions

1.0.4
Release
26.1-26.1.2
3.5

Pages

Resource Page

Links

Github

Members

HuskyDreaming

Owner