XDiscordUltimate
适用于 Minecraft 服务器的最全面的 Discord 集成插件。具备现代斜杠命令、聊天桥接、验证系统、工单、管理等功能,以及更多特性。
1.2.0 更新内容
/unlink命令 — 玩家可以解除其 Discord 账号关联;管理员可通过/xdiscord unlink <player>解除任何玩家的关联(移除 Discord 角色、LuckPerms 组及数据库链接)。- 加固的验证码 — 采用
SecureRandom生成,支持配置失败尝试冷却时间 + 最大尝试次数锁定,并统一验证码过期时间(code-expiry-minutes配置项现在被精确执行)。 - 修复配置/代码默认值不匹配问题 —
one-time-only、kick-after-minutes和verify-cooldown-seconds现在与config.yml保持一致。 - 修复消息/本地化系统中的
ConcurrentModificationException— 该异常可能在玩家发送第一条本地化消息时抛出。 - Discord 昵称重新同步 — 当已关联成员的 Discord 昵称更改时,存储的名称会保持最新。
功能
- 聊天桥接 - Minecraft 与 Discord 之间无缝的聊天同步
- 验证系统 - 使用验证码的安全账号关联,支持自我/管理员解绑、暴力破解锁定及 Discord 昵称同步
- 支持工单 - 完整的工单系统,集成 Discord
- 玩家统计 - 追踪并显示玩家统计数据
- 服务器状态 - Discord 中自动更新的服务器状态嵌入卡片
- 管理 - 封禁同步、聊天过滤及举报系统
- 管理控制台 - 从 Discord 执行服务器命令
- 公告 - 向 Discord 和 Minecraft 广播
- Boost 奖励 - 奖励 Discord 服务器 Boosters
- 管理员警报 - 服务器健康监控
- 服务器日志 - 将所有事件记录到 Discord
快速开始
- 下载最新版本
- 放入
plugins文件夹 - 启动服务器以生成配置文件
- 在
config.yml中配置你的机器人令牌 (Bot Token) 和公会 ID (Guild ID) - 重启服务器
discord:
bot-token: "YOUR_BOT_TOKEN"
guild-id: "YOUR_GUILD_ID"
channels:
chat: "CHANNEL_ID"
logs: "CHANNEL_ID"
文档
入门指南
初次使用 XDiscordUltimate? 从这里开始:
| 指南 | 描述 |
|---|---|
| 入门指南 | 从零开始的逐步设置教程 |
| 安装指南 | 快速安装参考 |
核心文档
| 文档 | 描述 |
|---|---|
| 安装指南 | 完整的设置说明 |
| 配置指南 | 所有配置选项 |
| 命令参考 | 所有命令及权限 |
| 功能指南 | 详细的功能解释 |
| 权限参考 | 所有权限节点 |
| 故障排除 | 常见问题及解决方案 |
| 消息配置 | 自定义所有消息 |
| 开发者 API | 供开发者使用的 API |
| 数据库参考 | 数据库架构及配置 |
模块文档
| 模块 | 描述 |
|---|---|
| 聊天桥接 | Minecraft-Discord 聊天同步 |
| 验证 | 账号关联系统 |
| 服务器日志 | 事件记录到 Discord |
| 管理员警报 | 服务器健康监控 |
| 工单 | 支持工单系统 |
| 管理 | 封禁同步、过滤、举报 |
| 服务器控制 | 远程服务器管理 |
| 玩家统计 | 统计数据追踪 |
| 服务器状态 | 自动更新的服务器状态嵌入卡片 |
| Boost 奖励 | Discord Booster 奖励 |
| 机器人控制台 | Discord 控制台访问 |
| 公告 | 跨平台广播 |
| 模块管理器 | 管理模块 |
命令
玩家命令
| 命令 | 描述 |
|---|---|
/verify <code> |
关联你的 Discord 账号 |
/unlink |
解除你的 Discord 账号关联 |
/support <message> |
创建支持工单 |
/report <player> <reason> |
举报一名玩家 |
/stats [player] |
查看玩家统计数据 |
/help |
打开帮助菜单 |
管理员命令
| 命令 | 描述 |
|---|---|
/xdiscord reload |
重新加载配置 |
/xdiscord status |
显示插件状态 |
/xdiscord modules |
列出所有模块 |
/xdiscord unlink <player> |
将玩家从 Discord 解绑 |
/announce <message> |
发布公告 |
Discord 斜杠命令
| 命令 | 描述 |
|---|---|
/verify |
获取验证码 |
/status |
显示服务器状态 |
/players |
列出在线玩家 |
/stats [player] |
查看玩家统计数据 |
/console <command> |
执行服务器命令 |
权限
| 权限 | 描述 | 默认值 |
|---|---|---|
xdiscord.verify |
使用验证 | true |
xdiscord.unlink |
解除自己的账号关联 | true |
xdiscord.support |
创建工单 | true |
xdiscord.report |
举报玩家 | true |
xdiscord.admin |
管理员命令 | op |
xdiscord.console |
控制台访问 | false |
xdiscord.announce |
发布公告 | op |
xdiscord.bypass.verification |
绕过验证 | false |
xdiscord.bypass.filter |
绕过聊天过滤 | false |
要求
- Minecraft 服务器: Spigot/Paper 1.16.5 – 1.21.x (最新版)
- Java: 17 或更高版本
- Discord 机器人: 需启用
MESSAGE_CONTENT意图
可选依赖项
- LuckPerms - 用于权限组管理
- PlaceholderAPI - 用于占位符
- Vault - 用于经济系统(未来功能)
配置示例
# 管理员 Discord ID
adminIDs:
- "123456789012345678"
# 启用功能
features:
chat-bridge:
enabled: true
chat-channel-id: "1234567890"
minecraft-to-discord: true
discord-to-minecraft: true
verification:
enabled: true
verified-role: "Verified"
code-expiry-minutes: 5
server-logging:
enabled: true
logs-channel-id: "1234567890"
log-join-leave: true
log-commands: true
tickets:
enabled: true
auto-close-hours: 48
save-transcript: true
player-stats:
enabled: true
server-status:
enabled: true
channel-id: "1234567890"
update-interval: 60
moderation:
enabled: true
sync-bans: true
auto-moderate: true
admin-alerts:
enabled: true
tps-threshold: 15.0
ram-threshold: 90
booster-perks:
enabled: true
permission-group: "booster"
# Discord 设置
discord:
bot-token: "YOUR_TOKEN"
guild-id: "YOUR_GUILD_ID"
channels:
chat: ""
logs: ""
tickets: ""
moderation: ""
# 数据库
database:
type: "sqlite"
支持
- 问题反馈: GitHub Issues
- Discord: 加入我们的 Discord
许可证
本项目采用 MIT 许可证授权 - 详情请参阅 LICENSE 文件。
由 XreatLabs 用 ❤️ 制作
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
可自定义玩家模型
tom5454
自定义你的Minecraft头像!
装饰社交
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧