Permissions

Permissions

All permission nodes used by uxmDiscordSync. Default values assume a standard LuckPerms or similar setup.

---

Player Permissions

These are intended for regular players and should generally be granted to everyone.

Permission	Description	Default
uxmdiscordsync.link	Use the /link command to get a verification code	true
uxmdiscordsync.unlink	Use the /unlink command to unlink their account	true
uxmdiscordsync.linkstatus	Use the /linkstatus command to check link status	true
uxmdiscordsync.boostreward	Use the /boostprize command to claim boost rewards	true
uxmdiscordsync.discordreward	Use the /discordreward command to claim level rewards	true
uxmdiscordsync.2fa	Use the /2fa command to view and manage 2FA settings	true

---

Special Bypass Permissions

Permission	Description	Default
uxmdiscordsync.chat.bypass	Exclude player from chat logging and the chat bridge	false
uxmdiscordsync.2fa.bypass	Skip 2FA verification on login (trusted accounts)	false

---

Admin Permissions

These are sensitive and should be granted only to server administrators.

Permission	Description	Default
uxmdiscordsync.admin	Access all /uxmdiscordsync sub-commands (reload, stats, debug, forcelink, forceunlink, forcesync)	OP
uxmdiscordsync.2fa.notify	Receive admin notifications when a 2FA login is denied	OP

---

Configuring Permissions

LuckPerms Example

Grant all player permissions to the default group:

/lp group default permission set uxmdiscordsync.link true
/lp group default permission set uxmdiscordsync.unlink true
/lp group default permission set uxmdiscordsync.linkstatus true
/lp group default permission set uxmdiscordsync.boostreward true
/lp group default permission set uxmdiscordsync.discordreward true
/lp group default permission set uxmdiscordsync.2fa true

Grant admin permissions to the admin group:

/lp group admin permission set uxmdiscordsync.admin true
/lp group admin permission set uxmdiscordsync.2fa.notify true

Grant the chat bypass to a staff group:

/lp group staff permission set uxmdiscordsync.chat.bypass true

Wildcard

Grant all uxmDiscordSync permissions with the wildcard:

/lp group admin permission set uxmdiscordsync.* true

---

Command Permission Customisation

The actual permission node for each command is defined in commands.yml. You can change any node to whatever fits your server's permission scheme:

link:
  permission: "myplugin.discordlink"   # Custom permission node

After changing commands.yml, restart the server for the new nodes to register.

---

Permission Node Summary (Quick Reference)

uxmdiscordsync.*                  → All permissions (use for admins)
uxmdiscordsync.link               → /link
uxmdiscordsync.unlink             → /unlink
uxmdiscordsync.linkstatus         → /linkstatus
uxmdiscordsync.boostreward         → /boostprize
uxmdiscordsync.discordreward      → /discordreward
uxmdiscordsync.2fa                → /2fa
uxmdiscordsync.admin              → /uxmdiscordsync (all sub-commands)
uxmdiscordsync.2fa.notify         → Receive admin 2FA alerts
uxmdiscordsync.chat.bypass        → Skip chat log and chat bridge
uxmdiscordsync.2fa.bypass         → Skip 2FA on login