MCPentester v1.0.2

Pentesting tool for Minecraft
Inspired by MCPTool

This project was created for educational purposes and should not be used in environments without legal authorization.

Warning: This project still in development! Bugs may occur! Please, report them at GitHub! Some features may not work or be missing, feel free to contribute or report issues! Thanks!

🆕 What's new in v1.0.2

[!] Hello! Привет! Hola! (v1.0.1)

• MCPentester now supports multilanguage!
  • v1.0.1 already has English, Russian and Spanish languages!

[!] API (v1.0.1)

• Now, the project has its own API!
  • Ping servers by yourself! (WARNING: REVEALS IP)

[!] New config system (v1.0.1)

• Configuration system based on .py file looks bad, isn't it?
  • Well, I know! That's why I've switched to .json config!
  • It looks much cleaner and better to use.

Pings, quering, skins and more! (v1.0.1)

• Now, you can ping servers via

  • mcsrvstat.us
  • minecraftpinger.com
  • Local API (Reveals your IP)

• Quering servers

  • Wan't to know what software server runs on?
  • Or maybe you wan't to know what plugins does server uses?
  • Easily! Just use query <ip|domain>[:port] command!

• Download skins and capes!

  • Use skin <nick|uuid> command to download someone's skin!
  • Example: skin kreewxq to download my skin :p

Nick history

• Now you can get player's nickname history!
  • Use nickhistory <nick|uuid> command to get player's nickname history!
  • Example: nickhistory vepex to get vepex's nickname history

Download favicons

• Download favicons easily!
  • Now with favicon <host|domain>[:port] command you can download server's favicon!
  • Example: favicon mc.hypixel.net to download Hypixel's favicon!

Small changes:

• Improved help command, you can now use help <command> to get information about specific command (v1.0.1)
• Added dns <domain> command (v1.0.1)
• Added logs
• Small refactoring
• and more...

⚙️ Features

• Getting information about:
  • servers
  • players
  • UUIDs
  • IPs
• Scanning ports and pinging available servers searching for Minecraft servers
• and more!

Want to see more features? Feel free to contribute!

🛡 Installation and usage

Installation:

git clone https://github.com/mrksbgg/MCPentester && cd MCPentester && pip install -r requirements.txt && python3 main.py

Command above will install AND run MCPentester after installation

Usage:

cd MCPentester && python3 main.py

💻 Supported platforms

MCPentester is not supported on Termux/Pydroid!

• Windows (10, 11)
• Linux-based distros

If you succeeded running MCPentester on other platform, please, report it at GitHub!

⚙️ Example usage

Get information about server

server <ip|domain>[:port]

Get information about player

player <name>

Get information about UUID

uuid <name>

Get information about IP

ip <ip|domain>

Scan ports and ping available servers searching for Minecraft servers

scan <ip|domain> <from-to>

Scan DNS records (SRV, subdomains, TXT/MX/NS)

dns <domain>

Query Minecraft server via UDP Query (GameSpy4) protocol

query <ip|domain>[:port]

📚 Documentation

Will be written sometime...

🛠 TODO:

[!] - high priority

• Velocity/Waterfall FakeProxy
• Bot join
• Improve server mass scanning
• Server aliases (favorite them?)
• Termux support?
• and more...

❤️ Thanks to

• @mrksbgg - Developer of MCPentester
• @wrrulosdev - Developer of MCPTool, MCPentester's inspiration