Shodan-like server scanner for Minecraft (formely mcserverscanner)
Project description
Yokkaichi (formely mcserverscanner) - Shodan-like server scanner for Minecraft.
Renaming notice!
This project used to be named mcserverscanner, but on 2023-01-15 it got renamed to Yokkaichi.
⚠️ WARNING - USE AT YOUR OWN RISK ⚠️
In some cases, you can get in trouble for using this software! Before using it, make sure that is is legal to do port scanning in your region or country, and contact your VPN provider / VPS provider / ISP / network administrator and ask them is such software allowed. This software is made for educational purposes only and I won't be responsible for any damage done using this tool.
Features
- Scanning for Java and Bedrock servers
- Masscan integration
- IP2Location integration
- Query integration
Planned features (not in a specific order)
- WWW interface
- Bot joining the servers
- Cleaning up the code
- Docker support
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-db data/IP2LOCATION-LITE-DB11.BIN --ip2location-cache --output data/servers.json
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for yokkaichi-1.1.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d5c92674fa4a66fdca78e347d25f637bcb4e23fe626f4693300ab5dd280dda5a |
|
MD5 | 3edc2eec97b69489bb5bc5cd15b8735a |
|
BLAKE2b-256 | cf259cb315fc648414710b896b1b3116b1b6712205a3d01d1535bbd1c19284f2 |