yokkaichi 1.0

Shodan-like server scanner for Minecraft (formely mcserverscanner)

Yokkaichi (formely mcserverscanner) - Shodan-like server scanner for Minecraft.

Renaming notice!

This project used to be named mcserverscanner, but on 2022-01-15 it got renamed to Yokkaichi.

Installation

• Easy installation (from PyPI)

pip install yokkaichi

• Manual installation (from git)

git clone https://github.com/Oreeeee/yokkaichi
cd yokkaichi
pip install .

Usage

You can use this script by invoking python -m yokkaichi and passing in arguments in the CLI. You can get the list of availible options by invoking python -m yokkaichi -h

Example

python -m yokkaichi --java --masscan --masscan-countries US CA CN -p 25565 25566 --ip2location data/IP2LOCATION-LITE-DB11.BIN --output data/servers.json

Big Thanks

• herrbischoff/country-ip-blocks for providing CIDR blocks for countries
• IP2Location and IP2Location Lite for providing accurate offline IP to Location service.