{"id":23625106,"url":"https://github.com/defective4/ngrok-minecraft-scanner","last_synced_at":"2025-11-07T10:30:28.269Z","repository":{"id":269470559,"uuid":"907530290","full_name":"Defective4/ngrok-minecraft-scanner","owner":"Defective4","description":"A scanner utility for Minecraft servers shared over ngrok.","archived":false,"fork":false,"pushed_at":"2024-12-23T21:31:14.000Z","size":21,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-13T10:38:11.232Z","etag":null,"topics":["minecraft","ngrok","scanner","server"],"latest_commit_sha":null,"homepage":"","language":"Java","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/Defective4.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-12-23T19:51:45.000Z","updated_at":"2024-12-23T21:31:16.000Z","dependencies_parsed_at":"2024-12-23T20:20:12.005Z","dependency_job_id":"07e51bd3-8314-44a9-86ee-d11004a6c4fd","html_url":"https://github.com/Defective4/ngrok-minecraft-scanner","commit_stats":null,"previous_names":["defective4/ngrok-minecraft-scanner"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Defective4%2Fngrok-minecraft-scanner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Defective4%2Fngrok-minecraft-scanner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Defective4%2Fngrok-minecraft-scanner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Defective4%2Fngrok-minecraft-scanner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Defective4","download_url":"https://codeload.github.com/Defective4/ngrok-minecraft-scanner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239525715,"owners_count":19653382,"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":["minecraft","ngrok","scanner","server"],"created_at":"2024-12-27T21:21:23.305Z","updated_at":"2025-11-07T10:30:28.238Z","avatar_url":"https://github.com/Defective4.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ngrok Minecraft scanner\n\nA scanner utility for Minecraft servers shared over ngrok.  \n\n\u003e **Disclaimer**  \n\u003e This software was made for educational purposes **only**.  \n\u003e I take absolutely no reponsibility for any harm done to unprotected servers discovered using this tool.  \n\u003e Remember to always enable whitelist and/or online mode on your servers when sharing them over the Internet!\n\n# About\nngrok Minecraft scanner is a simple server scanning tool that scans all of ngrok's IPs and ports in search for Minecraft servers.  \nIt allows you to scan for servers on all versions, as well as servers with `enable-status` set to false, therefore not visible to Minecraft's regular status check.\n\n# Command arguments\n```\nUsage: java -jar ngrok-minecraft-scanner.jar [options...]\n\nA scanner utility for Minecraft servers shared over ngrok.\n\n -d               Don't resolve ngrok hostnames\n -J               Try detecting servers with disabled listings.\n                    Makes the scan take more time.\n                    May result in false positives.\n -L               Force ONLY legacy server list ping.\n -h               Display help\n -j               Output data in JSON format.\n -l               Fall back to legacy server list ping, in case the first attempt fails.\n                    Makes the scan take more time.\n -y               Assume \"yes\" to all questions.\n -f=\u003cfile\u003e        Target file, where discovered servers will be saved.\n                    This option won't suppress standard output\n -p=\u003cpvn\u003e         Protocol version number used for standard ping.\n                    Usually you can just leave it at default (754).\n -r=\u003cregion\u003e      ngrok region.\n                    EU - Europe,\n                    US - United States (default)\n -e               Don't print servers with no online players.\n -t=\u003cthreads\u003e     Number of threads to use for scanning.\n                    Default: 2\n -o=\u003ctimeout ms\u003e  How many milliseconds should a connection take before timing out.\n                    Default: 1000\n -v               Be more verbose\n```\n\n# Usage\n\n## Run a simple scan\n```bash\njava -jar ngrok-minecraft-scanner.jar -t=4 -o=2500 -r=eu -f=servers.txt\n```\nThis command will scan all ngrok's addresses using 4 separate threads in the `eu` (Europe) region.  \nAll discovered servers will be saved to a file named `servers.txt`.\n\n### About threads and timeouts\nHigher thread counts can drastically increase scanning speed, but some servers might not get discovered, depending on your network connection.  \nTry different thread values, and see what works the best in your case.  \nThread count of 4 to 16 is a safe value.  \n\nLower timeout times can (usually only slightly) decrease scanning time, but servers with high latency might get ommitted.  \nTimeout of 2500ms is a pretty safe value\n\n## Scan for unlisted servers\nSome servers might have `enable-status` set to false in their properties. In that case they won't get discovered using normal pinging.  \nYou can use the `-J` option to try to discover unlisted servers.  \nThe scanner will then make an attempt to \"join\" the server (if it didn't respond to standard ping) using invalid protocol ID. If the server responds with a disconnect packet, it means it's online.  \n\nExample:\n```bash\njava -jar ngrok-minecraft-scanner.jar -t=4 -o=2500 -r=eu -J\n```\nRemember that enabling this option will slow down the scanning process!  \nAlso it's not possible to get any info (player count, description, version) about servers discovered using this method.\n\n## Download\nYou can download latest version in [Releases section](https://github.com/Defective4/ngrok-minecraft-scanner/releases/latest)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdefective4%2Fngrok-minecraft-scanner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdefective4%2Fngrok-minecraft-scanner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdefective4%2Fngrok-minecraft-scanner/lists"}