黑盒

黑盒

您服务器的“刚刚发生了什么？”按钮。一个事件记录器，将神秘的延迟变成整洁的压缩包，让您能够真正采取行动。

实用

BlackBox 是您项目的飞行记录仪。

您一定遇到过这种情况——聊天栏里充斥着"卡顿"，服务器冻结了几秒钟，然后又恢复正常。您检查日志但找不到任何有用的信息。问题消失了，只发生过一次，而且没人能重现它。

BlackBox 解决了这个问题。

它在后台安静运行，当发生卡顿/峰值/崩溃/意外时，它会捕捉一小段时间的证据，并生成一个您可以分享或存档的事件包。您能在事后得到答案，而不只是碰巧在正确的时间进行性能分析。

管理员体验的变化：

  • 更少盲目的重启（您有了报告）
  • 更快的修复（一个可以交给开发者的压缩包）
  • 更少的猜测（事件时间线 + JVM 证据）
  • 有限的磁盘占用（旧日志会被删除）

您将获得：

  • 每个事件一个压缩包（结构一致，方便附加到工单）
  • 供人类阅读的 report.html（本地打开，无需端口）
  • 供深度分析的 recording.jfr（JDK Mission Control）
  • 环境快照（JVM 和操作系统信息）
  • 可选的 Discord 通知

常见使用场景：

  • "TPS 下降了 10 秒"
  • "服务器冻结后又恢复了"
  • "夜间随机崩溃"
  • "只有一个世界卡顿，其他正常"
  • "负载下的 GC 峰值"（如果您不知道这意味着什么，这正是重点所在）

安装

  1. 将 jar 文件放入服务器的 mods 文件夹
  2. 启动服务器
  3. 当发生问题时，打开最新的事件压缩包，然后点击 report.html

隐私与安全

默认情况下为本地运行。不上传、无遥测、不连接外部服务。Discord 通知为可选项，且仅发送一条简短消息（不发送事件包）。日志收集为可选项。

支持：

https://discord.gg/kWFJbqkpfh