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)

PacketSpy V2.0

This is a mod made to debug packets and log packets being sent and received by the client. It will host a website using Java WebSockets and host it on localhost:8887. It is not fully working now. For example, it says field_xxxx, where xxxx is numbers. I need to fix that ASAP, but yea, it's just a small mod to look at packets.