https://github.com/scriptlinestudios/mchoneypot

A Minecraft server honeypot built to report mass server scanning.
https://github.com/scriptlinestudios/mchoneypot

honeypot minecraft serverscanning

Last synced: 4 months ago
JSON representation

A Minecraft server honeypot built to report mass server scanning.

• Host: GitHub
• URL: https://github.com/scriptlinestudios/mchoneypot
• Owner: ScriptLineStudios
• License: mit
• Created: 2024-03-16T07:00:21.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2024-03-17T09:02:12.000Z (almost 2 years ago)
• Last Synced: 2025-04-07T09:40:01.196Z (11 months ago)
• Topics: honeypot, minecraft, serverscanning
• Language: Python
• Homepage: https://discord.gg/7QSnA726dx
• Size: 13.7 MB
• Stars: 6
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


  



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](https://github.com/ScriptLineStudios/MCHoneyPot/assets/85095943/0ec9e6bf-3b07-43d4-95e4-53162bdb896f)

![Screenshot from 2024-03-16 18-50-55](https://github.com/ScriptLineStudios/MCHoneyPot/assets/85095943/54f13d77-7bce-4f5b-aab3-8066b9c4edb4)

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](https://github.com/ScriptLineStudios/MCHoneyPot/assets/85095943/cd280f9e-ae4b-42e1-9c47-fd4fca704c34)

## 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:

```bash

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!