Skip to content

ScriptLineStudios/MCHoneyPot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

66 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MCHoneyPot

A Minecraft server honeypot built to report mass server scanning.

About

MCHoneyPot works by creating realistic looking Minecraft server, faking details such as players online, server version etc. It's job is to log all attempts made to interact with the server including pings, status requests, and attempts to join. The goal is to index, report, and raise awareness of mass server scanning and how it can affect server owners.

All interactions made with the server are logged:

Screenshot from 2024-03-16 09-23-43

Screenshot from 2024-03-16 18-50-55

Additionally reports are made to https://www.abuseipdb.com/

Getting Started

If you would simplily like to interact with the hosted version of the bot, you can do so by joining our Discord Server where you can feel free to interact with the bot as you please.

Alternatively you can invite the bot to your own server using the following invite Once the bot is in your server run /configure in the channel where you would like the bot to output logs!

Screenshot from 2024-03-16 18-49-27

Running your own instance

In order to run your own instance of MCHoneyPot you will need the following:

  • An account and API key on https://www.abuseipdb.com/
  • A fresh Discord bot token
  • A MongoDB database with the following 4 collections: Pings, Joins, Servers, and Reports

To get started simpily:

git clone https://github.com/ScriptLineStudios/MCHoneyPot
cd MCHoneyPot
pip install -r requirements.txt
python run.py [LIST OF PORTS]

IMPORTANT NOTE: the abuseipdb wrapper must be installed manually from here: https://github.com/vsecades/AbuseIpDb

On you first run, you will be promopted to give your API keys/tokens to your newly created config file. Once you have done this you can run the script again and you should be good to go!

About

A Minecraft server honeypot built to report mass server scanning.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages