ConsoleDiscord
ConsoleDiscord 将你的 Minecraft 服务器控制台与 Discord 连接起来。
- 将服务器日志镜像到 Discord 的文本频道中。
- 允许你通过
/mc(斜杠命令)或!mc(文本命令)从 Discord 运行控制台命令。
如果你希望在不每次打开服务器控制器的情况下监控和管理服务器,这是理想之选。
功能特性
-
? 日志流传输
将服务器日志发送到可配置的 Discord 频道。 -
? 来自 Discord 的命令
直接从 Discord 执行控制台命令:- 斜杠命令
/mc - 可选的特定频道文本命令
!mc
- 斜杠命令
-
? 访问控制
限制对特定 Discord 用户 ID 和/或单个命令频道的访问权限。 -
⚙️ 可配置的日志间隔
log-flush-ticks控制缓冲的日志行发送频率。 -
? 调试日志记录
可选的 JDA 状态更改调试日志记录(debug-status-logging)。 -
? 无需重启即可重载
/cdr reload重新加载配置并在需要时重新连接到 Discord。
需求
- 服务器: Paper / 兼容 Bukkit 的服务器
- Minecraft: 1.21.x (api-version:
1.21) - Java: 21
- Discord: 你自己的机器人
- 机器人令牌 (Bot token)
- 权限包括:
- 读取和发送日志/命令频道中的消息
- 使用斜杠命令(用于启用时的
/mc)
安装
-
放入 jar 文件
将ConsoleDiscord-1.0.0.jar放入服务器的plugins/文件夹中。 -
启动服务器
首次启动时,插件将在其文件夹中创建一个config.yml文件。 -
编辑配置文件 (
plugins/ConsoleDiscord/config.yml)bot-token: "YOUR_DISCORD_BOT_TOKEN" # 服务器日志的文本频道 log-channel-id: "123456789012345678" # 可选:允许使用 /mc 和 !mc 的频道 command-channel-id: "" # 谁被允许使用 /mc 和 !mc(用户 ID)。 # 如果为空,则允许所有人。 allowed-user-ids: - "123456789012345678" # 缓冲的日志消息多久刷新一次发送到 Discord(以刻为单位) log-flush-ticks: 40 # 将 JDA 状态更改(连接、断开等)记录到服务器日志中 debug-status-logging: false
ConsoleDiscord
ConsoleDiscord connects your Minecraft server console with Discord.
- Mirrors your server log into a Discord text channel.
- Lets you run console commands from Discord via
/mc(slash command) or!mc(text command).
Perfect if you want to monitor and administer your server from Discord without opening the server console every time.
Features
-
🔁 Log streaming
Sends your server log to a configurable Discord channel. -
💬 Commands from Discord
Execute console commands directly from Discord:- Slash command
/mc - Optional text command
!mcin a specific channel
- Slash command
-
🔐 Access control
Limit access to specific Discord user IDs and/or to a single command channel. -
⚙️ Configurable log interval
log-flush-tickscontrols how often buffered log lines are sent to Discord. -
🧪 Debug logging
Optional debug logging for JDA status changes (debug-status-logging). -
🔄 Reload without restart
/cdr reloadreloads the config and reconnects to Discord if needed.
Requirements
- Server: Paper / Bukkit-compatible server
- Minecraft: 1.21.x (api-version:
1.21) - Java: 21
- Discord: Your own bot
- Bot token
- Permissions to:
- Read and send messages in the log/command channels
- Use slash commands (for
/mc, if enabled)
Installation
-
Drop the jar
PutConsoleDiscord-1.0.0.jarinto your server’splugins/folder. -
Start the server
On first startup, the plugin will create aconfig.ymlfile in its folder. -
Edit the config (
plugins/ConsoleDiscord/config.yml)bot-token: "YOUR_DISCORD_BOT_TOKEN" # Text channel for server logs log-channel-id: "123456789012345678" # Optional: channel where /mc and !mc may be used command-channel-id: "" # Who is allowed to use /mc and !mc (user IDs). # If empty, everyone is allowed. allowed-user-ids: - "123456789012345678" # How often (in ticks) buffered log messages are flushed to Discord log-flush-ticks: 40 # Log JDA status changes (connect, disconnect, etc.) to the server log debug-status-logging: false
下载 ConsoleDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ConsoleDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ConsoleDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ConsoleDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ConsoleDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ConsoleDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ConsoleDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ConsoleDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ConsoleDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ConsoleDiscord
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
[2.2.0] - 2026-11-08 — 安全与稳定性更新
安全性
- 可选的白名单模式(
command-security.mode: allowlist,allowed-commands)。 - 按角色和用户设置可选的命令列表(
command-permissions),同样适用于嵌套命令和别名。 commands.yml中的别名会被展开并检查,包括$1-透传别名。/mc默认仅对管理员可见(slash-command-admin-only)。- 被拒绝的操作尝试最多每分钟每个用户记录 3 次写入审计日志,以防止垃圾信息将真实条目挤掉。
- 审计日志保留编号备份(
command-audit.max-backups,默认值为 5),而非单个.old文件。
新增
- 可选的公开
/mc结果(command-feedback.public-replies,默认关闭)。
修复
- 日志级别和忽略模式在缓冲之前应用,因此过滤后的行不再在日志洪峰期间挤出真实行。
- 默认配置中的示例 ID 被视为“未设置”(新安装时不再出现“无效频道”警告)。
- 缺少消息内容意图(错误 4014):机器人会在无此意图的情况下重新连接(日志记录和
/mc仍正常工作,!mc被禁用),并说明如何启用它;永久连接错误和被拒绝的机器人令牌不再导致每两分钟重启一次。 - 日志洪峰不再堆积在无限制的 Discord 请求队列中;丢失的行仅报告一次。
- 分类频道无需主日志频道即可工作;最后几行控制台输出会在关机时发送。
- 内存警报仅在 usage 持续超过阈值一分钟时才触发(避免因未回收的垃圾导致的误报)。
/cdr reload和服务端关闭不再等待 Discord 重连;启动通知不再被跳过。- 自动清理从上次停止的位置继续,而不是重复读取相同消息,同时清理分类频道,且不会同时运行两次。
- 自动补全不再因输入或别名名称超过 100 个字符而失败。
- URL 中的反引号不再破坏嵌入格式。
[2.1.1] - 2026-10-08 — 错误修复与兼容性更新
安全
- 黑名单现在还会检查服务器别名(
rl→reload)以及嵌套在execute … run/return run中的命令。 - 捆绑库日志(JDA)不再镜像到 Discord。
- 审计日志会对换行符进行转义,并记录被拒绝的尝试(不允许、被阻止、速率限制)。
!mc拒绝回复限制为每个用户每分钟一次;自动补全仅对允许的用户可用。- 机器人不再 @提及任何人;日志行中的屏蔽链接已被中和,命令输出无法逃逸出代码块。
已修复
- 嵌入日志模式重新识别日志级别(包含空格或斜杠的线程名之前会显示为 INFO)。
- 嵌入日志行始终显示完整的控制台行,包括时间戳(2.1.0 版对于单字线程名移除了时间戳)。
- 嵌入日志行按原文显示:Markdown(如
dark_oak_button)会被转义,Minecraft 颜色代码会被移除。 - 长条目(例如堆栈跟踪)会开启一个新的嵌入消息,而不是截断后续行。
- 性能警报和自动清理在自动重连 Discord 后仍能正常工作。
- 长命令不再破坏 Discord 审计嵌入或抑制命令回复。
/cdr reload不再阻塞主线程,同时等待旧的 Discord 连接或审计写入器关闭。- 当服务器的 log4j 配置记录
DEBUG/TRACE时,log-levels中的这些级别会被转发。 auto-cleanup中小于 1 的值会被钳制(0 天意味着每条机器人消息都删除,0 小时意味着每个 tick 都运行)。- 自动清理从截止点读取历史记录,因此繁忙频道(>1000 条新消息)也会被清理。
- 某个频道缺少权限只会暂停该频道的日志转发,而不会停止所有日志转发。
- 看门狗在其自身重连期间(5 分钟宽限期)或登录失败后不再重启 JDA。
- 如果 Discord 启动因异常失败,看门狗会重试启动(退避时间最长 2 分钟)。
- 在看门狗重启期间禁用插件,不再导致 Discord 连接残留运行。
- 代码块模式将长批次拆分为多条消息,而不是丢弃行。
- 删除的默认别名、类别和模式在重启后不再恢复。
- 重载时,命令别名和消息会原子性地交换(避免与 Discord 线程发生竞态条件)。
变更
- 针对 Minecraft 1.21.x 和 26.x 提供单一 jar 包(目标 Java 21,
api-version: '1.21')。 - 更新通知包含可点击的 Modrinth 和 CurseForge 链接,在游戏中通过
consolediscord.update权限(OP)查看,在 Discord 上每个版本仅显示一次,文本位于messages_*.yml中。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧