Java AGPL-3.0

SoulFire

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

S

soulfiremc-com

Dernière activité 29 sept. 2026
soulfiremc-com/SoulFire

621

étoiles

72

forks

15

issues ouvertes

botminecraftminecraft-botminecraft-bot-attackminecraft-bottingstress-testing

Ce README est souvent en anglais.

discord kofi

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.

Follow the installation guide to install SoulFire.

The server bundles a headless Vulkan runtime and Mesa lavapipe for CPU rendering. No system Vulkan packages or display server are required. Installed compatible GPU drivers provide hardware acceleration. See native runtime packaging for supported platforms and build instructions. The Docker image includes lavapipe. On Debian or Ubuntu, install libvulkan1 and mesa-vulkan-drivers when running without a GPU driver. POV captures and inventory images render on demand without a native window. OpenGL is disabled. See renderer validation for the manual comparison tests.

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

SoulFire.Demo.mp4

✨ Nightly builds

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

🔧 Build from source

  1. Install a JDK 25 and clone this repository.
  2. Prepare the packaged native runtimes using the native runtime build instructions.
  3. Run ./gradlew build in the project directory. For a local build, select the prepared platforms with -PvulkanPlatforms=<platform>.
  4. Get the JAR from client-launcher/build/libs or dedicated-launcher/build/libs.

The default build requires all six native runtime platforms. For environment setup, module locations, SDK generation, and tests, read the contribution guide.

👨‍💻 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.

🌈 Community

Feel free to join our Discord community server:

Discord Banner

For setup and usage questions, read the support resources. Report bugs and propose features through the issue forms. Pull requests are welcome. Read the contribution guide and code of conduct before you start. Report vulnerabilities privately through the security policy.

🏅 Sponsors

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

🌟 Star History

Star History Chart

Projets similaires

Create Minecraft bots with a powerful, stable, and high level JavaScript API.

JavaScriptbotminecraftminecraft-api
PPrismarineJS
7,5 k étoiles1,5 k

Sonar is a lightweight, effective and easy-to-use anti-bot plugin for Minecraft servers.

Javaanti-botantibotbotfilter
Jjonesdevelopment
250 étoiles41

Lightweight console for Minecraft chat and automated scripts. Currently supports up to Minecraft 26.2

C#minecraft
MMCCTeam
2,2 k étoiles481