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.

[HR][/HR]

✨ 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

[HR][/HR]

Compatibility

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

[HR][/HR]

⚙️ 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:
   

[HR][/HR]

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

[HR][/HR]

Quick Setup

Minimum config:

Then run:

[HR][/HR]

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

[HR][/HR]

Permissions

Example using LuckPerms:

[HR][/HR]

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:

[HR][/HR]

Ticket System

Features:

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

Enable in config:

[HR][/HR]

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

[HR][/HR]

Account Linking Flow

1. Player runs
   

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

1. Account link stored in:
   

[HR][/HR]

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.

[HR][/HR]

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