README.md

creeper.sh

The Offensive Global Minecraft® Server Scanner

⚠️ Please: Do not repeat the actions of The Fifth Column. If too many people start doing this, who knows what playing minecraft will be like then.

Seen us?

Start a discussion!

What's it do?

Uses masscan to scan the internet for Minecraft® servers, then uses Dinnerbone's mcstatus to grab the GameSpy4 data, cleaning up the process of doing it manually.

Tested with:

• Arch Linux - 2024.08.01 - Release
• Ubuntu - 24.10 - Oracular Oriole
• Kali Linux - Bleeding Edge
• masscan - robertdavidgraham/masscan@dfd2001
• mcstatus - py-mine/mcstatus@338eb93
• mcc - MCCTeam/Minecraft-Console-Client@ca966a4

But why?

Purely because its easier to shorten the process by making it scripted, then I just cleaned it up for public release, so other people can have fun joining random servers.

The process usually goes like this:

1. Scan ISP range.
2. See players online in a server.
3. Switch to the appropriate Minecraft® version.
4. Join the server.

Various reactions ensue, from "Hello?" to...

Connection Lost

You are banned from this server.

Don't forget!

If you have the chance, inform the server owners that their home router (if applicable) has its port exposed to the internet, and should either close it, or use a whitelist.

Some people just forget, or don't understand what they are doing.

Screenshots

Starting a scan of 1 million AT&T routers (took 3 minutes)

Using mcstatus to display information about the servers

Using mcc to log in to Minecraft® and join the servers

Running the default creeper.sh script with MCC on a server

Completed scan after mcstatus and mcc have finished.

"Minecraft" is a trademark of Mojang Synergies AB.