LuxDiscord
LuxDiscord 通过强大的工具(如账号绑定、聊天镜像、支持工单、申请系统以及内置的网页仪表板)将你的 Minecraft 服务器与 Discord 连接起来。
非常适合希望 Discord 和 Minecraft 完全整合 的社区。
✨ 功能特性
- ? Minecraft ↔ Discord 聊天镜像
- ? 加入/离开公告 发送至 Discord
- ? 安全的账号绑定 (
/link + /verify)
- ? 可选的 验证强制功能
- ? Discord 管理工具
- ? 带有 Discord 面板的 工单系统
- ? 带有网页表单的 申请系统
- ? 用于管理的 网页仪表板
- ? 共享网站主题与品牌标识
- ⚡ 专为 现代 Paper 服务器 打造
? 兼容性
| 组件 |
要求 |
| 平台 |
Paper |
| Minecraft |
1.21+ |
| Java |
21+ |
⚙ 安装方法
- 下载插件 jar 文件
- 将其放入你的服务器目录:
plugins/
-
启动一次你的服务器
-
编辑配置文件:
plugins/LuxDiscord/config.yml
- 重启服务器或运行以下命令:
/luxdiscord reload
? Discord 机器人设置
-
在 Discord Developer Portal(开发者门户)中创建一个机器人
-
将你的机器人令牌添加到配置文件中:
discord.token: "YOUR_TOKEN"
- 启用以下 特权意图 (Privileged Intents):
- 消息内容意图 (Message Content Intent)
- 服务器成员意图 (Server Members Intent)
- 使用以下作用域邀请该机器人:
bot
applications.commands
- 赋予该机器人以下权限:
- 查看频道
- 发送消息
- 读取消息历史
- 嵌入链接
- 使用斜杠命令
? 快速设置
所需的最小配置如下:
discord:
enabled: true
token: "YOUR_TOKEN"
channels:
chat: "CHANNEL_ID"
然后重新加载插件:
/luxdiscord reload
⌨ 命令
/link
开始 Discord 账号绑定并生成一次性验证码。
/ticket [category]
打开一个支持工单。
/luxdiscord reload
重新加载 LuxDiscord 配置。
/luxdiscord admin setup
创建或更新 网页仪表板管理员账户。
示例:
/luxdiscord admin setup cptrowan MySecurePass123!
? 权限节点
luxdiscord.chat.server
luxdiscord.chat.discordreceive
luxdiscord.verification.link
luxdiscord.verification.bypass
luxdiscord.tickets.open
luxdiscord.admin.reload
luxdiscord.admin.setup
LuckPerms 示例
/lp group default permission set luxdiscord.chat.server true
? 网页仪表板
LuxDiscord 包含一个 内置的网页仪表板,用于管理你的服务器。
功能包括:
- 服务器状态监控
- 工单管理
- 申请管理
- 管理工具
- 共享主题和品牌设置
示例地址:
http://SERVER-IP:PORT/
? 工单系统
功能特性:
- Discord 工单面板
- 基于分类的工单
- 工作人员认领/关闭按钮
- 网页仪表板回复
在配置中启用:
features.tickets.enabled: true
? 申请系统
玩家可以直接通过 Discord 申请成为工作人员。
工作流程:
- 用户在 Discord 中按下 Apply 按钮
- 收到安全的申请链接
- 在网站完成表单填写
- 工作人员在仪表板中审核申请
? 账号绑定流程
- 玩家执行命令:
/link
-
玩家收到验证码
-
玩家在 Discord 中执行命令:
/verify <code>
- 绑定信息存储在:
plugins/LuxDiscord/links.json
? 故障排除
机器人未发送消息
请检查:
- 机器人令牌 (Bot token)
- 频道 ID
- 机器人权限
- 功能开关
/verify 生效但玩家仍受限
请检查验证强制设置:
features.verification.enforce-link.*
申请链接不正确
请设置以下任一选项:
publicip
web.public-host
网页仪表板登录失败
运行以下命令:
/luxdiscord admin setup
使用以下凭据登录:
- 用户名: 你小写的 Minecraft 用户名
- 密码: 你输入的密码
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
- Download the plugin jar
- Place it in your server:
plugins/
-
Start your server once
-
Edit the config file:
plugins/LuxDiscord/config.yml
- Restart the server or run:
/luxdiscord reload
? Discord Bot Setup
-
Create a bot in the Discord Developer Portal
-
Add your bot token to the config:
discord.token: "YOUR_TOKEN"
- Enable these privileged intents:
- Message Content Intent
- Server Members Intent
- Invite the bot with scopes:
bot
applications.commands
- 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:
- User presses Apply button in Discord
- Receives a secure application link
- Completes the form on the website
- Staff review applications in the dashboard
? Account Linking Flow
- Player runs:
/link
-
Player receives verification code
-
Player runs in Discord:
/verify <code>
- 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
评论 0
登录后参与评分
还没有评论,来抢沙发吧