Repository files navigation

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-depsyokkaichi -v

• Installing the latest version in a virtual environment

virtualenv .venvsource .venv/bin/activate # for Linux.venv\bin\activate.bat # for Windowspip install yokkaichiyokkaichi -v

Check outDEVELOPMENT_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.

1. Go toIP2Location LITE website and register (or log into) an account (which is completly free forever).
2. Click on the name in the upper right corner and select "Database Download".
3. Copy your Download Token.
4. Set theIP2LOCATION_LITE_TOKEN environment variable to your token.
5. Now, you will be able to use the automatic downloads feature.

You need to havemasscan in your PATH, or in the same directory from which you are running this software. Make sure that the binary is namedmasscan (Unix) ormasscan.exe (Windows).