From e4cdb04a494e54fa6c75503e5ddd98284e1876bb Mon Sep 17 00:00:00 2001 From: Nucceteere Date: Tue, 6 May 2025 17:53:55 +0300 Subject: [PATCH 1/2] docs: add readme --- README.md | 73 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 73 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..9d9abd8 --- /dev/null +++ b/README.md @@ -0,0 +1,73 @@ + +
+
+ +Logo + +

ServerSeekerV2

+

+Blazingly fast Minecraft server scanner written in Rust ๐Ÿฆ€ ๐Ÿš€ +
+
+Explore the docs ยป +
+
+ +Report Bug . +Request Feature +

+
+ +## About The Project + +![ServerSeekerV2 Scanning Servers](https://files.nucceteere.xyz/assets/SSV2.png) + +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. ๐Ÿฆ€ ๐Ÿš€ +### Built With + +- [Rust](https://www.rust-lang.org/) +- [tokio](https://crates.io/crates/tokio) +- [sqlx](https://crates.io/crates/sqlx) +- [serde](https://crates.io/crates/serde) +### Installation + +Download the executable from the Releases tab. (Soon) +## Usage + +1. Copy the [example config file](https://git.funtimes909.xyz/ServerSeekerV2/ServerSeekerV2/src/branch/main/config-example.toml) and fill out the information +2. Set the right permissions + ```sh + chmod +x ./ServerSeekerV2-Rust + ``` +3. Run the scanner + ```sh + ./ServerSeekerV2-Rust + ``` +4. Enjoy + +WARNING: Do not run this at home, it will melt your home network and your ISP will be angry at you. +## Roadmap + +Soon. + +See the [open issues](https://git.funtimes909.xyz/ServerSeekerV2/ServerSeekerV2/issues) for a full list of proposed features (and known issues). +## Contributing + +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! + +1. Fork the Project +2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`) +3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`) +4. Push to the Branch (`git push origin feature/AmazingFeature`) +5. Open a Pull Request +## License + +Distributed under the GPLv3 License. See [GPLv3 License](https://opensource.org/license/gpl-3-0) for more information. +## Contact + +Your Name - [@me:funtimes909.xyz](https://matrix.to/#/@me:funtimes909.xyz) + +Project Link: [Funtimes909 Forgejo](https://git.funtimes909.xyz/ServerSeekerV2/ServerSeekerV2) From 08ffd136ce69c1e62f743d3006e7889f94bae0c0 Mon Sep 17 00:00:00 2001 From: Nucceteere Date: Thu, 8 May 2025 00:16:54 +0300 Subject: [PATCH 2/2] docs: add badges and beautify --- README.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 9d9abd8..3d41c66 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,8 @@ - +[![Forgejo](https://img.shields.io/badge/forgejo-%23F2712B.svg?style=for-the-badge&logo=forgejo&logoColor=white)](https://git.funtimes909.xyz/ServerSeekerV2/ServerSeekerV2-API) +[![PostgreSQL](https://img.shields.io/badge/PostgreSQL-%234169E1?style=for-the-badge&logo=postgresql&logoColor=white)](https://www.postgresql.org/) +[![Rust](https://img.shields.io/badge/Rust-red?style=for-the-badge&logo=rust)](https://www.rust-lang.org/) +[![Forgejo Last Commit](https://img.shields.io/gitea/last-commit/ServerSeekerV2/ServerSeekerV2?gitea_url=https%3A%2F%2Fgit.funtimes909.xyz%2F&style=for-the-badge&logo=forgejo)](https://git.funtimes909.xyz/ServerSeekerV2/ServerSeekerV2) +[![AUR Maintainer](https://img.shields.io/aur/maintainer/serverseekerv2-git?style=for-the-badge&logo=archlinux&label=aur%20maintainer)](https://aur.archlinux.org/packages/serverseekerv2-git)
@@ -13,7 +17,7 @@ Blazingly fast Minecraft server scanner written in Rust ๐Ÿฆ€ ๐Ÿš€

-
Report Bug . +Report Bug - Request Feature