{"id":21612066,"url":"https://github.com/lockblock-dev/minepot","last_synced_at":"2025-07-29T04:03:57.099Z","repository":{"id":142757862,"uuid":"612921507","full_name":"LockBlock-dev/MinePot","owner":"LockBlock-dev","description":"Minecraft server honeypot","archived":false,"fork":false,"pushed_at":"2024-07-17T15:51:36.000Z","size":68,"stargazers_count":20,"open_issues_count":4,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-03-25T03:34:51.038Z","etag":null,"topics":["golang","honeypot","minecraft","minecraft-protocol"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/LockBlock-dev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"ko_fi":"lockblock"}},"created_at":"2023-03-12T11:42:58.000Z","updated_at":"2025-01-28T19:46:34.000Z","dependencies_parsed_at":"2024-07-17T19:27:20.101Z","dependency_job_id":null,"html_url":"https://github.com/LockBlock-dev/MinePot","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LockBlock-dev%2FMinePot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LockBlock-dev%2FMinePot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LockBlock-dev%2FMinePot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/LockBlock-dev%2FMinePot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/LockBlock-dev","download_url":"https://codeload.github.com/LockBlock-dev/MinePot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248348677,"owners_count":21088898,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["golang","honeypot","minecraft","minecraft-protocol"],"created_at":"2024-11-24T21:16:33.291Z","updated_at":"2025-04-11T05:35:27.998Z","avatar_url":"https://github.com/LockBlock-dev.png","language":"Go","readme":"# MinePot\n\n[![GitHub stars](https://img.shields.io/github/stars/LockBlock-dev/MinePot.svg)](https://github.com/LockBlock-dev/MinePot/stargazers)\n\nMinePot is a Minecraft Server Honeypot made in Golang. Its goal is to catch Minecraft Server Scanners by listening for [Handshake](https://wiki.vg/Protocol#Handshake) and [Ping](https://wiki.vg/Protocol#Status) packets.\n\nSee the [changelog](/CHANGELOG.md) for the latest updates.\n\n## Table of content\n\n-   [**Features**](#features)\n-   [**Installation**](#installation)\n-   [**Compiling from source**](#compiling-from-source)\n-   [**Configuring MinePot**](#configuring-minepot)\n-   [**Config details**](#config-details)\n-   [**FAQ**](#faq)\n-   [**Credits**](#credits)\n-   [**Copyright**](#copyright)\n\n## Features\n\n-   Listen on any TCP port for incoming Minecraft packets\n-   Answer [Handshake](https://wiki.vg/Protocol#Handshake) packets\n-   Answer [Ping](https://wiki.vg/Protocol#Status) packets\n-   Artificial random ping\n-   Custom Status Response :\n    -   Custom version or version mirroring (send the received protocol/version)\n    -   Fake players\n    -   Custom MOTD\n    -   Custom favicon\n    -   Random protocol/version\n-   IP reporting to [Abuse IP DB](https://www.abuseipdb.com/)\n-   IP reporting to a Discord Webhook\n-   History as a [CSV](https://en.wikipedia.org/wiki/Comma-separated_values) formatted .history file\n\n## Installation\n\nYou can use Docker or install MinePot manually. Here's how:\n\n-   Download [go](https://go.dev/dl/) (go 1.20 required).\n-   Download or clone the project.\n-   Download the binary from the [Releases](../../releases) or [build it](#compiling-from-source) yourself.\n-   [Configure MinePot](#configuring-minepot).\n-   Edit the `ExecStart` line in [`minepot.service`](/minepot.service) to the MinePot binary location.  \n    e.g.: `ExecStart=/home/YOUR_USERNAME/MinePot/MinePot`\n-   Install MinePot by using [`install.sh`](/install.sh). It will setup the tool and start it as a service for you.\n\n## Compiling from source\n\n-   Use [`build.sh`](/build.sh) or use `go build`\n\n## Configuring MinePot\n\nIf you already used [`install.sh`](/install.sh), the config can be found in `/etc/minepot/config.json`.\n\n-   Open the [`config`](/config.json) in your favorite editor.\n-   Enable the features you want to use. See [Config details](#config-details) for in-depth explanations.\n-   Edit the Status Response as you want. You can use [mctools MOTD creator](https://mctools.org/motd-creator) for the MOTD.\n-   Change the `faviconPath` to any PNG image you want to use.\n\n## Config details\n\n| Item               | Values                                                     | Meaning                                                             |\n| ------------------ | ---------------------------------------------------------- | ------------------------------------------------------------------- |\n| debug              | `boolean`                                                  | Enable debug logs                                                   |\n| writeLogs          | `boolean`                                                  | Enable logs file                                                    |\n| logFile            | `text`                                                     | Path to the logs file                                               |\n| writeHistory       | `boolean`                                                  | Enable history file                                                 |\n| historyFile        | `text`                                                     | Path to the history file                                            |\n| port               | `number`                                                   | TCP port to listen on                                               |\n| pingDelayMinMs     | `number`                                                   | Minimum artificial server ping (in milliseconds)                    |\n| pingDelayMaxMs     | `number`                                                   | Maximum artificial server ping (in milliseconds)                    |\n| idleTimeoutS       | `number`                                                   | Time to wait before the connection times out                        |\n| reportThreshold    | `number`                                                   | Amount of packets before being reported                             |\n| abuseIPDBReport    | `boolean`                                                  | Enable Abuse IP DB reports                                          |\n| abuseIPDBKey       | `text`                                                     | Abuse IP DB API key                                                 |\n| abuseIPDBCooldownH | `number`                                                   | Cooldown between each reports (in hours)                            |\n| webhookReport      | `boolean`                                                  | Enable Discord webhook reports                                      |\n| webhookUrl         | `text`                                                     | Discord webhook URL                                                 |\n| webhookCooldownH   | `number`                                                   | Cooldown between each reports (in hours)                            |\n| webhookEmbedColor  | `text`                                                     | Embed hex color                                                     |\n| randomVersion      | `boolean`                                                  | Enable random Minecraft version and protocol in the status response |\n| statusResponse     | `boolean`                                                  | Enable Status Response                                              |\n| statusResponseData | [`JSON`](https://wiki.vg/Server_List_Ping#Status_Response) | Minecraft Status Reponse data                                       |\n| faviconPath        | `text`                                                     | Path to the favicon PNG image                                       |\n\n## FAQ\n\n-   Q: Do you plan to release a Windows version?  \n    A: No.\n\n## Credits\n\n-   [Wiki.vg](https://wiki.vg) Minecraft protocol documentation\n-   [go-mc](https://github.com/Tnze/go-mc) Minecraft protocol implementation\n\n## Copyright\n\nSee the [license](/LICENSE).\n","funding_links":["https://ko-fi.com/lockblock"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flockblock-dev%2Fminepot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flockblock-dev%2Fminepot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flockblock-dev%2Fminepot/lists"}