🎉 SoulFire v2 is out now!
SoulFire LogoSoulFire

Plugins

Plugins are a way to extend the functionality of SoulFire. SoulFire also comes with a few built-in plugins that can be enabled or disabled.

Built-in plugins

We've prepared a list of built-in plugins that SoulFire ships by default with every SoulFire instance and are available by default. Later on this page we'll show a list of external community plugins that extend the base SoulFire functionality.

IDDescriptionAuthorLicense
ai-captcha-solverSolve captcha images using AIAlexProgrammerDEGPL-3.0
ai-chat-botAllow players to chat with an AIAlexProgrammerDEGPL-3.0
anti-afkAutomatically moves x amount of blocks in a random direction to prevent being kicked for being AFKAlexProgrammerDEGPL-3.0
auto-armorAutomatically puts on the best armorAlexProgrammerDEGPL-3.0
auto-chat-messageAutomatically sends messages in a configured delayAlexProgrammerDEGPL-3.0
auto-eatAutomatically eats food when hungryAlexProgrammerDEGPL-3.0
auto-jumpAutomatically jumps randomlyAlexProgrammerDEGPL-3.0
auto-reconnectAutomatically reconnects bots when they time out or are kickedAlexProgrammerDEGPL-3.0
auto-registerAutomatically registers bots AuthMe serversAlexProgrammerDEGPL-3.0
auto-respawnAutomatically respawns after deathAlexProgrammerDEGPL-3.0
auto-totemAutomatically puts totems in the offhand slotAlexProgrammerDEGPL-3.0
chat-loggerLogs all received chat messages to the terminal Includes deduplication to prevent spamming the same message too oftenAlexProgrammerDEGPL-3.0
client-brandSends the client brand to the serverAlexProgrammerDEGPL-3.0
client-settingsSends client settings to the serverAlexProgrammerDEGPL-3.0
fake-virtual-hostFakes the virtual hostAlexProgrammerDEGPL-3.0
kill-auraAutomatically attacks entitiesAlexProgrammerDEGPL-3.0
server-list-bypassPings the server list before connecting. (Bypasses anti-bots like EpicGuard)AlexProgrammerDEGPL-3.0
forwarding-bypassAllows bypassing proxy forwardingAlexProgrammerDEGPL-3.0

How to generate this list

Run the command print-docs plugins in the console of the GUI, CLI or Dedicated server.

Community plugins

Community plugins are plugins that are not built-in but are made by the community. Plugins can be written in Java or Kotlin and can be loaded at startup of the SoulFire server. Plugins are able to use Mixins, which is the same system used in Minecraft mods to modify the game. SoulFire does not use Minecraft code, so Minecraft mods are not compatible with SoulFire. Plugins normally only modify the SoulFire application server, not the GUI/CLI interface directly.

Any questions regarding how SoulFire works and how to write a plugin can be asked in the Discord.

How to write a plugin

To write a plugin, you need to create a new Java or Kotlin project. Right now there is no full guide on how to write a plugin, but you can look at the built-in plugins for inspiration. There is also a plugin template available on GitHub. Official Javadocs are hosted on CodeMC CI.

How to install a plugin

To install a plugin, you need to place the plugin .jar file in the plugins directory of the SoulFire server. The SoulFire server will automatically load all .jar files in the plugins directory at startup. The plugins directory is in different places depending on your setup and operating system. If you use the client integrated server, you'll find the plugins directory in the Help -> Data directory folder in the soulfire/plugins subdirectory. If you use a dedicated server, you'll find the plugins directory located in the same directory as the server .jar file.

Plugin list

Feel free to share your plugins with the community here. Open a pull request to add your plugin to the list. Plugins should be open-source and hosted on GitHub. If you want to share a paid plugin, please contact the developers.

Plugin nameDescriptionAuthor
Example PluginAn example plugin that adds jump boost hacksAlexProgrammerDE

How is this guide?

Last updated on