SoulFire documentation

SoulFire runs Minecraft clients without a game window. You control them from the desktop app, visual scripts, or an SDK. Use it to test servers you operate, reproduce player workflows, and develop bot behavior.

Connect your first botCopy Anchor Link

Install SoulFire, then complete the first-bot tutorial. You will create one offline account, connect to a test server, send chat, and stop the bot. No plugin or programming experience is required.

What do you want to do?Copy Anchor Link

Look up a detail or solve a problemCopy Anchor Link

• Reference: commands, flags, formats, versions, and terminology.
• Node reference: built-in nodes and their ports.
• SDK reference: source-linked method signatures and options.
• HTTP API reference: unary JSON endpoints and their contracts.
• Troubleshooting: symptoms, diagnostic steps, and recovery.
• Concepts: the client/server model and ownership of bot work.

Two different serversCopy Anchor Link

The SoulFire server runs your bots and stores instance data. The Minecraft server is the target that those bots join. For a local first run, the desktop app starts the SoulFire server for you. A remote SoulFire server uses the same client and workflows.

Use SoulFire on Minecraft servers that you own or have permission to test. For support, bring the versions and relevant error from the diagnostic checklist.