{"id":24489721,"url":"https://github.com/birdroad1/server-pinger","last_synced_at":"2026-04-14T18:33:09.516Z","repository":{"id":272090021,"uuid":"914617314","full_name":"BirdRoad1/server-pinger","owner":"BirdRoad1","description":"Server pinger for Minecraft written in C++","archived":false,"fork":false,"pushed_at":"2025-01-20T09:55:18.000Z","size":217,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-23T00:02:10.113Z","etag":null,"topics":["cpp","crawler","make","minecraft","minecraft-scanner","postgres","scanner","server"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BirdRoad1.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,"zenodo":null}},"created_at":"2025-01-10T00:29:47.000Z","updated_at":"2025-01-20T09:55:19.000Z","dependencies_parsed_at":"2025-01-12T03:22:51.006Z","dependency_job_id":"b5166a53-e664-48ae-bad7-8c05dba6abcb","html_url":"https://github.com/BirdRoad1/server-pinger","commit_stats":null,"previous_names":["birdroad1/server-pinger"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/BirdRoad1/server-pinger","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BirdRoad1%2Fserver-pinger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BirdRoad1%2Fserver-pinger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BirdRoad1%2Fserver-pinger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BirdRoad1%2Fserver-pinger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BirdRoad1","download_url":"https://codeload.github.com/BirdRoad1/server-pinger/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BirdRoad1%2Fserver-pinger/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261386701,"owners_count":23150865,"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":["cpp","crawler","make","minecraft","minecraft-scanner","postgres","scanner","server"],"created_at":"2025-01-21T17:15:42.023Z","updated_at":"2025-10-18T20:36:10.964Z","avatar_url":"https://github.com/BirdRoad1.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MCPinger\n\nEasy-to-use tool written in C++ that can scan the entire internet (or IP ranges of your choosing) for Minecraft servers. This tool leverages the Minecraft protocol's `Server List Ping` system documented [here](https://minecraft.wiki/w/Minecraft_Wiki:Projects/wiki.vg_merge/Server_List_Ping).\n\nThis tool only supports Linux-based operating systems. Windows and macOS will not be considered.\n\nCurrently, this tool requires a PostgreSQL database to store data in.\n\nTo use this program, follow the steps in the `Building` section. Then, create a \"cidrs.txt\" file and enter a list of IP ranges in CIDR notation. Next, create a \"db.txt\" file with the url of the PostgreSQL database (an example is available in db.txt.example). Finally, run the binary.\n\n# Masscan\n\nThis project currently isn't as fast as I'd like it to be. However, you can use [Masscan](https://github.com/robertdavidgraham/masscan) to initially scan for hosts with their port 25565 open to reduce the number of IPs to scan. Here's an example command:\n\n```bash\nmasscan 0.0.0.0/0 -p25565 --excludefile exclude.conf -oX output.xml --rate 1000000\n```\n\nNext, you can run:\n\n```bash\npython3 scripts/convertMasscanOutput.py\n```\n\nto convert output.xml to a plaintext list of IP addresses (which will be stored in output.txt).\n\nFinally, you can run this program to look for online Minecraft servers in the list.\n\n# Building\n\nInstall the required dependencies (Ubuntu):\n\n```bash\nsudo apt-get install libpqxx-dev libpq-dev g++ make cmake\n```\n\nGenerate the Makefile using CMake:\n\n```bash\ncmake .\n```\n\nCompile the tool:\n\n```bash\nmake\n```\n\nThe binary will be at `./bin/mcpinger`\n\n# Contributions\n\nAll contributions are welcome. To contribute, you can create an Issue or Pull Request. Feature requests are also welcome.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbirdroad1%2Fserver-pinger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbirdroad1%2Fserver-pinger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbirdroad1%2Fserver-pinger/lists"}