SoulFire

Advanced Minecraft Bot Tool. Deploy automated bots for server testing, automation, and development.

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

[!WARNING] This tool should only be used on servers you own or have explicit permission to test. Ensure your hosting provider allows automated bot testing. If you use this software without authorization, you make yourself (or your legal guardians) liable; the developers of SoulFire are not responsible for your own actions.

✨ Are you looking for an advanced administration panel for your server?

EnderDash allows you to manage your existing Minecraft servers using an advanced dashboard by installing a single plugin, batteries included. Run commands (with tab completion), read logs, manage files, invite your whole team, manage players, Ocelot (AI Assistant), works with your existing Infrastructure/Panels and much more.

Check it out: https://enderdash.com

🚀 Features

GUI (Multiple themes) & CLI
Configurable options for every session like the number of bots, join delay and more
Load and save profiles for quick access
Support for online and offline mode servers
Supports almost every Minecraft version
Use Microsoft (Credentials & Device Code supported) and Offline accounts for both Java Edition and Bedrock Edition
Use HTTP, SOCKS4 and SOCKS5 proxies
Multiple built-in plugins like AutoRespawn, AutoJump, ClientSettings and more
Console command support
A* Pathfinding (Diagonal moves, parkour, mining blocks, placing blocks)

🖥 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.

🤿 Looking for proxies?

There are many websites that offer free proxies, but be careful as many of them are not reliable or secure.

Our recommended proxy providers are LegionProxy and Proxy-Seller, who sponsor SoulFire.

For a full list of recommended providers, check out our Get Proxies page.

💻 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/6244d54c-a1e5-4467-a705-c929b9de2b57

✨ Nightly builds

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

🔧 Build from source

Install Java 25+
Download the latest source code from GitHub
Run ./gradlew build in the project directory
Get the jar file from client-launcher/build/libs or dedicated-launcher/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:

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.

🏅 Sponsors

Free code signing on Windows provided by SignPath.io, certificate by SignPath Foundation