{"id":22337613,"url":"https://github.com/scriptlinestudios/mchoneypot","last_synced_at":"2025-10-14T17:30:56.012Z","repository":{"id":227997358,"uuid":"772894607","full_name":"ScriptLineStudios/MCHoneyPot","owner":"ScriptLineStudios","description":"A Minecraft server honeypot built to report mass server scanning.","archived":false,"fork":false,"pushed_at":"2024-03-17T09:02:12.000Z","size":14344,"stargazers_count":6,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-07T09:40:01.196Z","etag":null,"topics":["honeypot","minecraft","serverscanning"],"latest_commit_sha":null,"homepage":"https://discord.gg/7QSnA726dx","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ScriptLineStudios.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2024-03-16T07:00:21.000Z","updated_at":"2024-08-20T22:52:48.000Z","dependencies_parsed_at":null,"dependency_job_id":"aea1a020-663e-4f27-84f9-e59c47f118ae","html_url":"https://github.com/ScriptLineStudios/MCHoneyPot","commit_stats":null,"previous_names":["scriptlinestudios/mchoneypot"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ScriptLineStudios/MCHoneyPot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScriptLineStudios%2FMCHoneyPot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScriptLineStudios%2FMCHoneyPot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScriptLineStudios%2FMCHoneyPot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScriptLineStudios%2FMCHoneyPot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ScriptLineStudios","download_url":"https://codeload.github.com/ScriptLineStudios/MCHoneyPot/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ScriptLineStudios%2FMCHoneyPot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279020077,"owners_count":26086806,"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","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["honeypot","minecraft","serverscanning"],"created_at":"2024-12-04T06:10:44.354Z","updated_at":"2025-10-14T17:30:53.928Z","avatar_url":"https://github.com/ScriptLineStudios.png","language":"Python","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg align=\"center\" src=\"https://static.wikia.nocookie.net/minecraft_gamepedia/images/3/33/Bee_with_nectar_%28angry%29.png/revision/latest/scale-to-width-down/250?cb=20200317174807\"\u003e\u003c/img\u003e\n\u003c/p\u003e\n\u003ch1 align=\"center\"\u003e\u003cb\u003eMCHoneyPot\u003c/b\u003e\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Python-3776AB?logo=python\u0026logoColor=fff\u0026style=for-the-badge\"\u003e\u003c/img\u003e\n  \u003cimg src=\"https://img.shields.io/github/repo-size/ScriptLineStudios/MCHoneyPot?style=%22for-the-badge%22\"\u003e\u003c/img\u003e\n  \u003cimg src=\"https://img.shields.io/github/last-commit/ScriptLineStudios/MCHoneyPot?style=%22for-the-badge%22\"\u003e\u003c/img\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca target=\"_blank\" style=\"display: none;\" href=\"https://discord.gg/7QSnA726dx\"\u003e\n    \u003cimg src=\"https://dcbadge.vercel.app/api/server/7QSnA726dx\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\nA Minecraft server honeypot built to report mass server scanning. \n\u003c/p\u003e\n\n## About\n\nMCHoneyPot works by creating realistic looking Minecraft server, faking details such as players online, server version etc. \nIt's job is to log all attempts made to interact with the server including pings, status requests, and attempts to join.\nThe goal is to index, report, and raise awareness of mass server scanning and how it can affect server owners.\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://github.com/ScriptLineStudios/MCHoneyPot/assets/85095943/a531528a-0d4e-495b-bc76-59c322fdab8a\"\u003e\n\u003c/p\u003e\n\nAll interactions made with the server are logged:\n\n![Screenshot from 2024-03-16 09-23-43](https://github.com/ScriptLineStudios/MCHoneyPot/assets/85095943/0ec9e6bf-3b07-43d4-95e4-53162bdb896f)\n\n![Screenshot from 2024-03-16 18-50-55](https://github.com/ScriptLineStudios/MCHoneyPot/assets/85095943/54f13d77-7bce-4f5b-aab3-8066b9c4edb4)\n\nAdditionally reports are made to https://www.abuseipdb.com/  \n\n## Getting Started\n\nIf you would simplily like to interact with the hosted version of the bot, you can do so by joining our \u003ca href=\"https://discord.gg/7QSnA726dx\"\u003eDiscord Server\u003c/a\u003e where you can feel free to interact with the bot as you please.\n\nAlternatively you can invite the bot to your own server using the following \u003ca href=\"https://discord.com/oauth2/authorize?client_id=1216381150910742558\u0026permissions=826781321280\u0026scope=bot\"\u003einvite\u003c/a\u003e\nOnce the bot is in your server run /configure in the channel where you would like the bot to output logs!\n\n![Screenshot from 2024-03-16 18-49-27](https://github.com/ScriptLineStudios/MCHoneyPot/assets/85095943/cd280f9e-ae4b-42e1-9c47-fd4fca704c34)\n\n## Running your own instance\n\nIn order to run your own instance of MCHoneyPot you will need the following:\n\n* An account and API key on https://www.abuseipdb.com/\n* A fresh Discord bot token\n* A MongoDB database with the following 4 collections: ```Pings```, ```Joins```, ```Servers```, and ```Reports```\n\nTo get started simpily:\n```bash\ngit clone https://github.com/ScriptLineStudios/MCHoneyPot\ncd MCHoneyPot\npip install -r requirements.txt\npython run.py [LIST OF PORTS]\n```\n\u003cb\u003eIMPORTANT NOTE:\u003c/b\u003e the abuseipdb wrapper must be installed manually from here: https://github.com/vsecades/AbuseIpDb\n\nOn 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!\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscriptlinestudios%2Fmchoneypot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscriptlinestudios%2Fmchoneypot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscriptlinestudios%2Fmchoneypot/lists"}