? MCSL — MineCraftServerLogs
快速捕获、分析并分享你的 Minecraft 服务器日志的最快方式。
MCSL 是一款轻量级的 Minecraft 服务器插件,为服务器管理员提供了一个单一命令,用于上传、解析、脱敏和分享服务器日志——全部由 HasteLog 提供支持,这是一款快速且免费的日志分享服务。不再需要复制粘贴巨大的日志文件到聊天框或 Discord。只需一条命令,你的日志就会实时发布在网页上,随时可以与技术支持人员、开发者或社区成员分享。
[17:34:12 INFO]: ──────────────────────────────────────────────────
[17:34:12 INFO]: MCSL — MineCraftServerLogs v1.0.0
[17:34:12 INFO]: Powered by https://logs.protectcord.com
[17:34:12 INFO]: ──────────────────────────────────────────────────
[17:34:12 INFO]: /mcsl upload [lines|all|errors] — 将 latest.log 上传至 HasteLog
[17:34:12 INFO]: /mcsl info — 打印服务器信息摘要
[17:34:12 INFO]: /mcsl errors [lines] — 在聊天中显示最近的错误
[17:34:12 INFO]: /mcsl players — 从日志中显示玩家事件
[17:34:12 INFO]: /mcsl plugins — 列出所有插件及状态
[17:34:12 INFO]: /mcsl share — 上传完整的诊断报告
[17:34:12 INFO]: /mcsl crash — 上传最新的崩溃报告
[17:34:12 INFO]: ──────────────────────────────────────────────────
? 此插件面向谁?
MCSL 专为花费时间在 Bukkit、Spigot、Paper、Purpur 或 Folia 服务器上排查问题的服务器管理员和开发者而构建。
| 如果你是... | MCSL 可以帮助你... |
|---|---|
| 拥有故障插件的服务器所有者 | 立即上传错误并将链接分享给插件的支持团队 |
| 正在调试自己插件的开发者 | 通过一个链接获取完整的诊断报告——版本、所有已加载的插件、错误、TPS |
| 管理多个服务器的网络管理员 | 在任何节点运行 /mcsl share,获得一个单一 URL 以比较不同服务器间的行为表现 |
| 帮助 Discord 中的支持志愿者 | 让用户运行 /mcsl upload errors,而不是粘贴 3,000 行日志 |
| 托管服务提供商 | 将 MCSL 包含在你的预装插件列表中——你的客户可以获得自助式诊断功能 |
✨ 功能特性
? 一键日志上传
使用一条命令即可将整个 latest.log——或仅最后 N 行,或仅错误部分——上传至 logs.protectcord.com。你会得到一个简短、可分享的 URL,可以直接在游戏内聊天框中点击访问。
? 智能日志解析
MCSL 会自动扫描你的日志并对其发现的内容进行分类:
- 错误与异常 — 完整的堆栈跟踪、
[ERROR]、[SEVERE]条目 - 警告 —
[WARN]和[WARNING]条目 - 插件事件 — 哪些插件启用、禁用或加载失败
- 玩家事件 — 加入、离开、踢出和封禁条目
- 崩溃信号 — Minecraft 崩溃报告头部和未处理的异常
? 隐私优先的脱敏处理
在任何数据离开你的服务器之前,MCSL 会清除敏感数据:
- IPv4 和 IPv6 地址 →
[REDACTED_IP] - JWT 令牌 →
[REDACTED_TOKEN] - API 密钥和 Bearer 令牌 →
[REDACTED_KEY] - JDBC/数据库密码 →
password=[REDACTED] - 你自定义的正则表达式模式(在
config.yml中定义)
所有脱敏操作均可配置,并且可以针对每个类别开启或关闭。玩家 IP 默认会被脱敏。
? 完整的服务器诊断报告
/mcsl share 生成一份丰富的结构化报告,包括:
- 服务器软件、版本和完整的构建字符串
- 所有已加载的插件及其版本和启用/禁用状态
- 所有已加载的模组(通过反射支持 Forge 1.12、Forge 1.13+ 以及 Fabric)
- 内存使用情况、TPS(1分钟/5分钟/15分钟)和服务器运行时间
- MOTD、游戏模式、难度、在线模式、最大玩家数
- 解析后的错误、警告和玩家事件
- 完整的日志尾部
? 自动崩溃检测
如果服务器意外崩溃,MCSL 的 JVM 关闭钩子会自动触发,上传最后 1,000 行日志以及解析后的错误摘要,并将 HasteLog URL 记录到控制台——即使 Bukkit 调度器不再运行。在线操作员会收到带有链接的游戏内通知。
⚡ 完全异步
每次上传都在主服务器线程之外运行。你的 TPS 绝不会因为日志上传而下降。
? 模组服务器支持
MCSL 检测并列出以下平台上的模组:
- Forge (1.12.x 通过
fml.common.Loader,1.13+ 通过fml.ModList) - Fabric (通过
net.fabricmc.loader.api.FabricLoader)
? 实际效果
/mcsl upload 500
[MCSL] Uploading last 500 lines to HasteLog...
[MCSL] Uploaded (last 500 lines) successfully!
[MCSL] View report: https://logs.protectcord.com/GvuuyVDqN2
该 URL 在游戏中是可点击的——点击它即可在浏览器中打开。
/mcsl info
──────────────────────────────────────────────────
服务器信息
──────────────────────────────────────────────────
Name: My Minecraft Server
Software: Paper 1.20.4
Version: git-Paper-388 (MC: 1.20.4)
Port: 25565
Online Mode: true
Gamemode: survival
Difficulty: normal
Max Players: 100
Online: 12 / 100
Memory: 已使用 1842MB / 最大 4096MB (已提交: 2048MB)
Uptime: 6小时 34分 12秒
TPS: 19.98 / 19.97 / 19.95 (1分钟/5分钟/15分钟)
Plugins: 32 个启用 / 33 个总计
──────────────────────────────────────────────────
/mcsl plugins
──────────────────────────────────────────────────
插件 — 32 个启用 / 33 个总计
──────────────────────────────────────────────────
[+] EssentialsX v2.20.1 by EssentialsX Team
[+] LuckPerms v5.4.108 by Luck
[+] Vault v1.7.3 by MilkBowl
[+] WorldEdit v7.3.1 by sk89q
[-] BrokenPlugin v1.0.0 by SomeAuthor
──────────────────────────────────────────────────
[+]= 已启用,[-]= 已禁用/加载失败
/mcsl errors
[MCSL] 在最近的 500 行日志中发现 3 个错误和 7 个警告。
[MCSL] 最近 3 个错误:
[ERROR] 无法加载文件夹 'plugins' 中的 'plugins/BrokenPlugin.jar'
org.bukkit.plugin.InvalidDescriptionException: Invalid plugin.yml
[ERROR] 启用 BrokenPlugin v1.0.0 时发生错误(是否已是最新版本?)
[MCSL] 使用 /mcsl upload errors 上传完整的错误日志。
上传的报告(示例)
════════════════════════════════════════════════════════════
MCSL — 服务器诊断报告
════════════════════════════════════════════════════════════
生成时间 : 2026-04-20 17:34:12 UTC
生成器 : MCSL v1.0.0 (https://logs.protectcord.com)
服务器信息
────────────────────────────────────────────────────────────
Name : My Minecraft Server
Software : Paper 1.20.4
Full Version : git-Paper-388 (MC: 1.20.4)
MOTD : Welcome to My Server
Online Mode : true
Port : 25565
Max Players : 100
Online Now : 12 / 100
Memory : 已使用 1842MB / 最大 4096MB
Uptime : 6小时 34分 12秒
TPS : 19.98 / 19.97 / 19.95
插件 (32 个启用 / 33 个总计)
────────────────────────────────────────────────────────────
[+] EssentialsX v2.20.1
[+] LuckPerms v5.4.108
[-] BrokenPlugin v1.0.0 ← 已禁用
错误与异常 (发现 3 个)
────────────────────────────────────────────────────────────
[ERROR] 无法加载 'plugins/BrokenPlugin.jar'
...
完整日志 (500 行)
────────────────────────────────────────────────────────────
... (已脱敏的日志内容) ...
? 安装
- 从 Releases 标签页下载
MCSL-1.0.0.jar - 将其放入服务器的
/plugins/文件夹中 - 重启或重载你的服务器
- 系统会自动生成
plugins/MCSL/config.yml - 在游戏中或控制台中运行
/mcsl help
开箱即用,无需配置。 该插件自带预配置的 API 密钥和合理的默认设置。
要求
| 要求 | 版本 |
|---|---|
| Java | 8 或更高版本 |
| Server | Bukkit / Spigot / Paper / Purpur / Folia |
| Minecraft | 1.8.8 — 1.21.x |
⚙️ 配置
plugins/MCSL/config.yml 会在首次运行时生成。每个选项都在代码内进行了文档说明。
# HasteLog API 设置
api:
timeout-ms: 50000 # HTTP 请求超时时间
# 隐私与脱敏
redaction:
enabled: true # 主开关
redact-player-ips: true # 隐藏 IPv4/IPv6 地址
redact-server-ip: false # 隐藏服务器自身的 IP(用于 /mcsl share)
redact-api-keys: true # 隐藏 JWT 令牌、Bearer 密钥、sk- 密钥等
custom-patterns: [] # 自定义正则表达式模式,例如 "password=[^\\s]+"
# 日志上传行为
upload:
default-lines: 25000 # 未提供参数时上传的行数
include-server-info-header: true
include-plugin-list: true
include-mod-list: true
async: true # 始终推荐开启异步
# 自动操作
auto:
upload-on-crash: true # 服务器非正常退出时自动上传
upload-on-start: false # 服务器启动时上传摘要
notify-ops-on-crash-upload: true
# /mcsl share 选项
share:
include-server-ip: true
include-port: true
include-player-count: true
include-performance: true
# 聊天格式化
messages:
prefix: "&8[&bMCSL&8]&r "
实时配置更改
你可以更改大多数设置而无需重启:
/mcsl config redaction.redact-player-ips false
/mcsl config upload.default-lines 1000
/mcsl config auto.upload-on-crash false
/mcsl reload
⚠️ API URL 和 API 密钥是硬编码在 JAR 包中的,无法通过配置文件更改。这是有意为之的——以防止配置错误并保持全局密钥的安全。
? 命令参考
所有命令都需要 mcsl.use 权限(默认情况下 op 拥有此权限)。
/mcsl upload [argument]
将 latest.log 上传到 HasteLog 并返回一个可点击的 URL。
| 参数 | 行为 |
|---|---|
| (无) | 上传最后 upload.default-lines 行(默认值:25,000) |
500 |
上传最后 500 行 |
all |
上传整个日志文件 |
errors |
仅上传包含错误或警告的行 |
示例:
/mcsl upload 1000
/mcsl upload errors
/mcsl upload all
/mcsl share
生成并上传一份完整的结构化诊断报告——包括服务器信息、插件列表、模组列表、TPS、内存、错误、警告、玩家事件以及完整的日志尾部——所有内容整合在一个 HasteLog 文档中。
这是在寻求帮助时应使用的命令。将链接分享给支持团队、开发者或社区 Discord,他们便拥有了诊断你问题所需的一切信息。
/mcsl info
直接在聊天窗口或控制台打印格式化的服务器信息面板。包含软件版本、性能指标、玩家数量和插件摘要。不会上传任何数据——仅限本地使用。
/mcsl errors [lines]
扫描 latest.log 的最后 N 行,并在聊天中直接打印错误和警告的摘要。默认显示最后 10 个内联错误。如果条目更多,会建议执行 /mcsl upload errors。
/mcsl errors → 扫描最后 25,000 行
/mcsl errors 500 → 扫描最后 500 行
/mcsl players
在日志中扫描玩家事件(加入、离开、连接丢失、踢出、封禁),并在聊天中打印最近发生的 15 条记录。有助于在不阅读完整日志的情况下快速检查最近的玩家活动。
/mcsl plugins
列出服务器当前加载的所有插件,包括其版本、作者以及启用/禁用状态。被禁用或加载失败的插件会以红色的 [-] 标记显示,以便立即察觉。
/mcsl mods
列出所有已加载的 Forge 或 Fabric 模组,包括模组 ID、显示名称和版本。如果服务器是原版或仅运行 Bukkit 而没有模组加载器,则返回提示信息。
/mcsl crash
查找 crash-reports/ 目录中最近修改的文件,附带插件列表头部后将其上传,并返回一个 HasteLog URL。适用于崩溃后快速获取报告链接。
/mcsl config <key> <value>
无需直接编辑 config.yml 即可在运行时更改配置设置。支持对键名和布尔值进行 Tab 补全。
/mcsl config redaction.enabled false
/mcsl config share.include-server-ip false
/mcsl config upload.default-lines 5000
/mcsl reload
从磁盘重新加载 config.yml 并重新编译任何自定义的红掩码规则。
? 权限
| 权限 | 默认值 | 描述 |
|---|---|---|
mcsl.use |
op | 访问所有 /mcsl 命令 |
mcsl.upload |
op | 将日志上传至 HasteLog |
mcsl.info |
op | 查看服务器信息 |
mcsl.share |
op | 生成完整的诊断报告 |
mcsl.config |
op | 在运行时更改配置 |
mcsl.use 是一个父级权限,会自动授予所有子权限。
?️ 隐私与安全
默认情况下哪些内容会被红掩?
| 数据 | 是否红掩 | 替换内容 |
|---|---|---|
| 玩家 IPv4 地址 | ✅ 是 | [REDACTED_IP] |
| 玩家 IPv6 地址 | ✅ 是 | [REDACTED_IPv6] |
| JWT 令牌 | ✅ 是 | [REDACTED_TOKEN] |
API 密钥 (sk-, Bearer, hl_ 等) |
✅ 是 | [REDACTED_KEY] |
| JDBC/数据库密码 | ✅ 是 | password=[REDACTED] |
服务器 IP (在 /mcsl share 中) |
❌ 否 (可配置) | [SERVER_IP] |
| 玩家用户名 | ❌ 否 | — |
| 世界名称 | ❌ 否 | — |
会上传什么?
仅上传你明确请求的内容。除非你的配置中包含 auto.upload-on-crash: true 或 auto.upload-on-start: true,否则 MCSL 绝不会在后台自动上传。API 密钥嵌入在 JAR 文件中,无法从 config.yml 中读取。
数据存储在哪里?
所有上传均发送至 logs.protectcord.com,这是由 ProtectCord 运营的 HasteLog 实例。拥有链接的任何人均可访问这些文档。
? 分析统计
MCSL 通过 bStats 收集匿名使用统计数据。这包括:
- 使用该插件的服务器数量
- 正在使用的 Minecraft 和服务器软件版本
绝不会收集任何日志内容、玩家数据或可识别服务器的信息。你可以在 plugins/bStats/config.yml 中全局禁用 bStats。
❓ 常见问题
Q: /mcsl upload 会上传整个日志文件吗?
不会——默认情况下它只上传最后 25,000 行。如需上传完整文件,请使用 /mcsl upload all,或者指定行数如 /mcsl upload 500。
Q: 普通玩家能看到上传的 URL 吗?
只有操作员(或拥有 mcsl.use 权限的玩家)才能运行任何 MCSL 命令。URL 仅向发出命令的人显示。
Q: API 密钥安全吗?
API 密钥经过 XOR 混淆处理并编译进 JAR 文件中——它在字节码中不以可读字符串形式出现。此外,它完全排除在 config.yml 之外,服务器管理员无法更改或读取它。
Q: 这在 Folia 上能工作吗? MCSL 可以在 Folia 服务器上加载。命令、日志读取和上传均可正常工作。TPS 检测会在可用时使用 Folia 的调度器。
Q: 我可以使用自托管的 HasteLog 实例吗? 不能通过配置实现——URL 已硬编码在 JAR 中。如果您需要针对您的托管环境的自定义构建,请联系 ProtectCord。
Q: 它与 Forge 或 Fabric 兼容吗? MCSL 是一个 Bukkit 插件,因此它可以运行在 Mohist (Forge+Bukkit) 或 Cardboard (Fabric+Bukkit) 等混合服务器上。在这些平台上,模组检测通过反射机制工作。
? 链接
| 资源 | 链接 |
|---|---|
| HasteLog 服务 | logs.protectcord.com |
| bStats 仪表盘 | bstats.org/plugin/bukkit/MCSL/30872 |
由 ProtectCord 用 ❤️ 制作 · 由 HasteLog 提供支持
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
自定义你的Minecraft头像!
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧