Solifex Studios
DiscordSynthesisWiki
Browse the wiki

Features

Account linking

Bind Minecraft and Discord identities with one-time codes — optionally required to play.

Module

modules.linkRequired (to require it)

Config

config.yml core

Commands

/connect, /pin, /disconnect

Platform

All

Linking connects a player's Minecraft account to their Discord account. It underpins role sync, ban sync, authorization, rewards, and per-player stats. Players can always link voluntarily; you can also make it mandatory.

How players link

  1. 1

    In Minecraft, run /connect

    The plugin generates a one-time, expiring code.

  2. 2

    In Discord, send the code

    Message the bot (or use /connect <code>) with the code to bind the accounts.

  3. 3

    Done

    Roles, nicknames, and stats now follow the player. /disconnect unlinks.

Note

Stale codes can't hijack an existing link — a code only ever binds the account that generated it.

Linking method

yamlconfig.yml
# CODE — player types a code in Discord
# BUTTON — player clicks a button to link
linkType: CODE

Requiring a link to play

Turn on the linkRequired module to force players to link before they can play. Optionally kick players who stay unlinked after a delay.

yamlconfig.yml
modules:
  linkRequired: true
# Seconds before an unlinked player is kicked; -1 disables
unlinkKickDelay: -1

The permission discordsynthesis.bypass.requiredlinking exempts staff. See Rewards to hand out items on link.