Minescrap

A minecraft server finder inspired by Copenheimer.

hippity hoppity, your server's ip is now my property

Features :

• ⚡️ Fast , uses masscan to scan IPs in real-time.
• 🌐 Express API to query found servers and players with a wide variety of filters.
• 🗃️ Multi database support to store found servers.
• 🎨 Fancy colored command line outputs.

Installation & Setup :

git clone https://github.com/GaspardCulis/minescrap.git
cd minescrap
npm i

Setup database

Supported databases:

• 
• (soon)

First choose your DB by editing src/search.ts, currently defaults to Supabase.

Then edit the fields corresponding to your database in .env.example and rename it to .env to setup your database credentials.

Usage :

Run a search :

npx ts-node src/search.ts -v

Command line arguments :

• -v Verbose found servers info.
• -r number The masscan max packet per second rate, defaults to 10000pps.

Run the api :

npx ts-node src/api.ts

Base url :

http://localhost:6969

All of the API routes are given in the base URL page.

Web interface

I made a simple web app that displays the found servers and players count in real time. I plan to add a feature to search for servers.