Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
LuxDiscord
LuxDiscord connects your Minecraft server with Discord using powerful tools like account linking, chat mirroring, support tickets, applications, and a built-in web dashboard.
Perfect for communities that want Discord and Minecraft fully integrated.
โจ Features
- ๐ Minecraft โ Discord chat mirror
- ๐ Join / leave announcements in Discord
- ๐ Secure account linking (
/link+/verify) - ๐ซ Optional verification enforcement
- ๐ Discord moderation tools
- ๐ซ Ticket system with Discord panels
- ๐ Application system with web form
- ๐ Web dashboard for management
- ๐จ Shared website themes & branding
- โก Built for modern Paper servers
๐ฆ Compatibility
| Component | Requirement |
|---|---|
| Platform | Paper |
| Minecraft | 1.21+ |
| Java | 21+ |
โ Installation
- Download the plugin jar
- Place it in your server:
plugins/
-
Start your server once
-
Edit the config file:
plugins/LuxDiscord/config.yml
- Restart the server or run:
/luxdiscord reload
๐ค Discord Bot Setup
-
Create a bot in the Discord Developer Portal
-
Add your bot token to the config:
discord.token: "YOUR_TOKEN"
- Enable these privileged intents:
- Message Content Intent
- Server Members Intent
- Invite the bot with scopes:
bot
applications.commands
- Give the bot these permissions:
- View Channels
- Send Messages
- Read Message History
- Embed Links
- Use Slash Commands
๐ Quick Setup
Minimum config required:
discord:
enabled: true
token: "YOUR_TOKEN"
channels:
chat: "CHANNEL_ID"
Then reload the plugin:
/luxdiscord reload
โจ Commands
/link
Starts Discord account linking and generates a one-time verification code.
/ticket [category]
Opens a support ticket.
/luxdiscord reload
Reloads the LuxDiscord configuration.
/luxdiscord admin setup
Creates or updates a web dashboard admin account.
Example:
/luxdiscord admin setup cptrowan MySecurePass123!
๐ Permissions
luxdiscord.chat.server
luxdiscord.chat.discordreceive
luxdiscord.verification.link
luxdiscord.verification.bypass
luxdiscord.tickets.open
luxdiscord.admin.reload
luxdiscord.admin.setup
Example with LuckPerms
/lp group default permission set luxdiscord.chat.server true
๐ Web Dashboard
LuxDiscord includes a built-in web dashboard for managing your server.
Features include:
- Server status monitoring
- Ticket management
- Application management
- Moderation tools
- Shared theme and branding settings
Example address:
http://SERVER-IP:PORT/
๐ซ Ticket System
Features:
- Discord ticket panel
- Category-based tickets
- Staff claim / close buttons
- Web dashboard replies
Enable in config:
features.tickets.enabled: true
๐ Applications System
Players can apply for staff directly through Discord.
Workflow:
- User presses Apply button in Discord
- Receives a secure application link
- Completes the form on the website
- Staff review applications in the dashboard
๐ Account Linking Flow
- Player runs:
/link
-
Player receives verification code
-
Player runs in Discord:
/verify <code>
- Link stored in:
plugins/LuxDiscord/links.json
๐ Troubleshooting
Bot not sending messages
Check:
- Bot token
- Channel IDs
- Bot permissions
- Feature toggles
/verify works but player still restricted
Check verification enforcement settings:
features.verification.enforce-link.*
Application links incorrect
Set one of the following:
publicip
web.public-host
Web dashboard login fails
Run:
/luxdiscord admin setup
Login with:
- Username: your lowercase Minecraft name
- Password: the password you entered


