zerogoki00 / minescanner Goto Github PK

Minescanner is an open-source tool for searching for Minecraft servers in IP ranges.

It parses masscan report file and attempts to connect to each server and extract data (MOTD, player count, etc).

Install masscan. You can get masscan for windows from here.

Download the latest IP to country database from here and place it into geoip folder

Create venv:

python3 -m venv .venv

Activate venv:

source .venv/bin/activate

Install requirements:

pip3 install -r requirements.txt

Alternatively you can install them system-wide.

First you need to scan IP ranges:

 sudo masscan -e <device> -p25565 --rate <rate> -iL in/<ranges list> -oL scanned/<filename>

You can find more information about masscan's usage on its GitHub page

After scanning you can start minescanner using this command:

python3 minescanner.py scanned/<filename> out/<filename> -n <num of processes>

The default number of threads is 4, but I recommend setting 20-40 because it will save a lot of time.

Minescanner will start scanning and will write results in CSV format.