Docs

New users should usually start with the local GUI path: choose a setup, install SoulFire, then run the first session in the desktop app.

SoulFire is a Minecraft bot framework for server testing, automation, and development. This documentation is organized by what you are trying to do, not just by feature area.

Start here

Follow these pages in order if this is your first time with SoulFire.

Choose Your Setup

Decide between local GUI, CLI automation, or a remote dedicated server.

Install SoulFire

Pick the right desktop or server install path.

Run Your First Session

Create an instance, configure a target, and start bots from the GUI.

Browse by goal

Start Here

Installation and first-run guides for new users.

How-to Guides

Complete specific tasks such as importing accounts, proxies, and plugins.

Automation

Run the current native automation modes and tune their operator-facing settings.

Scripting

Build bot behaviors with drag-and-drop nodes.

Troubleshooting

Diagnose connection, auth, proxy, scripting, and deployment problems by symptom.

Development

Build custom Fabric plugins when scripting is not enough and you need low-level access.

OpenAPI

Browse the generated HTTP API reference for remote integrations and automation.

Reference

Look up commands, flags, formats, versions, and built-in plugin lists.

Concepts

Understand operation modes, plugin architecture, and how SoulFire fits together.