Minecraft Commands

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: none (open to all players by default; set in commands.yml)
• 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: none (open to all players by default; set in commands.yml)

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: none (open to all players by default; set in commands.yml)

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.boostreward

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.boostreward	/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.