This project used to be named mcserverscanner, but on 2023-01-15 it got renamed to Yokkaichi.
- Scanning for Java and Bedrock servers
- Masscan integration
- IP2Location integration
- WWW interface
- Bot joining the servers
- Docker support
- Scanning for pre-Netty (<1.7) servers
- Query integration
- Installing the latest version with pipx (recommended)
pipx install yokkaichi --include-deps
yokkaichi -v
- Installing the latest version in a virtual environment
virtualenv .venv
source .venv/bin/activate # for Linux
.venv\bin\activate.bat # for Windows
pip install yokkaichi
yokkaichi -v
Check out DEVELOPMENT_INSTALL.md
masscan(for faster scanning)
When starting the script for the first time, yokkaichi.toml will get created. You will have to adjust it to your preferences. Optionally, you can also pass in -c to set a different name or location of the config file.
Yokkaichi uses IP2Location LITE for anything geolocation related. This includes getting the location of the server, and generating the CIDR ranges for scanning. It is a offline, free to use download, so there are no rate limits. However, the database is not redistributed with Yokkaichi, due to IP2Location updating their LITE databases every month. Instead, it will be downloaded and updated automatically everytime you run this script for the first time in the month. To get the downloading to work, you need to have an IP2Location LITE Download Token. To get one, follow these steps.
- Go to IP2Location LITE website and register (or log into) an account (which is completly free forever).
- Click on the name in the upper right corner and select "Database Download".
- Copy your Download Token.
- Set the
IP2LOCATION_LITE_TOKENenvironment variable to your token. - Now, you will be able to use the automatic downloads feature.
You need to have masscan in your PATH, or in the same directory from which you are running this software. Make sure that the binary is named masscan (Unix) or masscan.exe (Windows).