Discord

The companion jar, what it mirrors into Discord, and account linking.

uxmEssentials reaches Discord through a companion jar built on JDA. It mirrors server events into your channels and hosts the Discord side of account linking.

What It Is

The bridge ships as its own jar, uxmessentials-discord, alongside the main plugin. It is not bundled into the main jar and does nothing until configured.

It does two things:

Notifications: mirrors audit events and economy notifications into Discord channels, so staff actions and money movement show up where your team already watches.
Account linking: hosts the Discord-side /link slash command that redeems the code a player generates in-game.

How Linking Works

The in-game and Discord halves are deliberately decoupled:

A player runs /discordlink in-game to get a one-time code.
They run /link <code> in your Discord server.
The bridge redeems the code and binds the two accounts.

The in-game commands (/discordlink, /discordlink status, /discordlink gui, /discordunlink) come from the Discord Link module and work on their own: a player can generate and inspect a code with no bridge running. Only the redemption step needs the companion jar to be online and connected.

Command	Where	Permission
`/discordlink` · `/discordlink status`	In-game	`uxmessentials.discord.link`
`/discordlink gui`	In-game	`uxmessentials.discord.gui`
`/discordunlink`	In-game	`uxmessentials.discord.link`
`/link <code>`	Discord	(Discord role gating)

Setup (High Level)

Create a Discord application + bot in the Discord Developer Portal and copy its bot token.
Invite the bot to your server with permission to post in the channels you want.
Drop uxmessentials-discord into plugins/ next to the main jar.
Put the token and channel settings into the bridge's discord.conf.
Restart: JDA connects and the /link slash command registers.

Keep the bot token secret

The token in discord.conf grants full control of the bot. Never commit it to version control or paste it in a public channel. Rotate it in the Developer Portal if it leaks.

When the Bridge Is Absent

Because it's a distinct jar that stays dormant until configured, a server without it is completely unaffected:

Situation	Behavior
Bridge not installed	In-game `/discordlink` still issues codes; there is simply nothing to redeem them against.
Bridge installed, no token	Dormant: no connection, no notifications.
Bridge connected	Notifications flow and `/link` redeems codes.

Setup Checklist

Keep the Discord Link module enabled for the in-game commands.
Install the uxmessentials-discord jar only if you want notifications and /link redemption.
Configure a bot token in discord.conf.
Restart and confirm the bot comes online in your Discord server.

Was this page helpful?