PacketProfiler
PacketProfiler 是一款轻量级的客户端 Fabric 模组,适用于 Minecraft 26.2,可实时分析数据包频率和 Minecraft 协议帧带宽。
它专为模组开发者、服务器管理员、技术型玩家以及任何正在调查异常网络活动或带宽使用情况的人设计。无需在服务器端安装。
功能
- 按类名统计传入和传出的数据包数量。
- 识别捕获期间最繁忙的数据包类型。
- 按方向和数据包类型测量协议帧带宽。
- 直接在聊天栏中显示紧凑且易读的报告。
- 使用经过清理的 PacketSniff 工具检查选定的数据包。
- 支持数据包类名的 Tab 补全。
- 当名称拼写错误时,建议最接近的数据包名称。
- 可选择异步保存完整的聚合报告。
- 当没有配置文件运行时,实际上保持空闲状态。
命令
| 命令 |
描述 |
/packetprofiler |
开始或停止数据包计数捕获。 |
/packetprofiler max [duration] |
捕获所有观察到的数据包类型。默认为 10 秒。 |
/packetprofiler bandwidth [duration] |
测量传入和传出的协议帧带宽。 |
/packetprofiler bandwidth [duration] -verbose |
在带宽报告中包含所有观察到的数据包类型。 |
/packetprofiler packetsniff <packetname> |
打印每个匹配数据包的已清理字段,直到停止。 |
/packetprofiler packetsniff |
停止活动的 PacketSniff。 |
/packetprofiler logging |
切换持久性聚合报告日志记录。 |
/packetprofiler help |
显示游戏内帮助菜单。 |
持续时间支持 h、m 和 s。例如,3h49m5s 运行时间为 3 小时 49 分钟 5 秒。
同一时间只能有一个捕获或 PacketSniff 处于活动状态。
带宽测量
PacketProfiler 在传输解密后测量 Minecraft 协议帧。
测量内容包括:
- 包含帧的 VarInt 长度前缀;
- 排除以太网、IP 和 TCP 标头;
- 区分传入和传出流量;
- 尽可能将测量的字节归因于高级数据包类。
数据包观测是可选的、非取消操作的,并且具有故障开放特性。PacketProfiler 不会修改、延迟、重发或取消网络流量。
隐私
普通捕获仅存储以下内容:
- 数据包类名;
- 方向;
- 计数;
- 聚合帧字节;
- 百分比;
- 捕获持续时间;
- 峰值数据包速率。
PacketProfiler 不捕获数据包有效载荷。
PacketSniff 经过刻意清理。文本、聊天、NBT、物品数据、缓冲区、用户名、UUID、服务器地址、凭据、令牌、签名和认证材料均被删除。PacketSniff 输出仅限聊天,永远不会写入持久性报告。
日志记录
持久性日志记录默认禁用。启用后,完整的聚合报告将异步写入以下位置:
config/packetprofiler/
要求
- Minecraft 26.2
- Fabric Loader 0.19.3+
- Fabric API 0.156.0+26.2+
- Fabric Language Kotlin 1.13.13+kotlin.2.4.10+
- Java 25
PacketProfiler 是一个仅限客户端的模组,无需在服务器上安装。
PacketProfiler 由 AI 在人类指导和审查下维护。
PacketProfiler
PacketProfiler is a lightweight, client-side Fabric mod for Minecraft 26.2 that profiles packet frequency and Minecraft protocol-frame bandwidth in real time.
It is designed for mod developers, server administrators, technical players, and anyone investigating unusual network activity or bandwidth usage. No server-side installation is required.
Features
- Count incoming and outgoing packets by class-style name.
- Identify the busiest packet types during a capture.
- Measure protocol-frame bandwidth by direction and packet type.
- Display compact, readable reports directly in chat.
- Inspect selected packets using the sanitized PacketSniff tool.
- Tab-complete supported packet class names.
- Suggest the closest packet when a name is mistyped.
- Optionally save complete aggregate reports asynchronously.
- Remain effectively idle when no profiler is running.
Commands
| Command |
Description |
/packetprofiler |
Start or stop a packet-count capture. |
/packetprofiler max [duration] |
Capture every observed packet type. Defaults to 10 seconds. |
/packetprofiler bandwidth [duration] |
Measure incoming and outgoing protocol-frame bandwidth. |
/packetprofiler bandwidth [duration] -verbose |
Include every observed packet type in the bandwidth report. |
/packetprofiler packetsniff <packetname> |
Print sanitized fields from every matching packet until stopped. |
/packetprofiler packetsniff |
Stop the active PacketSniff. |
/packetprofiler logging |
Toggle persistent aggregate report logging. |
/packetprofiler help |
Display the in-game help menu. |
Durations support h, m, and s. For example, 3h49m5s runs for 3 hours, 49 minutes, and 5 seconds.
Only one capture or PacketSniff can be active at a time.
Bandwidth measurement
PacketProfiler measures Minecraft protocol frames after transport decryption.
Measurements:
- include the frame’s VarInt length prefix;
- exclude Ethernet, IP, and TCP headers;
- separate incoming and outgoing traffic;
- attribute measured bytes to high-level packet classes where possible.
Packet observation is optional, non-cancelling, and fail-open. PacketProfiler does not modify, delay, resend, or cancel network traffic.
Privacy
Ordinary captures store only:
- packet class names;
- direction;
- counts;
- aggregate framed bytes;
- percentages;
- capture duration;
- peak packet rates.
PacketProfiler does not capture packet payloads.
PacketSniff is deliberately sanitized. Text, chat, NBT, item data, buffers, usernames, UUIDs, server addresses, credentials, tokens, signatures, and authentication material are redacted. PacketSniff output is chat-only and is never written to persistent reports.
Logging
Persistent logging is disabled by default. When enabled, full aggregate reports are written asynchronously under:
config/packetprofiler/
Requirements
- Minecraft 26.2
- Fabric Loader 0.19.3+
- Fabric API 0.156.0+26.2+
- Fabric Language Kotlin 1.13.13+kotlin.2.4.10+
- Java 25
PacketProfiler is a client-only mod and does not need to be installed on the server.
PacketProfiler is maintained by AI under human direction and review.
评论 0
登录后参与评分
还没有评论,来抢沙发吧