LuxDiscord

LuxDiscord

Discord connects your Discord 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

* 🔁 modern Paper servers * 👋 modern Paper servers in Discord * 🔗 modern Paper servers (`/link` + `/verify`) * 🚫 Optional modern Paper servers * 🛠 modern Paper servers * 🎫 modern Paper servers with Discord panels * 📝 modern Paper servers with web form * 🌐 modern Paper servers for management * 🎨 modern Paper servers * ⚡ 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/ ```

3. Start your server once

4. Edit the config file:

``` plugins/LuxDiscord/config.yml ```

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

```yaml discord.token: "YOUR_TOKEN" ```

3. Enable these privileged intents:

* Message Content Intent * Server Members Intent

4. Invite the bot with scopes:

``` bot applications.commands ```

5. Give the bot these permissions:

* View Channels * Send Messages * Read Message History * Embed Links * Use Slash Commands

---

🚀 Quick Setup

Minimum config required:

```yaml 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:

```yaml 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 ```

2. Player receives verification code

3. Player runs in Discord:

``` /verify <code> ```

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

* Password: your lowercase Minecraft name * Password: the password you entered