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

1. Download the plugin jar
2. Place it in your server:

plugins/

1. Start your server once

2. Edit the config file:

plugins/LuxDiscord/config.yml

1. Restart the server or run:

/luxdiscord reload

---

🤖 Discord Bot Setup

1. Create a bot in the Discord Developer Portal

2. Add your bot token to the config:

discord.token: "YOUR_TOKEN"

1. Enable these privileged intents:

• Message Content Intent
• Server Members Intent

1. Invite the bot with scopes:

bot
applications.commands

1. 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:

1. User presses Apply button in Discord
2. Receives a secure application link
3. Completes the form on the website
4. Staff review applications in the dashboard

---

🔗 Account Linking Flow

1. Player runs:

/link

1. Player receives verification code

2. Player runs in Discord:

/verify <code>

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