SpaceInvador

This project is abandoned. I'm developing a better version at https://github.com/CUBUS-mc

A Copenheimer like bot.

The bot can scan for Minecraft Server and can run recon on the scanned servers.

Features

• Scanning for Minecraft Servers
• Collect data about scanned servers
• Host a Discord bot to interact with data
• Host website with Statistics and controlles

Data that gets collected

• ip
• port
• Online Players (Name + uuid)
• Max Players
• Version
• Description
• Plugins
• Type (e.g. SMP)
• Whitelist (enabled or not)
• Ping
• Last time it was scanned
• Country
• Rcon Port usable
• A timeliene of the Data
• Open Ports
• CVEs on Server
• Hostname

Todo

• Add Minecraft bots to join all servers and collect even more data
• More Statistics
• Dockerizaton
• Add Mc bots to join server and interact with server (e.g. build schematic or chat on server)
• Proxy to connect to Servers safely and give them more abilitys through custom commands

 __          _______ _____    _ 
 \ \        / /_   _|  __ \  | |
  \ \  /\  / /  | | | |__) | | |
   \ \/  \/ /   | | |  ___/  | |
    \  /\  /   _| |_| |      |_|
     \/  \/   |_____|_|      (_)

This Project ist still work in progress and not very useable at the moment. Also please DON'T use it for griefing.

Usage

1. Setup the DB
2. Run the main.py scrips

How to setup the Database

Sqlite:

1. Rename the templatDB.db file to anything you like

Postgres:

1. Edit the username, password and db name in the Dockerfile
2. Build the Docker Container with:

   docker build -t spaceinvador-image .
   

3. Run the Docker Container with:

   docker run -d --name spaceinvador-container -p 5432:5432 spaceinvador-image
   

Commands

help:

• Description: Show all commands
• Usage: help

scan:

• Description: Scan for new Minecraft servers
• Usage: scan

webApp:

• Description: Start the web app
• Usage: webApp

stop:

• Description: Stop threads
• Usage: stop

server:

• Description: Returns a joinable server
• Usage: server [-v Version] [-o (should people be online)] [-m minutes (how long ago the server was online)] [-n int/all (number of servers to return)] [-c (copy to clipboard)] [-w (ensure server has no whitelist)] [-u update the data of hte current server ]

exit:

• Description: Exit the program
• Usage: exit

update:

• Description: Update the data in the database
• Usage: update [-a (advanced)] [-j version (join server on version for whitelist scan)] [-b int (batch size)] [-s (Shodan lookup)]

discord:

• Description: Start the discord bot
• Usage: discord

watchlist:

• Description: Put servers on the watchlist
• Usage: watchlist [-id id] [-a (add)] [-r (remove)] [-l (list)] [-ip ip]

player:

• Description: Get a player's server history
• Usage: player -<name>

License

Copyright (c) 2023, virus-rpi, All rights reserved.

Credits

Satsuma for helping me with scanning for ips