Discord Link Manifest
The discord_link_manifest configures how players link their Minecraft accounts to Discord, including verification channels, bot settings, and role syncing.
Commands
The command is registered through the engine's command system.
| Command | Description |
|---|---|
/{commandName} | Generates (or repeats) a verification code |
/{commandName} unlink | Removes the player's Discord link and mapped roles |
[!IMPORTANT] Since v0.8, the old
/DiscordLinkand/DiscordUnlinkcommands are replaced by/{commandName}and/{commandName} unlink(defaultdiscordlink).
Configuration
discord_link_manifest — Map
Configuration for the entry.
Properties
commandName
Command players run to generate a link code.
storage — Artifact
The artifact used to store link data (UUID <-> Discord ID) and pending codes.
webhook — WebhookSettings
Webhook used to post link instructions and confirmations.
bot — DiscordBotSettings
Bot configuration: enabled, botToken, guildId, and the verification replies.
verificationChannelId — String
The Discord Channel ID where players type their code.
codeLength — Int
Length of the generated verification code (cryptographically random).
codeValidityMinutes — Int
How long a code remains valid before expiring.
autoOverwriteExistingLink — Boolean
Automatically overwrite existing links when a new code is confirmed.
notifyPermission — String
Permission receiving in-game notifications when a link is confirmed (empty disables them).
groupPermissionFormat — String
Permission checked per mapping to pick the player's group; {group} is replaced by the mapping's Minecraft group.
roleMappings
"> Mappings between Minecraft groups and Discord Role IDs for sync. onLinkTriggers
" default="[]"> Entries triggered for the player when their Discord link is confirmed — perfect for "link your account" quests or rewards. messages —
DiscordLinkMessages
Player facing messages, including the configurable embed titles (embedLinkedTitle, embedUnlinkedTitle). Placeholders: {code}, {duration}, {discord}, {player}.