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:

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!

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!