ZDiscord 将 Minecraft 与 Discord 直接连接。玩家可以在两个平台间聊天、查看在线状态、绑定账号、开启工单,并查看个人资料或排行榜。工作人员利用相同的连接来接收控制台日志、警报以及进行私密的工作人员聊天。
如何融入你的服务器
命令使用原生的 Discord 斜杠命令、按钮和选择菜单。一个 JAR 文件即可在 Paper、Folia 和 Spigot 上运行。你可以在配置中切换各个模块的开关。
功能特性
- 聊天桥接:支持双向聊天,具备回复上下文和 Webhook 头像。支持与 SkinsRestorer 配合,并提供 Java 版与基岩版的回退方案。
- 服务器状态:通过更新的 Discord 消息显示玩家数量、TPS(每秒刻数)和内存使用情况。
- 实时统计:综合面板展示在线玩家、服务器性能及当前排名领先者。
- 控制台流式传输:将服务器控制台日志转发至 Discord 频道。
- 账号绑定:通过一次性代码绑定 Discord 和 Minecraft 账号,可选启用“绑定后方可加入”的限制。
- 工作人员聊天:
/sc命令可切换至一个桥接到 Discord 的仅限工作人员使用的频道。 - 工单系统:玩家可通过 Discord 按钮或
/ticket命令开启私密的客服支持频道。 - 排行榜:追踪击杀数、死亡数和游戏时长,支持分页、统计项切换和定时刷新。
- 事件消息:将加入、退出、死亡和进度达成等事件发布到 Discord。
- 性能监控器:随时间追踪 TPS 和内存使用情况,并支持可配置的警报。
- 反突袭保护:检测大规模加入行为,并在需要时触发自动锁定机制。
- 命令记录器:将受监视和关键命令的记录发送至工作人员频道。
- 语音状态:当绑定的玩家加入 Discord 语音频道时,显示标签页列表指示器。
- 反应角色:将消息的反应映射到 Discord 角色和游戏内权限。
- 玩家个人资料:
/profile [player]显示包含玩家头像、NameMC 链接、统计数据及关注按钮的内嵌卡片。 - 关注系统:当被关注的玩家上线时获取私信通知。使用
/following和/unfollow管理订阅关系。 - 匿名告白:
/confess将内容发布到指定频道,支持冷却时间和自定义内嵌卡片。 - 设置向导:
/setup可直接从 Discord 配置频道和角色。 - 插件桥接:通过你现有的机器人连接转发 Onlysleep 和 RedstoneReboot 的消息。
要求
- Java 17 或更高版本
- Paper 1.20.4 或更高版本、Folia,或 Spigot 1.20.4 或更高版本
- 一个启用了 Server Members(服务器成员)和 Message Content(消息内容)意图的 Discord 机器人令牌
- 仅在使用可选的 MySQL 存储后端时需要 MySQL 8.0 或更高版本
安装步骤
- 从发布页面下载
ZDiscord-1.4.2.jar。 - 将 JAR 文件放入服务器的
plugins/目录中。 - 启动服务器以生成默认的
config.yml和messages.yml。 - 打开
plugins/ZDiscord/config.yml并设置你的机器人令牌和 Discord 服务器 ID。 - 重启服务器。
- 在 Discord 中运行
/setup以选择频道和角色。
配置
所有设置均位于 plugins/ZDiscord/config.yml 中。面向用户的 Minecraft 文本位于 messages.yml 中。YAML 存储无需数据库即可工作;当你需要共享或更大规模的存储时,可以使用 MySQL。
ZDiscord connects Minecraft and Discord directly. Players chat across both platforms, check who is online, link accounts, open tickets, and view profiles or leaderboards. Staff use the same connection for console logs, alerts, and private staff chat.
How it fits your server
Commands use native Discord slash commands, buttons, and selection menus. One JAR runs on Paper, Folia, and Spigot. You can toggle each module in the configuration.
Features
- Chat bridge: Two-way chat with reply context and webhook avatars. Supports SkinsRestorer with Java and Bedrock fallbacks.
- Server status: An updating Discord message showing player count, TPS, and memory usage.
- Live stats: Combined panel showing online players, server performance, and current leaders.
- Console streaming: Forwards server console logs to a Discord channel.
- Account linking: One-time codes link Discord and Minecraft accounts, with optional link-to-join enforcement.
- Staff chat:
/sctoggles a staff-only channel bridged to Discord. - Tickets: Players open private support channels from Discord buttons or
/ticket. - Leaderboards: Track kills, deaths, and playtime with paging, stat switching, and timed refreshes.
- Event messages: Posts joins, quits, deaths, and advancements to Discord.
- Performance monitor: Tracks TPS and memory over time with configurable alerts.
- Anti-raid: Detects mass joins and triggers automated lockdown when needed.
- Command logger: Logs watched and critical commands to a staff channel.
- Voice status: Shows a tab-list indicator when linked players join a Discord voice channel.
- Reaction roles: Maps message reactions to Discord roles and in-game permissions.
- Player profiles:
/profile [player]shows an embed with the player avatar, NameMC link, stats, and a follow button. - Follow system: Get DM notifications when followed players join. Manage subscriptions with
/followingand/unfollow. - Anonymous confessions:
/confessposts to a designated channel with cooldowns and customizable embeds. - Setup wizard:
/setupconfigures channels and roles directly from Discord. - Plugin bridges: Forwards Onlysleep and RedstoneReboot messages through your existing bot connection.
Requirements
- Java 17 or newer
- Paper 1.20.4 or newer, Folia, or Spigot 1.20.4 or newer
- A Discord bot token with Server Members and Message Content intents enabled
- MySQL 8.0 or newer only when using the optional MySQL storage backend
Installation
- Download
ZDiscord-1.4.2.jarfrom the releases page. - Place the JAR in your server's
plugins/directory. - Start the server to generate the default
config.ymlandmessages.yml. - Open
plugins/ZDiscord/config.ymland set your bot token and Discord server ID. - Restart the server.
- Run
/setupin Discord to choose channels and roles.
Configuration
All settings live in plugins/ZDiscord/config.yml. User-facing Minecraft text is in messages.yml. YAML storage works without a database; MySQL is available when you need shared or larger-scale storage.
下载 ZDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ZDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ZDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ZDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ZDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ZDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ZDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ZDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
新增
- 万圣节季节活动 一个可配置的季节性怪物狩猎活动,支持自定义时间窗口(
halloween.window-start/halloween.window-end)、击杀追踪、积分计分以及最终奖励。PvP 击杀不计入。 - 游戏内
/zdiscord halloween [status|top]显示活动时间、个人积分和排名,默认玩家权限为zdiscord.halloween。 - Discord
/halloween斜杠命令显示活动状态、排名和倒计时。 - 在活动开启前,Discord 和 Minecraft 中每日发送倒计时公告。
- 活动期间自动更新的实时排名嵌入面板。
- 当玩家达到配置的积分阈值时发布里程碑公告,并对龙、凋灵和远古守卫者提供倍率加成。
- 可配置的活动时区、适用世界和怪物类型、排除的游戏模式以及刷怪笼怪物过滤。
- 可选的万圣节加入标题、环境音效和里程碑粒子效果,拥有独立的外观控制(装饰性内容需明确选择加入)。
- 开启公告和公开 Minecraft 广播拥有独立的开关。
- 自动关闭不活跃的工单、持久化的专属员工认领,以及包含时间顺序附件和嵌入记录的完整分页转录本。
更改
- 配置架构版本升级至 16;现有设置得以保留,同时生成新的默认值。
- 启动横幅现在统计 17 个模块,包括季节活动。
- 万圣节消息和显示使用简洁文本、橙色强调色和编号排名;所有游戏内文本均可通过
messages.yml自定义。 - 季节进度以积分描述以反映 Boss 加成;Discord 排名限制显示前 25 名。
- 移除了空的内部生命周期钩子、未使用的消息模板和状态字段、过时的工单计数写入以及装饰性 Emoji。
修复
- 设置下拉菜单和模态框检查配置服务器中的管理员权限;类别 ID、颜色和限制均经过验证。
- 重载操作会注销命令日志监听器,取消控制台和锁定计时器,并同步公共 API 设置。
- 关闭时会先排空 Discord 回调,再关闭存储,并防止延迟的重连尝试。
- Paper 员工聊天切换中继每条消息一次,命名空间敏感命令会脱敏参数,且当聊天频道未设置时 Discord 控制台仍可正常工作。
- 阴影打包的 SLF4J 提供者通过插件类加载器被发现,关闭日志抑制可恢复正常的库日志记录。
- 文本转换正确保留字面量 Ampersand (&) 并剥离十六进制颜色代码。斜杠个人资料、已见和关注标题遵循消息设置;更新检查避免重复通知并容忍过大的版本号。
- 工单控件验证配置的服务器和跟踪频道;失败的交互确认或删除请求会释放关闭守卫以便重试。
- 必需的账号链接在被拒绝的登录消息中提供验证码。每个 Minecraft 账号只有一个待处理的验证码,重新链接保持两个账号方向一致。
- 并发游戏时长刷新在每次间隔仅认领一次,保留小数秒。排行榜更新按接受更改的相同顺序持久化。
- 存储的关注关系在玩家加入前即可用;重载和公共关注者 API 保留已接受的缓冲写入。
- 配置重载和 Discord 设置同步启用模块、刷新频道设置并替换重复的面板计时器。本地链接和统计信息也可在没有 Discord 的情况下初始化。
- Discord 面板序列化创建过程,忽略过期的回调,并且仅在 Discord 确认删除后才替换消息。
- 工单交互在频道创建前延迟处理。原子预留强制执行关联账号限制,私有频道明确授予机器人访问权限,且槽位仅在确认删除后释放。
- MySQL 模式失败时关闭连接池并选择 YAML 回退,而不是报告数据库正常工作。
- Discord REST/回调工作者在 Paper 关闭插件类加载器之前排空。禁用插件的数据库清理避免被拒绝的计划任务,且并发工单欢迎消息显示各自的工单号。
- 链接/关注事件线程与调用者匹配。加入/关注者数据库查找脱离游戏线程运行,延迟欢迎消息使用玩家调度器。
- 更新通知使用 Spigot 兼容的可点击组件。成就嵌入使用显示标题,退出嵌入显示正确的在线玩家数量。
- Discord 附件使用 Spigot 组件 API 携带可点击的 Minecraft URL。
- 即使没有连接的 Discord 机器人,Minecraft 季节计分和命令仍然可用。
- 创造模式、旁观者模式、被动怪物和刷怪笼击杀默认不计入狩猎。
- 实际的怪物死亡和 Boss 加成计入狩猎,包括由多点击杀跨越的里程碑。
- 活动重载退役旧的面板循环,保留进行中的面板创建,并在主开关 across 保留分数和奖励认领。
- 延迟和离线终局检查恢复记录的事件,且获胜者奖励仅应用于第一名。
- MySQL 写入顺序防止过期的分数写入覆盖较新的值;关闭时排空待处理的写入后再关闭连接池。
安装
下载下方的 JAR 文件并将其放入服务器的 plugins/ 文件夹中。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧