OVERVIEW

FireControl gives server administrators complete control over fire spread mechanics. Whether you want to disable fire spread entirely or manage it through configuration, FireControl provides a simple, efficient solution.

GETTING STARTED

Installation is straightforward:
1. Download FireControl-1.0.0.jar from the releases section
2. Place the JAR in your server's plugins folder
3. Restart your server or use /reload confirm
4. The plugin will generate a default configuration file at plugins/FireControl/config.yml

CONFIGURATION

The configuration file uses simple YAML format:

fire-spread:
disabled: true (set to false to allow normal fire spread)
show-messages: true (whether to show messages when fire spread is blocked)
block-message: "&cFire spread is disabled on this server"

logging:
log-blocks: false (set to true for detailed logging to console)

HOW IT WORKS

FireControl uses Bukkit's event system to intercept fire spread events. When fire spread is disabled, the plugin cancels the BlockSpreadEvent, preventing fire from spreading to adjacent blocks. This approach has zero performance impact and works seamlessly with all Spigot-compatible servers.

TROUBLESHOOTING

Fire spread isn't being disabled:
- Use /firecontrol status to verify it's disabled
- Check your config file at plugins/FireControl/config.yml
- Ensure fire-spread.disabled is set to true
- Use /firecontrol reload to reload configuration
- Check the console for any error messages

Plugin won't load:
- Verify you're using Java 11 or higher
- Confirm your server version is 1.18 or newer
- Check the server console for startup errors
- Try deleting the config and letting it regenerate

Configuration changes not applying:
- Use /firecontrol reload to hot-reload without restarting
- Or manually restart the server with /stop

PERMISSIONS

Only players with the firecontrol.admin permission can use the commands. By default, this is granted to server operators.

To grant permission with a permission plugin like LuckPerms:
/lp user <playername> permission set firecontrol.admin true

PERFORMANCE

FireControl is designed to be lightweight and efficient. It uses a single event listener and has minimal memory footprint. The plugin will have negligible impact on your server's performance.

VERSION SUPPORT

Minecraft 1.18 through 1.21+ are fully supported and tested. The plugin maintains backward compatibility while supporting the latest Minecraft versions.