vLink

vLink is a lightweight Paper and Velocity plugin that allows players to link their Minecraft account with Discord. Once linked, Discord roles can automatically sync based on LuckPerms groups.

Players generate a code ingame with /link and confirm it on Discord using /link <code>. After that, their Minecraft account and Discord account are connected, and roles can be synchronized automatically.

Features

• Supports Paper and Velocity
• Account linking via /link
• Discord slash command for code confirmation
• Role synchronization using LuckPerms groups
• Optional linked-player Discord role
• Optional Discord nickname synchronization
• Automatic sync on join
• Optional periodic role synchronization
• /unlink to remove the connection
• /link status to view the current link status
• Admin commands for reload, sync, status, and unlink management
• Multilanguage messages with English and German included
• bStats support for Paper and Velocity

Commands

Ingame

• /link
• /link status
• /link sync
• /link unlink
• /unlink
• /vlink reload
• /vlink sync <player|all>
• /vlink unlink <player>
• /vlink status <player>

/discordlink is also available as an alias for /vlink.

Discord

• /link <code>
• /sync
• /status
• /unlink

Setup

Install the correct plugin file for your platform:

• Paper: vlink-*-paper.jar
• Velocity: vlink-*-velocity.jar

Restart your server or proxy once. The configuration files will be generated automatically.

Inside the config, enter your Discord bot token, guild ID, and the role IDs you want vLink to manage. The Discord bot requires the Manage Roles permission. Make sure the bot role is placed above every role it should assign or remove.

LuckPerms must be installed on the same platform as vLink.

Example Config

roles:
  linked-role-id: "123456789012345678"
  group-role-map:
    vip: "123456789012345678"
    admin: "987654321012345678"