LuxDiscord

LuxDiscord connects your Minecraft Paper server with Discord using powerful tools like account linking, chat mirroring, support tickets, applications, and a built-in web dashboard.

if you need support join our discord https://discord.gg/CGFsDNh8KX



✨ Features

• 
  []Minecraft ↔ Discord chat mirror
  []Join and leave announcements in Discord
  []Secure player account linking
  []Optional enforcement for unlinked players
  []Discord staff moderation tools
  []Support ticket system
  []Application system with web form
  []Built-in web dashboard
  []Shared website branding and themes
  []Works with modern Paper servers

Compatibility

• 
  []Platform: Paper
  []Minecraft Version: 1.21+
• Java Version: 21+

⚙️ Installation

1. Download the plugin jar
   
   
2. Put it inside your server:

1. Start your server once
   
   
2. Edit the configuration:

1. Restart your server or run:

Discord Bot Setup

1. Create a bot in the Discord Developer Portal
   
   
2. Add your bot token to the config

1. Enable these intents:

• 
  []Message Content Intent
  []Server Members Intent

1. Invite the bot with scopes:

1. Give the bot permissions:

• 
  []View Channels
  []Send Messages
  []Read Message History
  []Embed Links
• Use Slash Commands

Quick Setup

Minimum config:

Then run:


⌨ Commands

/link
Starts Discord account linking and gives a one-time verification code.

/ticket [category]
Opens a support ticket.

/luxdiscord reload
Reloads the plugin configuration.

/luxdiscord admin setup
Creates or updates a web dashboard admin account.


Permissions

Example using LuckPerms:


Web Dashboard

LuxDiscord includes a built-in web dashboard with:

• 
  []Server status
  []Moderation tools
  []Ticket management
  []Application management
• Global theme and branding

Example dashboard address:


Ticket System

Features:

• 
  []Discord ticket panel
  []Category based tickets
  []Staff claim / close buttons
  []Web dashboard replies

Enable in config:

Applications System

Players can apply for staff directly through Discord.

Flow:

• 
  []User presses apply button in Discord
  []Receives secure application link
  []Submits form on web page
  []Staff approve or reject in dashboard

Account Linking Flow

1. Player runs

1. Player receives a code
   
   
2. Player runs in Discord:

1. Account link stored in:

Troubleshooting

Bot not sending messages

Check:

• 
  []Bot token
  []Channel IDs
  []Bot permissions
  []Feature toggles

Application links incorrect

Set one of:

Web dashboard login fails

Run again:

Make sure to login using your lowercase Minecraft username.

LuxDiscord makes managing your Minecraft community easier by connecting Discord, Minecraft, and your web dashboard in one powerful plugin.