🚒 FireEquipment

Hi everyone! FireEquipment adds roleplay tools for firefighters to your server: a Fire Hose to spray water, an Extinguisher to put out flames and a Water Pump to clean up the water afterwards.

Works on Spigot, Paper and Purpur, Minecraft 1.21 and newer.

Need help? Want to add a translation? Or maybe a suggestion?

https://discord.gg/DkQSQa7

🚒 Items

All tools are used with a right-click while holding them.

🧯 Fire Hose Shoots a jet of water up to 5 blocks in front of you. The water disappears on its own after a few seconds, so your map is never flooded. You are slowed down a lot while spraying.

permission: firequip.tools.hose

💧 Water Pump Sucks up the water sources in front of you (4 blocks).

permission: firequip.tools.pump

🔥 Extinguisher Puts out flames at short range (2 blocks). You are slowed down a little while using it.

permission: firequip.tools.extinguisher

Good to know:

• Ranges and cooldowns can be changed in the config.
• Tools respect region protection plugins (WorldGuard, GriefPrevention, Towny...). A player can't spray water or put out fire where they aren't allowed to build.
• Renaming a tool in an anvil doesn't break it.

⌨️ Commands

Command	Description	Permission
/firequip help	Shows the help message	firequip.info
/firequip version	Shows the plugin version	firequip.info
/firequip reload	Reloads the config file	firequip.info + firequip.admin.reload
/fequip <hose/pump/extinguisher>	Gives you a tool	firequip.tools.give

Aliases: /fireequipment for /firequip, /equip for /fequip.

All permissions

Permission	Allows
firequip.info	/firequip help and /firequip version
firequip.admin.reload	/firequip reload
firequip.tools.give	/fequip
firequip.tools.hose	Using the Fire Hose
firequip.tools.pump	Using the Water Pump
firequip.tools.extinguisher	Using the Extinguisher

⚙️ Configuration

plugins/FireEquipment/config.yml is created on the first start. When you update the plugin, missing options are added automatically and your changes are kept.

You can edit:

• every message, with & color codes (and MiniMessage tags on Paper),
• each tool's name, description, range (in blocks) and cooldown,
• how long the hose water stays (waterLifetime).

Cooldowns and water lifetime are in ticks (20 ticks = 1 second).

Equipment:
  Hose:
    displayName: "Fire Hose"
    usage: "Right-click to throw water"
    range: 5
    cooldown: 10
    waterLifetime: 60

Run /firequip reload to apply your changes without restarting the server.

🎨 Textures (optional)

FireEquipment has its own resource pack with custom textures for the three tools (Minecraft 1.21.4+). Without it, the tools look like vanilla items (golden hoe, clay ball, iron hoe) and work exactly the same.

Download FireEquipment-pack-<version>.zip from the GitHub releases, then pick one:

• Let FireEquipment send it: upload the zip somewhere players can download it, then fill the ResourcePack section of the config:

  ResourcePack:
    enabled: true
    url: "https://example.com/FireEquipment-pack-2.2.0.zip"
    sha1: "<sha1 written in the release notes>"
    prompt: "FireEquipment textures"
    force: false
  

• Using Nexo: drop the zip into plugins/Nexo/pack/external_packs/ and run /nexo reload pack. Keep ResourcePack.enabled: false in FireEquipment.
• Your own server pack: copy the assets/fireequipment/ folder from the zip into it.

Tools given before you installed the pack are updated automatically when their owner joins or uses them.

Always give the tools with /fequip. Items given by other plugins (like /nexo give) only look like the tools and won't work.

📜 Terms of Use

• You are not permitted to decompile or modify the plugin in any form.
• You are not permitted to redistribute the plugin in any form, including as a part of any software package.
• You agree to make an effort to get help (by PM'ing me) if you are having problems, before leaving a review.
• We reserve the right to change these Terms at any time, and you agree to abide by the most recent version of this.