https://github.com/urpagin/minecrafthoneypot

A simple Minecraft IP logger honeypot in C.
https://github.com/urpagin/minecrafthoneypot

honeypot honeypot-minecraft minecraft packets protocol tcp

Last synced: 20 days ago
JSON representation

A simple Minecraft IP logger honeypot in C.

• Host: GitHub
• URL: https://github.com/urpagin/minecrafthoneypot
• Owner: Urpagin
• License: gpl-3.0
• Created: 2024-06-27T09:39:10.000Z (8 months ago)
• Default Branch: master
• Last Pushed: 2024-11-28T22:29:23.000Z (2 months ago)
• Last Synced: 2024-11-28T22:30:11.331Z (2 months ago)
• Topics: honeypot, honeypot-minecraft, minecraft, packets, protocol, tcp
• Language: C
• Homepage:
• Size: 49.8 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# Minecraft Honeypot

Simple Minecraft honeypot (IP logger) written in C.

# How to build

1. Clone the repo (or download `main.c`)

2. `gcc main.c -o honeypot`

3. `./honeypot`

# Compatibility

## Architecture

- Linux: Working

- macOS: Not Tested (but should work)

- Windows: Not Working (as we are using `sys/socket.h`, a POSIX-specific header not available on Windows)

## Minecraft clients

According to the [Minecraft protocol wiki](https://wiki.vg/Server_List_Ping), this implementation is compatible from and including Java Edition 1.7 to the latest versions.

This implementation is compatible with Minecraft Java Edition versions 1.7 and newer, as per the [Minecraft protocol wiki](https://wiki.vg/Server_List_Ping).

You can change the server version by modifying the JSON in the source code, by changing the `name` and `protocol` fields.

# How does it work?

First, the program mimics the Minecraft [Server List Ping (SLP)](https://wiki.vg/Server_List_Ping) protocol, to only implement the part that accepts a TCP connection and sends back the bare minimum.

But then, by accepting a connection the client gives out its IP address, after that we just log it into a file.

For more detail, please read the blog post in the ["Why" section](#why).

# Illustrations

![minecraft multiplayer servers tab](https://github.com/user-attachments/assets/38b2988a-daf1-42ea-aaf6-c2e0b379d481)

![ip logs](https://github.com/Urpagin/MinecraftHoneypot/assets/72459611/0a5a6993-2d1d-4c07-85cf-4964f43631ed)

*(Note: I only used the honeypot locally, which is why all the addresses are 127.0.0.1.)*

# Code Quality Disclaimer

I have never properly learnt C, nor made any project in that language. That said, the code works, but I doubt the quality of it.

# Why

Written for : https://blog.urpagin.net/coding-a-minecraft-honeypot/

I wrote this blog post because experimenting with sockets and Minecraft is genuinely enjoyable!