https://github.com/toshimichi0915/threescan
One of the most powerful Minecraft server scanners in the world.
https://github.com/toshimichi0915/threescan
java minecraft minecraft-scanner port-scanner
Last synced: 12 months ago
JSON representation
One of the most powerful Minecraft server scanners in the world.
- Host: GitHub
- URL: https://github.com/toshimichi0915/threescan
- Owner: Toshimichi0915
- Created: 2022-10-21T22:03:26.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-05-25T15:57:24.000Z (about 2 years ago)
- Last Synced: 2025-06-07T08:08:18.162Z (about 1 year ago)
- Topics: java, minecraft, minecraft-scanner, port-scanner
- Language: Java
- Homepage:
- Size: 138 KB
- Stars: 17
- Watchers: 0
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# threescan
The most powerful Minecraft server scanner in the world.
## Usage
```bash
java -jar threescan.jar
```
where
* type - the type of scan (simple, range, masscan, threescan)
* mode - the mode of scan (fast, full)
* timeout - the timeout of scan (in milliseconds)
* rate - the rate of scan (scan per second)
* name - the name of a player (used to determine server type)
* uniqueId - the uniqueId of a player (used to determine server type)
**It is highly encouraged to use this program with masscan on Linux for better performance.**
It is known that this program may cause some issues on Windows.
In order to use this program with masscan, you can use the following command:
```bash
masscan -c masscan.conf 2>/dev/null | java -jar threescan.jar masscan stdin 200 2000 > output.txt 2>error.txt
```
where
* masscan.conf - the configuration file of masscan
* username - the name of a player (which will be shown to scanned hosts)
* uuid - the uniqueId of a player (specify a UUID that matches to the username from https://namemc.com)
## Features
* zero memory copy
* asynchronous I/O
* ability to determine server type
## Types
Currently, there are 4 types: "simple", "range", "masscan", and "threescan".
### Simple
This type is used to scan a single host.
```text
127.0.0.1
127.0.0.1 25565
127.0.0.1 25565 25565
```
### Range
This type is used to scan a range of hosts.
```text
127.0.0.1/24 25565 25565
-
127.0.0.1-127.0.0.255 25565 25565
127.0.0.1 25565 25565
```
### Masscan
This type is used to combine the program with Masscan.
```text
Discovered open port /tcp on
Discovered open port 25565/tcp on 127.0.0.1
```
### Threescan
This type is used to recheck the scan results of threescan.
```text
{"host":"", "port":, ...}
{"host":"127.0.0.1", "port":25565, ...}
```
## Modes
Currently, there are 2 modes: "fast" and "full".
With full mode, additional packets are sent to determine server types. However, scans will be slower and a message will be shown to scanned hosts.