{"id":26989874,"url":"https://github.com/briiqn/serverfinder-pub","last_synced_at":"2026-05-03T06:32:09.069Z","repository":{"id":285767792,"uuid":"959265382","full_name":"Briiqn/ServerFinder-pub","owner":"Briiqn","description":"Funny Server Scanner","archived":false,"fork":false,"pushed_at":"2025-04-02T15:02:35.000Z","size":7,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-02T15:35:53.156Z","etag":null,"topics":["kotlin","mcprotocollib","minecraft-server-scanner","netty","server-scanner","server-scanning","tcp-protocol","viaversion"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Briiqn.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-04-02T14:08:15.000Z","updated_at":"2025-04-02T15:02:38.000Z","dependencies_parsed_at":"2025-04-02T15:46:12.289Z","dependency_job_id":null,"html_url":"https://github.com/Briiqn/ServerFinder-pub","commit_stats":null,"previous_names":["briiqn/serverfinder-pub"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Briiqn%2FServerFinder-pub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Briiqn%2FServerFinder-pub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Briiqn%2FServerFinder-pub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Briiqn%2FServerFinder-pub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Briiqn","download_url":"https://codeload.github.com/Briiqn/ServerFinder-pub/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247079433,"owners_count":20880050,"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":["kotlin","mcprotocollib","minecraft-server-scanner","netty","server-scanner","server-scanning","tcp-protocol","viaversion"],"created_at":"2025-04-03T21:22:31.072Z","updated_at":"2026-05-03T06:32:09.064Z","avatar_url":"https://github.com/Briiqn.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# ServerFinder\nA Minecraft server scanner that's indexed over 240,000 servers in the last 3 months.\n\n## What it does\nServerFinder scans the internet for Minecraft servers by targeting IP blocks owned by popular hosting providers. It uses a custom-patched version of MCProtocolLib with ViaVersion injected directly into the Netty pipeline, allowing it to connect to servers running different Minecraft versions without rewriting protocol handlers for each version.\n\n## Technical details\n- Built on [MCProtocolLib](https://github.com/GeyserMC/MCProtocolLib) with [ViaVersion](https://github.com/ViaVersion/ViaVersion) integration\n- Connects to servers across all versions (1.8.x through 1.21.x) (Currently Native 1.21.5 (770) )\n- Supports full online mode authentication (premium accounts)\n- Netty pipeline modifications specifically for ViaVersion support \n- Multi threaded scanning (zoom performance)\n\n## Server discovery\nThe scanner finds servers by:\n- Pulling IP blocks from ASN databases (OVH, Hetzner, AWS, etc.)\n- Port scanning common Minecraft ports (to bypass honeypots we just start the handshake with an absurd client version and see what the server responds with)\n- Picking ranges at random so its less likely to come across duplicates (we already check every ip it scans against db)\n- Filtering results based on connection patterns\n\nCurrently indexed 240,000+ unique servers since February 2025.\n\n## Data collection capabilities\n- Server version and mods detection (from ping)\n- Player count and MOTD parsing (from ping and in game)\n- Entity position tracking\n- Player placed block detection (e.g diamond blocks, wood planks etc etc)\n- Web map discovery (Dynmap, BlueMap, etc.)\n- Misconfigured Bungeecord detection (UUID spoofing)\n\n## Database Statistics\n- **Total Servers**: 240,978\n\n### Server Distribution by Country (As of May 30, 2025)\n| Country | Servers | Percentage |\n|---------|---------|------------|\n| United States | 110,159 | 45.7% |\n| Germany | 31,551 | 13.1% |\n| Japan | 18,060 | 7.5% |\n| Canada | 10,809 | 4.5% |\n| United Kingdom | 8,424 | 3.5% |\n| France | 7,927 | 3.3% |\n| China | 7,622 | 3.2% |\n| Netherlands | 5,179 | 2.1% |\n| Australia | 4,912 | 2.0% |\n| Sweden | 2,991 | 1.2% |\n\n### Geographic Coverage\n- **Total Countries**: 138\n- **Countries with 100+ servers**: 52\n\n### System Status\n- Status: **Operational**\n- Last update: Friday, 30 May 2025 19:36\n\n## Requirements (If I ever release it)\n- Java 11+\n- Premium Minecraft account(s)\n- Fast network connection\n\n## Notes\nThis tool is a personal project for Minecraft server research and analysis, not for malicious purposes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbriiqn%2Fserverfinder-pub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbriiqn%2Fserverfinder-pub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbriiqn%2Fserverfinder-pub/lists"}