requirements:
docker
docker-compose
Clone the Repository
https://github.com/Besix2/mc_scan.git
Enter the mc_scan directoy
cd /mc_scan/container
Enter you discord token (explaination below)
nano config.txt
Start the container
docker-compose up
To use the discord bot you have to create a application on discord. To do this go to the discord developer portal. If you cant acces this you need to turn on developer mode in discord.
-
create the application
-
activate intents and copy the token
-
give the bot permissions and invite it
In the config.txt are 3 lines.
The first one is the rate for masscan.
The second is the wait time for masscan.
The third one is your discord token.
Tweaking the values for masscan can lead to performance increase but it can also crash your internet. I suggest you check out masscan github for more info.
Once the container is started you can check his logs using
docker logs scanner
To shutdown the container(you need to be in /mc_scan/container)
docker-compose down
The entrys to the database can be manually viewed using mongo compass.
mongodb://<your-ip>:27017/
This script scans the web for minecraft server in the range from 0.0.0.0/16 to 0.0.0.0/8. If a server is found information is pulled asynchrous, using celery and rabbitmq as broker, with mc_status This information than gets saved to a mongodb database. This database can be accesed using a Discord Bot which is written with hikari-lightbulb.
This is my first project of this size so if you have any suggestions just open a issue.