Security Disclosure

Important Security Notice

PacketSpy intercepts and displays real-time Minecraft network packets (both outgoing and incoming) via a local web interface at http://localhost:8887.

The built-in web server is strictly bound to localhost for single-machine use only.
Displayed packet data may contain sensitive information, including chat messages, player coordinates, inventory contents, custom mod data, or other gameplay details.
Users should take precautions:
- Avoid modifying the server configuration to expose the port externally.
- Prevent unauthorized access to the device, as anyone with local access could view the interface.
- Be mindful when sharing screenshots, recordings, or logs, as they may reveal private information.
This tool is intended solely for personal debugging and development. Use it responsibly, respecting server rules, privacy norms, and applicable laws.

No remote vulnerabilities are known in the current version, but exercise standard caution with any network inspection tool.

PacketSpy

PacketSpy is a lightweight, client-side network debugging tool for Minecraft Fabric (supports versions 1.21–1.21.3). It provides real-time inspection of packets exchanged between the client and server, making it ideal for mod developers and advanced players troubleshooting network issues.

Unlike traditional logging that clutters the console or chat, PacketSpy runs a local web server (powered by Java-WebSocket) to stream packet data to a clean, browser-based dashboard at http://localhost:8887.

Key Features

Real-Time Monitoring: Instantly view packet names, directions (TX/RX), and timestamps as they happen.
External Web Dashboard: Keeps the in-game experience uncluttered—monitor everything in a separate browser tab.
Intelligent Filtering: Toggle filters to suppress high-volume "noise" packets (e.g., move_player_pos and move_player_rot), highlighting important events like custom mod packets or rare interactions.

Why Use PacketSpy?

For Players & Power Users

Eliminate chat/log spam from packet debugging.
Clear, readable packet list with essential details.
Automatically filter out mundane movement updates to focus on meaningful traffic.
Perfect for diagnosing lag, mod conflicts, or server-side anomalies.

For Mod Developers

Observe custom packets in real time to quickly identify and fix issues.
Keep the game window free of debug output.
Prioritize relevant packets with built-in filters.
Minimal overhead—lightweight and fully compatible with Fabric Loader.

PacketSpy turns complex network debugging into a straightforward, efficient process.

Current Version: 2.0
Built With: Gradle
Logo: AI-generated (via ChatGPT)

Packet Spy