https://github.com/kyagara/hagelslag
Web and Minecraft (Java) server scanner written in C.
https://github.com/kyagara/hagelslag
c http minecaft mongoc mongodb multithreading scanner socket
Last synced: about 2 months ago
JSON representation
Web and Minecraft (Java) server scanner written in C.
- Host: GitHub
- URL: https://github.com/kyagara/hagelslag
- Owner: Kyagara
- License: apache-2.0
- Created: 2024-05-28T16:01:09.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2024-11-02T18:06:44.000Z (7 months ago)
- Last Synced: 2025-01-29T10:16:58.226Z (4 months ago)
- Topics: c, http, minecaft, mongoc, mongodb, multithreading, scanner, socket
- Language: C
- Homepage:
- Size: 112 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# hagelslag
cool scanner <(= w =)>
## Why
I have also made a [Go](https://github.com/Kyagara/hagelslag-go) version of this project, just because, it will probably have more features and actually be useful.
I wanted to practice some C and I've heard of scanners for Minecraft servers some time ago and decided to do something similar. I'm not following any guides or searching on how scanners (in general) work.
My idea with this project is to try and add as many features as I can just so I can try out things in C, this is just an educational project for me.
As I am not a C programmer, Im sure I am either not doing something the C way, or just being plain stupid. I am not following any standards, just solving my own problems, one of them being 'how the hell do I store 3.7 billion integers properly'.
The `hagelslag` name came from a friend, well, eating a [Hagelslag](https://en.wikipedia.org/wiki/Hagelslag).
Only Linux is supported.
## How
`hagelslag` works by generating all possible IP addresses, all 4.3 billion of them, in a loop, checking if they are [reserved](https://en.wikipedia.org/wiki/Reserved_IP_addresses) then sending them to a thread pool for scanning.
Each thread will retrieve an amount of `Task`s from the `Queue` and process these tasks.
A thread in a loop will block and for each task inside of it, it will execute the `x_connect` and `x_scan` functions of the specified scanner.
- `http`: send a `GET` request to that address. If successful (status code 2xx), it will read and add the response to the database, the response has a maximum size of 5 megabytes.
- `minecraft`: send a `handshake` request to that address. If successful, send a status request and read the response.
## Installing
Install the [mongoc driver libraries](https://www.mongodb.com/docs/languages/c/c-driver/current/libmongoc/tutorials/obtaining-libraries/installing/).
Run `make` in the project root. You can also pass flags to it, for example:
```
make SCANNER=MINECRAFT THREADS=16 DATABASE_URI=mongodb...
```
Use `make clean` after changing flags value, specially the `SCANNER` flag.
## Ideas
- As of now, `hagelslag` will take ages to finish scanning just once, use non-blocking sockets, maybe use libevent or something similar.
- Maybe add bedrocks servers to the Minecraft scanner.
- More error handling.
- Spread logging properly, right now its either too spammy or too little information being logged on some levels.
- Remove this weird virus that keeps adding Frieren in the code.