DiscordLogger

插件

· 作者 LVCHLAN

Minecraft 插件,通过 Webhook 将服务器事件记录到 Discord

0 本站下载 0 关注 更新于 2 周前

最新 2.6.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

DiscordLogger

将 Minecraft 服务器中发生的事件发布到 Discord 频道,格式为整洁的嵌入卡片或纯文本。只需一个 Webhook URL,无需托管机器人,无需 OAuth,也无需控制面板。

适用于 CraftBukkit、Spigot、Paper 及其分支,支持从 Minecraft 1.8 到 26.3 的版本——一个 JAR 文件兼容所有版本。


如何呈现

带有每事件颜色、玩家头像和可配置作者行的丰富嵌入卡片——或者如果你希望频道保持安静,也可以使用纯 Markdown 文本。

细节丰富的事件会拥有独立的字段。死亡事件会显示原因,基于服务器端伤害上下文构建,以便 Java 版和基岩版玩家阅读一致,并可选择性地显示地点。封禁事件会显示执行者、原因以及持续时间。


记录内容

玩家 —— 加入、离开、聊天、命令、死亡、进度、传送、游戏模式变更。

服务器 —— 控制台命令、启动、停止、爆炸——每次爆炸都会保存在一个可搜索的日志中,你可以在游戏中查询它。

管理 —— 封禁、解封、踢出、赋予管理员权限、移除管理员权限、白名单变更。

其他任何内容 —— 你可以从服务器上的任意命令创建自定义事件。Essentials 的家坐标、LuckPerms 的权限组变更、商店购买:只要是由命令触发的行为,你都可以记录它,并为其指定标题、颜色和 Webhook。

上述每种事件都是独立的开关,拥有自己的颜色,并且可以路由到各自的 Webhook——因此管理信息可以发送到仅限员工查看的频道,而聊天信息则发送到公开频道。


为什么你可能选择这个插件

你可以询问是什么炸毁了某个区域。 每次爆炸也会记录到一个纯文本 explosions.csv 文件中,并且 /discordlogger lookup 命令按位置而非时间进行搜索——站在坑里运行该命令,即可获取最近的爆炸事件及其原因、发生时间、规模大小以及二十格范围内的玩家。记录保留的时间由你决定,从几分钟到几年不等。

它会确认事情是否真正发生。 封禁记录是在封禁列表变更后生成的,而不是当有人输入 /ban 时生成。如果命令失败或被其他插件取消,不会产生声称其成功的消息。

它知道不该记录什么。 /login、/register 和 /msg 默认会被过滤,因为记录这些操作会将密码和私人消息发布到你的频道。共有十五种过滤器覆盖其余情况:忽略特定玩家、世界、命令、死亡原因、爆炸来源、短聊天、短传送等。

每条字符串都属于你。 lang.yml 包含了插件发送的所有消息。你可以重新措辞、翻译或精简它们——包括所有三十种死亡原因的描述。

它尊重隐身状态。 被 EssentialsX、SuperVanish、PremiumVanish 或 CMI 隐藏的员工依然保持隐藏。管理功能故意排除此项:如果因为某人隐身就隐藏封禁记录,会在关键时刻破坏审计追踪。

处理了基岩版玩家。 支持与 Geyser 和 Floodgate 配合使用,来自基岩版的加入可以被标记为此类。


设置

  1. 将 JAR 文件放入 plugins/ 目录并启动服务器。
  2. 在 Discord 中:频道设置 → 集成 → Webhooks → 新建 Webhook,然后复制 URL。
  3. 在控制台中运行 /discordlogger webhook <url>,或将其粘贴到 config.yml 中。

这就是全部设置。还有一个 配置生成器,可以在浏览器中构建完整的 config.yml,如果你更喜欢点击而不是编辑 YAML 的话。

你的 Webhook URL 是一个凭证。 任何持有它的人都可以以你的服务器名义向该频道发布消息。插件永远不会回显它,在命令日志中对其进行脱敏处理,并在 Tab 补全中将其隐藏。


要求

服务器 CraftBukkit、Spigot、Paper 或其分支 —— 1.8 到 26.3
Java 8 或更高版本
Discord 一个 Webhook URL。无需机器人、令牌或托管服务

某些功能需要具有底层特性的服务器版本:成就(advancements)在 1.12 之前作为成就(achievements)记录,方块爆炸需要 1.8.3 版本。插件会在启动时进行检查,并告知哪些功能你的服务器无法提供,而不是静默失败。


隐私

匿名使用情况数据会发送至 bStats:包括服务器软件、版本、启用了哪些事件以及发送是否成功。绝不会发送 Webhook URL、玩家名称、UUID、IP 地址、消息内容、坐标或世界名称。计数以范围形式报告而非精确数字,因此图表不会成为指纹标识。可以在 plugins/bStats/config.yml 中关闭此功能。


链接

免费且开源,采用 MIT 许可证。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源