Funtimes909
About The Project
ServerSeekerV2 is a complete rewrite of the original ServerSeeker but faster and better with more features. ServerSeekerV2 is written in Rust allowing it to be blazingly fast and memory safe. 🦀 🚀
(The two are bridged together so you only need to join one)
Features
- Rescanning. SSV2 Can rescan already found servers for the most up-to-date results (updates every few minutes)
- Performance. SSV2 is significantly faster than the original ServerSeeker.
- Open Source. Unlike the original, SSV2 and all it's related projects are fully open source.
- Advanced MOTD Parsing. Weather a servers description is really complex and has lots of formatting or a simple string, it will be built into a string with Minecraft style text formatting codes applied in place. both raw descriptions and formatted descriptions are saved in the database.
- Automatic opting out. Unlike the original ServerSeeker where you had to join a discord server and request your server be removed. You can automatically remove yourself from the database and prevent further scans by modifying your servers MOTD.
- Player and mod tracking. Find servers that have specific players online or servers running specific forge mods.
- (or both at the same time!)
- Self Hostable. Host your own scanning instance and find your own servers! (See below for warnings against running this on a residential network)
For people just looking to not be scanned anymore
You can add "§b§d§f§d§b" to the end of your servers description by changing the server.properties file. This change
is invisible to the client and won't change the look of your servers description in most cases.
Additionally having this in your servers description Will remove you from the database as well if you were previously scanned. The next time your server is found, it will automatically remove it from the database. Easy!
If something is wrong, or you're still being scanned after adding the above string to your servers description join
my Matrix Space and message @me:funtimes909.xyz directly.
FAQ
-
Q: What is this?
-
A: ServerSeekerV2 is a faster version of the original ServerSeeker, it pings around 4 billion IPv4 addresses every few hours and attempts to join Minecraft servers on the ones that respond. This process is repeated over and over again.
-
Q: How can I get my server removed?
-
A: See above method or join my Matrix Space and ping
@me:funtimes909.xyz. -
Q: I have a dynamic IP address, how can I get my server removed?
-
A: I can't remove your IP address every time it changes, you will have to rely on using the MOTD method described above or use something like NFTables or UFW to block connections from my IP address
-
Q: How can I protect my server?
-
A: Enable a whitelist for your server, a whitelist allows only specified players to join your server, run
/whitelist onand then/whitelist add <player>for every player that will join your server. Additionally, setting "online-mode" to true in theserver.propertiesfile helps a lot by enforcing that every player must own a copy of the game. -
Q: Why?
-
A: As mentioned above, the previous owner of the original ServerSeeker, sold it to a third party, that got the discord bot and server terminated within a month of the sale. At the time I was looking for a project to sink my endless amounts of free time into, so shortly after the sale, I started developing this :)
Related projects
Built With
Installation
Warning: You definitely should not run this at home or from a residental network, that is a very easy way to make your Internet Service Provider very angry at you and potentially terminate your contract
Download the executable from the Releases tab. (Soon)
Usage
- Copy the example config file and fill out the information
- Set the right permissions
chmod +x ./ServerSeekerV2 - Run the scanner
./ServerSeekerV2 --mode <mode> - There are two modes to choose from, rescanner and discovery. Discovery uses masscan to find new servers while rescanner rescans the database. For discovery mode it is required that your masscan config looks like the provided example. SSV2 reads lines from masscan's standard output to scan servers as they are found.
Contributing
ServerSeekerV2 uses nightly rust
Please run rustup override set nightly in the project directory after you clone it to run it
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
License
Distributed under the GPLv3 License. See GPLv3 License for more information.