Plugins

SoulFire 2.0: Built on Fabric

SoulFire 2.0 runs the official Minecraft client code as a special Fabric mod. SoulFire plugins are Fabric mods that use the standard Fabric mod loader.

This design lets plugins use Minecraft and Fabric APIs directly.

Why Fabric?

Vanilla behavior: Bots use the official Minecraft client code.
Physics and movement: Bots use Minecraft's movement, prediction, and collision code.
Protocol behavior: Network communication follows the official client.
Version updates: SoulFire can reuse the Minecraft code for new versions.
Feature development: Developers can build features on existing Minecraft code.
Third-party mods: Some Fabric mods work with SoulFire without changes.

Plugins are Fabric mods

SoulFire plugins are standard Fabric mods. The Fabric mod loader loads them during startup.

Since SoulFire plugins are Fabric mods:

Plugins use the standard Fabric mod structure, including fabric.mod.json and entrypoints
Plugins are loaded from the minecraft/mods directory by the Fabric mod loader
Plugins can use Mixins to modify both Minecraft and SoulFire code
Plugins have full access to the Minecraft codebase and Fabric APIs
Some existing Fabric mods work with SoulFire without changes

This power is meant for advanced users. If visual automation is enough, stay in Scripting. Move to Development when you need Mixins, packet hooks, custom settings pages, or direct access to Minecraft and SoulFire internals.

Built-in plugins vs community plugins

Built-in plugins ship with SoulFire and can be enabled or disabled per instance.
Community plugins are external Fabric mods that you add yourself.
Both use the same underlying Fabric loading model.

For the current built-in list, see Built-in Plugins.

Compatibility expectations

Some Fabric mods work with SoulFire without modification, but compatibility is not universal.

Mods that depend on rendering, audio, or other client-only features usually do not work.
Mods that change gameplay logic, networking, inventory behavior, or automation are more likely to work.
Mixins can change Minecraft and SoulFire code. Install only plugins that you trust.

Writing plugins

Ask plugin development questions in Discord.

The short version:

Start from the official SoulFirePluginExample template
Add the current SoulFire dependencies from CodeMC Maven
Register your plugin with SoulFireAPI.registerServerExtension(...)
Build a standard Fabric mod jar and place it in minecraft/mods

See Development for the full developer workflow. It covers setup, Gradle, settings, events, bot control, Mixins, access wideners, architecture, and API references.

Development for the full plugin-authoring documentation
Install Plugins for the practical install steps
Built-in Plugins for the built-in list
Resources for community plugins and scripts