retscan

rust minecraft server scanner

how it works

it scans known CIDRs of popular minecraft hosts such as Apex or Shockbyte. a custom CIDR can also be specified. it scans the most common ports open for Minecraft servers. it only lists online servers.

how to

git clone https://github.com/retuci0/retscan.git cd retscan cargo run

args

--output <file>: where to save the results. defaults to servers.jsonl --cidr <ip range>: ip range cidr to scan

filters

--min-online-player-count <count>: minimum amount of players to be online --max-online-player-count <count>: maximum amount of players to be online --description-contains <needle>: piece of text that the motd of the server should contain --version-contains <needle>: piece of text that the version name of the server should contain --with-mod <mod id>: the server should contain this mod --without-mod <mod id>: the server should not contain this mod --with-plugin <plugin name>: the server should contain this plugin --without-plugin <plugin name>: the server should not contain this plugin