BlackBox
BlackBox 是一款轻量级的客户端遥测与崩溃报告模组,专为测试和活动环境设计。它会在后台静默收集性能数据、客户端配置和错误信息,并实时发送至 Discord Webhook——无需外部服务器或 API。
功能说明
BlackBox 完全在客户端运行,并在你断开服务器连接、关闭游戏或遇到未捕获异常时捕获会话快照。每次报告包含:
- 性能指标:会话期间的平均、最低和最高 FPS,以及 JVM 内存使用情况
- 硬件信息:操作系统、CPU 核心数、系统内存、GPU 渲染器及 Java 版本
- 客户端设置:渲染距离、图形模式、最大 FPS、垂直同步(VSync)、粒子效果、实体阴影、全屏状态和 GUI 缩放比例
- 环境详情:Minecraft 版本、Fabric 加载器版本以及已安装模组的完整列表
- 崩溃数据:发生未捕获异常时的完整堆栈跟踪和上下文信息
设计初衷
BlackBox 旨在为模组化活动提供结构化的测试支持。与其依赖测试人员手动描述问题或性能瓶颈,它能在出现问题或会话结束时自动上报客观数据——从而在不搭建任何后端基础设施的情况下,更轻松地跨多名玩家关联崩溃、卡顿和配置信息。
配置
首次启动时,BlackBox 会生成一个配置文件,你需要在其中设置自己的 Discord Webhook URL。在未进行此配置前,不会发送任何遥测数据。该模组适用于受控的测试环境,不建议在未告知被监控玩家的情况下在公共服务器上无人值守运行。
要求
- Minecraft 1.21.1
- Fabric Loader
- Fabric API
- Java 21+
BlackBox
BlackBox is a lightweight, client-side telemetry and crash reporting mod built for testing and event environments. It silently collects performance data, client configuration, and error information, then delivers it in real time to a Discord webhook — no external server or API required.
What it does
BlackBox runs entirely on the client and captures a snapshot of the session whenever you disconnect from a server, close the game, or hit an uncaught exception. Each report includes:
- Performance metrics: average, minimum, and maximum FPS over the session, along with JVM memory usage
- Hardware information: operating system, CPU core count, system RAM, GPU renderer, and Java version
- Client settings: render distance, graphics mode, max FPS, VSync, particles, entity shadows, fullscreen state, and GUI scale
- Environment details: Minecraft version, Fabric Loader version, and the full list of installed mods
- Crash data: full stack trace and context whenever an uncaught exception occurs
Why it exists
BlackBox was built to support structured testing for modded events. Rather than relying on testers to manually describe issues or performance problems, it automatically reports objective data the moment something goes wrong or a session ends — making it easier to correlate crashes, lag, and configuration across many players without running any backend infrastructure.
Configuration
On first launch, BlackBox generates a configuration file where you set your own Discord webhook URL. No telemetry is sent until this is configured. The mod is intended for controlled testing environments and is not meant to run unattended on public servers without the knowledge of the players being monitored.
Requirements
- Minecraft 1.21.1
- Fabric Loader
- Fabric API
- Java 21+
评论 0
登录后参与评分
还没有评论,来抢沙发吧