alexprogrammerde/soulfire

By alexprogrammerde

•Updated 8 days ago

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

Image

Networking

Developer tools

9.1K

Overview Tags

alexprogrammerde/soulfire repository overview

⁠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
Use this tool only on servers that you own or have permission to test. Make sure that your hosting provider allows automated bot testing. You are responsible for unauthorized use. The SoulFire developers are not responsible for your 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](https://demo.soulfiremc.com).

Follow the installation guide⁠ to install SoulFire.

⁠🍿 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. SoulFire can include breaking changes. Pin your plugin to a SoulFire version, or update it when SoulFire changes.

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

SoulFire also includes TypeScript and Python SDKs⁠ for connecting over gRPC-Web, streaming bot events, issuing current per-bot actions, and provisioning a local dedicated server.