{"id":28468744,"url":"https://github.com/toshimichi0915/threescan","last_synced_at":"2025-07-01T14:31:13.968Z","repository":{"id":203885874,"uuid":"555585822","full_name":"Toshimichi0915/threescan","owner":"Toshimichi0915","description":"One of the most powerful Minecraft server scanners in the world.","archived":false,"fork":false,"pushed_at":"2024-05-25T15:57:24.000Z","size":141,"stargazers_count":17,"open_issues_count":1,"forks_count":2,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-07T08:08:18.162Z","etag":null,"topics":["java","minecraft","minecraft-scanner","port-scanner"],"latest_commit_sha":null,"homepage":"","language":"Java","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/Toshimichi0915.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}},"created_at":"2022-10-21T22:03:26.000Z","updated_at":"2025-04-16T09:43:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"7a74e0ba-b41c-4c12-983c-18ef9b8f1da5","html_url":"https://github.com/Toshimichi0915/threescan","commit_stats":null,"previous_names":["toshimichi0915/threescan"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Toshimichi0915/threescan","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Toshimichi0915%2Fthreescan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Toshimichi0915%2Fthreescan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Toshimichi0915%2Fthreescan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Toshimichi0915%2Fthreescan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Toshimichi0915","download_url":"https://codeload.github.com/Toshimichi0915/threescan/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Toshimichi0915%2Fthreescan/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262980952,"owners_count":23394437,"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":["java","minecraft","minecraft-scanner","port-scanner"],"created_at":"2025-06-07T08:08:23.076Z","updated_at":"2025-07-01T14:31:13.960Z","avatar_url":"https://github.com/Toshimichi0915.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# threescan\n\nThe most powerful Minecraft server scanner in the world.\n\n## Usage\n\n```bash\njava -jar threescan.jar \u003ctype\u003e \u003cmode\u003e \u003ctimeout\u003e \u003crate\u003e \u003cname\u003e \u003cuniqueId\u003e\n```\n\nwhere\n\n* type - the type of scan (simple, range, masscan, threescan)\n* mode - the mode of scan (fast, full)\n* timeout - the timeout of scan (in milliseconds)\n* rate - the rate of scan (scan per second)\n* name - the name of a player (used to determine server type)\n* uniqueId - the uniqueId of a player (used to determine server type)\n\n**It is highly encouraged to use this program with masscan on Linux for better performance.**\n\nIt is known that this program may cause some issues on Windows.\n\nIn order to use this program with masscan, you can use the following command:\n\n```bash\nmasscan -c masscan.conf 2\u003e/dev/null | java -jar threescan.jar masscan stdin 200 2000 \u003cusername\u003e \u003cuuid\u003e \u003e output.txt 2\u003eerror.txt\n```\n\nwhere\n\n* masscan.conf - the configuration file of masscan\n* username - the name of a player (which will be shown to scanned hosts)\n* uuid - the uniqueId of a player (specify a UUID that matches to the username from https://namemc.com)\n\n## Features\n\n* zero memory copy\n* asynchronous I/O\n* ability to determine server type\n\n## Types\n\nCurrently, there are 4 types: \"simple\", \"range\", \"masscan\", and \"threescan\".\n\n### Simple\n\nThis type is used to scan a single host.\n\n```text\n\u003chost\u003e\n127.0.0.1\n\u003chost\u003e \u003cport\u003e\n127.0.0.1 25565\n\u003chost\u003e \u003cportStart\u003e \u003cportEnd\u003e\n127.0.0.1 25565 25565\n```\n\n### Range\n\nThis type is used to scan a range of hosts.\n\n```text\n\u003cCIDR\u003e \u003cportStart\u003e \u003cportEnd\u003e\n127.0.0.1/24 25565 25565\n\n\u003cipv4Start\u003e-\u003cipv4End\u003e \u003cportStart\u003e \u003cportEnd\u003e\n127.0.0.1-127.0.0.255 25565 25565\n\n\u003cipv4\u003e \u003cportStart\u003e \u003cportEnd\u003e\n127.0.0.1 25565 25565\n```\n\n### Masscan\n\nThis type is used to combine the program with Masscan.\n\n```text\nDiscovered open port \u003cport\u003e/tcp on \u003cipv4\u003e\nDiscovered open port 25565/tcp on 127.0.0.1\n```\n\n### Threescan\n\nThis type is used to recheck the scan results of threescan.\n\n```text\n{\"host\":\"\u003chost\u003e\", \"port\":\u003cport\u003e, ...}\n{\"host\":\"127.0.0.1\", \"port\":25565, ...}\n```\n\n## Modes\n\nCurrently, there are 2 modes: \"fast\" and \"full\".\n\nWith full mode, additional packets are sent to determine server types. However, scans will be slower and a message will be shown to scanned hosts.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoshimichi0915%2Fthreescan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftoshimichi0915%2Fthreescan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoshimichi0915%2Fthreescan/lists"}