Logo
LuxDiscord
PluginLicenseRef-All-Rights-Reserved

LuxDiscord

A modern and new way to link Discord and Minecraft

28
Downloads
0
Followers
3 months ago
Updated
📦
2
Versions
utilitypaperpurpurspigot
Download Latestv1.0-SNAPSHO1.0.3TView on Modrinth

📖About LuxDiscord

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