docs: improve project description for clarity and safety

Author: mishl-dev

README.md

@@ -1,24 +1,51 @@
 # NetUtils
 
-> **This tool is for educational and debugging purposes only.** Using it to gain an unfair advantage or perform exploits (such as item duplication) on multiplayer servers is a violation of most server rules and platform terms of service. The developers do not condone cheating/duping. Use this mod at your own risk and only where you have explicit permission.
+A powerful networking utility for Minecraft protocol debugging, state synchronization testing, and network analysis. Built on the Architectury API for **Fabric** and **NeoForge**.
 
-A networking utility for protocol debugging and state synchronization testing.
+> [!WARNING]
+> **This tool is for educational and debugging purposes only.** Using it to gain an unfair advantage or perform exploits on multiplayer servers is a violation of most server rules and platform terms of service. The developers do not condone cheating/duping. Use this mod at your own risk and only where you have explicit permission.
 
-<img width="1365" height="697" alt="image" src="https://github.com/user-attachments/assets/b84ae327-eb51-4112-ab92-cca66619e079" />
+---
 
+## What specifically does this project provide?
 
+NetUtils adds a comprehensive suite of client-side debugging tools that allow you to interact with the Minecraft networking layer in ways the vanilla client cannot:
+
+- **Packet Flow Control**: Intercept, delay, or completely toggle outgoing packets to test server-side response times and handling.
+- **Inventory State Manipulation**: Experiment with client-server desynchronization (e.g., closing screens locally without notifying the server) to test state handling logic.
+- **Detailed Data Extraction**: View internal menu information (Sync IDs, Class names), list villager trades with internal IDs, and inspect GUI slot metadata.
+- **Resource Pack Management**: Bypass or force-deny server-requested resource packs for testing environment isolation.
+- **Enhanced Client-Side Commands**: A custom command system (using the `^` prefix) for low-level interaction, including raw packet sending and loop execution.
+
+## Why should you use NetUtils?
+
+- **Mod & Plugin Development**: If you are developing a mod or server plugin that relies on complex inventory or networking logic, NetUtils is an invaluable tool for stress-testing your code against "illegal" or unexpected client states.
+- **Protocol Education**: Perfect for developers and researchers who want to understand the Minecraft networking protocol by observing and manipulating packets in real-time.
+- **Network Resilience Testing**: Use the desynchronization and packet delay features to verify that your server's anti-cheat or state-recovery systems are robust.
+
+## Critical Information & Safety
+
+- **Clean & Transparent**: This project is maintained as a safe, open-source alternative to historical versions of similar utilities (like UIUtils v1.0.2) which were known to contain security vulnerabilities.
+- **Multiplayer Usage**: Using this on public servers will likely result in a permanent ban. It is intended for use in private development environments.
+- **Compatibility**: Requires **Minecraft 1.21.11** and the **Architectury API**.
+
+---
 
 ## Features
+
 - **Packet Control**: Delay or toggle outgoing packets.
 - **Synchronization**: Simulate client-server desynchronization for state handling tests.
 - **Inventory Control**: Close inventory screens without sending packets to the server.
 - **Resource Pack Control**: Bypass or force-deny server resource packs.
 
 ## Usage
+
 Press **V** to restore the last closed screen.
 
 ## Client Commands
+
 All commands use the `^` prefix and can be typed in regular chat or the custom chat input field.
+
 - `^help` - Show all commands
 - `^toggle` - Enable/disable mod features
 - `^menuinfo` - Display GUI info (class, slots, sync ID)
@@ -33,11 +60,13 @@ All commands use the `^` prefix and can be typed in regular chat or the custom c
 - `^save`/`^load` - Save or restore the current screen state
 
 ## Building
+
 Run the following command to build for both Fabric and NeoForge:
 ```bash
 ./gradlew collectJars
 ```
 The output jars will be in `build/libs/`.
 
 ## License
+
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.