AlexProgrammerDE / SoulFire

Advanced Minecraft Server-Stresser Tool. Launch bot attacks on your servers to measure performance.
https://soulfiremc.com
GNU General Public License v3.0
270 stars 33 forks source link
bot minecraft minecraft-bot minecraft-bot-attack minecraft-botting stress-testing

SoulFire

Build Status Java CI Contributors License GitHub all releases downloads GitHub latest release downloads Current Release

Discord embed

Advanced Minecraft Server-Stresser Tool. Launch bot attacks on your own servers to stress-test them and measure performance.

This repository only contains the CLI and server implementation. The official GUI client is in another repository.


[!WARNING] This is a very powerful tool that shall only be used to attack your own servers. Ensure your own DDoS protection provider, and your host are okay with stress-tests. If you use this software to attack others, you make yourself (or your legal guardians) criminally liable; the developers of SoulFire are not responsible for your own actions.


πŸš€ Features

πŸ–₯ Installation

[!TIP] Want to check out how SoulFire looks before installing it? Take a look at the official demo page.

For installing SoulFire, please refer to the installation guide.

🍿 Version support

You can find an up-to-date list of supported versions in the documentation.

⌨ Commands

For a list of all available commands, look at the documentation or run help in the GUI or CLI.

πŸ“» Plugins

You can read about the SoulFire plugins in the documentation.

πŸ—ƒ Import accounts and proxies

You can read about how to import accounts in the account documentation and how to import proxies in the proxy documentation.

πŸ’» Command Line Usage

If you want to use the CLI of SoulFire, please refer to the CLI Mode Guide.

🧡 Demo

SoulFire has a built-in GUI for easy usage. Try a SoulFire demo yourself at the demo page.

https://github.com/user-attachments/assets/81fbf91b-1aae-49ca-a101-bc3467e048e6

✨ Nightly builds

You can download the latest development version of SoulFire through nightly.link.

πŸ”§ Build from source

  1. Install Java 21+
  2. Download the latest source code from GitHub
  3. Run ./gradlew build in the project directory
  4. Get the jar file from client/build/libs

πŸ‘¨β€πŸ’» Developer API

SoulFire offers a Developer API to create your own plugins using the plugin API and mixins. The software may regularly have breaking changes, so you'll have to stick to a version of SoulFire or update your plugin regularly.

To learn more about the Developer API, take a look at the official plugin example.

🌈 Community

Feel free to join our Discord community server:

Discord Banner

This project is in active development, so if you have any feature requests or issues, please submit them here on GitHub. PRs are welcome, too.

🌟 Star History

Star History Chart