PacketProfiler

Quick rating

Community listing page, reviews here may not be monitored by the author.

Report a bug to the author How listings work Are you the author?

PacketProfiler

By hawkslolOwner

No reviews yet

Packet Profiler for Minecraft, see what packets you recently sent and received, how much bandwidth they were and more.

Mod Loaders
Minecraft
26.3 26.2
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

About

Description

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.