README_EN.md

Minecraft Server Ports Scanner GUI

Language:

1. 简体中文
2. English

---

Important

Disclaimer of Warranties: This is only for the educational purpose, not responsible for any conflict.

Selling, reselling, or engaging in any profit-making activity is strictly forbidden.

The project uses Python 3.10.9 64-bit.

Before any pull requests submitted, join our QQ channel first.

Introduction

A tool to scan for a Minecraft server on all ports of an IP address and display the information.

Our QQ channel is 153037480 named MCSPS交流群. If you have any problems about our project, highly recommended to join us.

Features

• Beautiful GUI ( which is present by ttkbootstrap )
• Lagged window size changing
• Ancient tkinter library
• Scan
  • Pause supported
  • Multi-thread scanning
  • Advanced port range adjustment control
  • Server versions filtering available
• Information displaying
  • Beautiful colorful title parse
  • Minecraft fonts
  • Player UUID displayed
  • Mod name & version displayed

Future

• Settings
• Multi-window for scanning tasks
• The functionality for the info window to be reloaded
• Live-time chart showing scanning speed
• Minecraft server ports displaying with chart
• Listing ports with treemap
• Scan records with date recorded

Environment Setups & Using

The main branch only support Windows, Mac / Linux development is welcomed if interested.

There are two choice for you.

1. Download the code and run.

   You can use git clone, etc. to download the repository, then run pip install -r requirements.txt to install all the modules needed, finally run main.py to run the program.

2. Download the zip package and run the executable program.

   The code in this zip package runs on Python 3.8.9 32-bit embedded.

   You can directly go to Releases, download the zip package, unzip, and run MC服务器扫描器3.0.exe.

   xx.exe on Releases page is a 7-Zip self-extracting program.

To developers

Google Python Style Guide & PEP 8 is recommended to obey.

Gallery