Skip to content

Minecraft Commands

Jump to bottom
Ali Arslan edited this page Apr 11, 2026 · 3 revisions

Minecraft Commands

All Minecraft commands are registered dynamically from commands.yml. Aliases and permissions are fully customisable.

Player Commands

/link

Generates a 6-digit verification code for account linking.

/link
  • Default permission: uxmdiscordsync.link
  • Cooldown: 30 seconds between code requests; max 3 codes per minute
  • Code expiry: Configurable (default 300 seconds)

Behaviour:

  • If already linked: shows current link status.
  • If on cooldown: shows remaining wait time.
  • On success: sends a formatted code message in chat with instructions.

/unlink

Unlinks the player's Minecraft account from their Discord account.

/unlink
  • Default permission: uxmdiscordsync.unlink

Behaviour:

  • Removes the database record.
  • Removes all configured linked-role-ids from Discord.
  • Resets Discord nickname if nickname sync is enabled.
  • Records an audit log entry.

/linkstatus

Shows whether the player's account is currently linked and, if so, to which Discord user.

/linkstatus
  • Default permission: uxmdiscordsync.linkstatus

Output example:

Your account is linked to: JohnDoe#0000 (ID: 123456789)
Linked on: 2025-01-15 14:32:00

/boostprize

Claims the Discord server boost reward.

/boostprize
  • Default permission: uxmdiscordsync.boostprize

Requirements: Linked account + actively boosting the Discord server.

See Boost Rewards for full details.

/discordreward

Claims any unclaimed Discord level rewards.

/discordreward
  • Default permission: uxmdiscordsync.discordreward

Requirements: Linked account + must have unclaimed level rewards.

See Level System for full details.

/2fa

Manages the player's two-factor authentication preferences.

/2fa status     # Check if 2FA is active for your account
/2fa disable    # Disable 2FA (if allowed in config)
  • Default permission: uxmdiscordsync.2fa

Admin Commands

All admin sub-commands use the main plugin command. Default aliases: /uxmdiscordsync, /uxmds.

  • Default permission: uxmdiscordsync.admin

Reload

/uxmdiscordsync reload

Reloads all configuration files without restarting the server. The Discord bot connection is not interrupted. Note: database type and bot token changes still require a full restart.

Stats

/uxmdiscordsync stats

Displays plugin statistics in the console/chat:

  • Total linked accounts
  • Cache hit rate
  • Database type in use
  • Uptime
  • Discord bot latency

Debug Mode

/uxmdiscordsync debug

Toggles verbose debug logging. When enabled, detailed information is logged to the console for all plugin operations. Useful for diagnosing issues. Toggle off again when done to reduce log spam.

Force Link

/uxmdiscordsync forcelink <player> <discordId>

Manually creates a link between a Minecraft player and a Discord user, bypassing the normal linking flow. Useful for migrating data or fixing edge cases.

Argument Description
<player> Minecraft username or UUID
<discordId> Discord user snowflake ID

Force Unlink

/uxmdiscordsync forceunlink <player>

Removes the link for the specified player. Same effect as the player running /unlink, but does not require the player to be online.

Force Sync

/uxmdiscordsync forcesync <player>

Immediately runs a full rank and nickname sync for the specified player. Useful after manually changing a player's rank in LuckPerms.

Customising Commands

All commands, their aliases, and permissions are defined in commands.yml. Example:

link:
  aliases:
    - link
    - discordlink
    - connectdiscord
  permission: "uxmdiscordsync.link"

admin:
  aliases:
    - uxmdiscordsync
    - uxmds
    - discordsync
  permission: "uxmdiscordsync.admin"

Changes to commands.yml require a server restart (command registration happens at startup).

Permission Summary

Permission Command Default
uxmdiscordsync.link /link All players
uxmdiscordsync.unlink /unlink All players
uxmdiscordsync.linkstatus /linkstatus All players
uxmdiscordsync.boostprize /boostprize All players
uxmdiscordsync.discordreward /discordreward All players
uxmdiscordsync.2fa /2fa All players
uxmdiscordsync.admin /uxmdiscordsync OP only
uxmdiscordsync.2fa.notify Admin 2FA alerts OP only
uxmdiscordsync.chat.bypass Skip chat log/bridge —

See Permissions for the full permission reference.

🏠 Home

⚙️ Setup

🔗 Core Systems

✨ Features

📋 Logging

💬 Commands

🔧 Advanced

Clone this wiki locally