How siebrum/minecraft-server-discovery works
The product discovers public Minecraft servers, enriches reachable servers with status and location data, stores them, and presents the results in an Angular website. Its main workflow is manually started IP-range scanning, submission of open hosts to the API, server probing and persistence, then browsing or refreshing records in the website. The README documents these capabilities; some implementation relationships below rely on its statements and the SOURCE INDEX because the corresponding source was not excerpted.
Main entry points: MainController.cs Discovery API · DatabaseContext.cs Database context · Converters.cs Data conversion · Program.cs Range scanner
Components 21
Server discovery
- Range scanner
backend/MasscanWrapper/Program.cs - IP ranges
backend/MasscanWrapper/IpRanges.cs
API and enrichment
- Discovery API
backend/MinecraftServerDiscoveryApi/Controllers/MainController.cs - Status probe
backend/MinecraftServerDiscoveryApi/Controllers/MainController.cs - Data conversion
backend/MinecraftServerDiscoveryApi/Helpers/Converters.cs - Geo enrichment
backend/MinecraftServerDiscoveryApi/Helpers/GeoLocationHelper.cs - Geo response DTO
backend/MinecraftServerDiscoveryApi/DTO/ExternalGeoLocationInformation.cs - Server model
backend/MinecraftServerDiscoveryApi/Models/Server.cs - Geo model
backend/MinecraftServerDiscoveryApi/Models/GeoInformation.cs - Player model
backend/MinecraftServerDiscoveryApi/Models/Player.cs - Database context
backend/MinecraftServerDiscoveryApi/Contexts/DatabaseContext.cs
Website
- Angular application
website/src/app/app.component.ts - Server listing
website/src/app/app-home-page/app-home-page.component.ts - Side menu
website/src/app/app-side-menu-bar/app-side-menu-bar.component.ts - API client
website/src/app/api.service.ts - Server contract
website/src/app/models/server.model.ts - API configuration
website/src/environments/environment.ts
Other components
- Operator
- Minecraft servers
- MySQL database
- Google Maps
Connections 24
- Operator → Range scanner: starts manually
README.md - Range scanner → IP ranges: uses ranges
backend/MasscanWrapper/Program.cs - Range scanner → Minecraft servers: scans hosts
README.md - Range scanner → Discovery API: submits open hosts
README.md - Discovery API → Status probe: probes server
backend/MinecraftServerDiscoveryApi/Controllers/MainController.cs - Status probe → Minecraft servers: queries status
backend/MinecraftServerDiscoveryApi/Controllers/MainController.cs - Discovery API → Data conversion: converts status
backend/MinecraftServerDiscoveryApi/Controllers/MainController.cs - Discovery API → Geo enrichment: requests location
backend/MinecraftServerDiscoveryApi/Controllers/MainController.cs - Geo enrichment → Data conversion: converts location
backend/MinecraftServerDiscoveryApi/Helpers/GeoLocationHelper.cs - Data conversion → Geo response DTO: maps fields
backend/MinecraftServerDiscoveryApi/Helpers/Converters.cs - Data conversion → Server model: creates records
backend/MinecraftServerDiscoveryApi/Helpers/Converters.cs - Data conversion → Geo model: creates records
backend/MinecraftServerDiscoveryApi/Helpers/Converters.cs - Discovery API → Database context: reads and writes
backend/MinecraftServerDiscoveryApi/Controllers/MainController.cs - Database context → Server model: persists
backend/MinecraftServerDiscoveryApi/Contexts/DatabaseContext.cs - Database context → Geo model: persists
backend/MinecraftServerDiscoveryApi/Contexts/DatabaseContext.cs - Database context → Player model: persists
backend/MinecraftServerDiscoveryApi/Contexts/DatabaseContext.cs - Database context → MySQL database: connects to
backend/MinecraftServerDiscoveryApi/Contexts/DatabaseContext.cs - Angular application → Server listing: hosts
website/src/app/app.module.ts - Angular application → Side menu: hosts
website/src/app/app.module.ts - Server listing → API client: loads and refreshes
website/src/app/app-home-page/app-home-page.component.ts - API client → API configuration: uses URL
website/src/app/api.service.ts - Server listing → Google Maps: opens location
website/src/app/app-home-page/app-home-page.component.ts - API client → Discovery API: requests records
README.md - API client → Server contract: uses response type
website/src/app/api.service.ts