=============================================
🌍 Multiplayer Player Location Grabber Guide
=============================================

This script detects and logs the country, city, and IP address of players in your multiplayer game lobby using real-time packet sniffing.

=============================================
✅ What You'll Need (Prerequisites)
=============================================

===========================
🐍 1. Install Python 3.12.2
===========================

Go to the Python downloads page
 - https://www.python.org/downloads/

Download the latest Python version.

* IMPORTANT:
During installation, check the box that says Add Python to PATH

EXAMPLE: https://files.catbox.moe/lshxcs.png

===========================
🌐 2. Install Npcap Driver
===========================

Download the latest installer from: https://npcap.com/

Run the installer and use default settings (admin access required)

=============================================
⚙️ Setup & Running the Script
=============================================

===========================
🗂️ 1. Open Command Prompt
===========================

Press WIN + R, type cmd, and press Enter

Navigate to the folder where grabber.py is located using the cd command:
Example:
cd C:\Users\YourUsername\Downloads\grabber-folder

===========================
📦 2. Install Required Python Libraries
===========================

Type this in CMD:
pip install -r requirements.txt

===========================
🛠️ 3. Set Your IPv4 Address in the Script
===========================

Open grabber.py in any text editor (e.g., Notepad++)

Look for the line that says LOCAL_IP = "192.168.0.12"

Open a second Command Prompt, type:
ipconfig

Find your IPv4 Address (example: 192.168.1.25)

Replace the IP address in the script with your actual IPv4 Address

===========================
🧪 4. Run the Script
===========================

Back in the first CMD window, run:
python grabber.py

- Join a multiplayer session in your game
- The console will now display other players' IPs, locations, and countries in real-time