Beta Testing
HD Fire Update


Testing Information

Adverse Feature

The newly added Adverse Option can be used to simulate oil fires.
If the Fire is set to not accept Water Bullets and a Water Bullet is detected then an adverse effect is triggered.
Instead of extinguishing the fire it will add Energy to the fire.


Hotspot Feature

The newly added Hotspot Option will make extinguishing Fires more interesting.
The Hotspot Feature requires the Linger Option to be turned on as well.
If a Fire has been extinguished then it has a 25% chance to reignite itself while lingering smoke is present.


Damage API

The Damage API requires a channel and command.
When an avatar collides with the fire while it is burning then the command will be sent to the avatar on the channel via llRegionSayTo()
This can be used to create Health HUDs that trigger avatar damage when walking into flames.

The command supports the following placeholders:
[AVATAR] - UUID of avatar that collided with the fire
[OBJECT] - UUID of the fire object
[OWNER] - UUID of the owner of the fire
[AVATAR-NAME] - name of the avatar that collided with the fire
[OBJECT-NAME] - name of the fire object
[OWNER-NAME] - name of the owner of the fire

Example: "FIRE-DAMAGE@[AVATAR]" will send the message as "FIRE-DAMAGE@6727ab79-7a3e-4473-9e3b-af762883eaa9" for Lares Carter


Score API

The Score API requires a channel.
When an accepted bullet collides with the fire or when the fire is extinguished then a command will be broadcast on the channel via llRegionSay()
This can be used to create Score HUDs that award points and rewards for fighting and extinguishing fires.

Accepted Bullet Collision
Command: FIRE-HIT@[AVATAR]
[AVATAR] will be replaced with the UUID of the owner of the bullet.

Fire Extinguished
Command: FIRE-OUT@[AVATAR]
[AVATAR] will be replaced with the UUID of the owner of the last detected bullet.

Example: "FIRE-HIT@6727ab79-7a3e-4473-9e3b-af762883eaa9" will be sent when Lares Carter hit the fire with an accepted bullet type.


Script API

The Script API works the same as specified in the Fire System Manual.
Some new commands have been added to the API as outlined below.

Newly supported values:
TOGGLE will set the parameter to the opposite of the current setting

Updated list of supported commands:
Changes are highlighted in green
  • SET FIRE = ON / OFF / TOGGLE / KILL / RESET / LOAD
    KILL will remove the fire
    RESET will reset all settings to default, but keep the script API active
    LOAD will load the last given settings
  • SET SMOKE = ON / OFF / TOGGLE
  • SET LINGER = ON / OFF / TOGGLE
  • SET SOUND = ON / OFF / TOGGLE
  • SET ADVERSE = ON / OFF / TOGGLE
  • SET STATUS BAR = ON / OFF / TOGGLE
  • SET INFO TEXT = ON / OFF / TOGGLE
    same as SET STATUS BAR
  • SET ADVERSE = ON / OFF / TOGGLE
  • SET AGENT = Y / N / T (Water, Foam, Powder)
    Changes the accepted extinguishing agents (Water, Foam, Powder) for the fire.
    Y for Yes (extinguishing agent accepted)
    N for No (extinguishing agent ignored)
    T for Toggle (opposite of current setting)
    The command accepts up to three flags at the same time.
    They are applied to Water, Foam and then Powder in that order.
    Examples:
    "SET AGENT = YNY" Water and Powder, but no Foam.
    "SET AGENT = NNY" Powder only.
    Flags can be omitted to keep the current setting of the fire.
    Example:
    "SET AGENT = -Y-" Foam set to accepted, keep Water and Powder at what they previously were set to.
  • SET NAME = [STRING]
    Renames the fire.
  • SET LOCATION = INTERIOR / EXTERIOR / AUTO-DETECT
  • SET EVENT = EXPLODE
    Triggers an event. Currently only EXPLODE is supported.
    If you have ideas for more useful events please consider filing a suggestion. Thank you.
  • SET DAMAGE API = OFF / [INTEGER] @ [STRING]
    Sets the damage API
    First parameter is Channel, second parameter is Command
    Example:
    "SET DAMAGE API = OFF" disabled the damage API.
    "SET DAMAGE API = 25@FIRE-DAMAGE" sets channel to 25 and command to FIRE-DAMAGE.
  • SET CHILD FIRES = REZ / [0 .. 10]
  • SET DIFFICULTY = RANDOM / [1 .. 9] (1 Easy, 9 Hard)
  • SET SIZE = [0.10 .. 2.00]
  • SET MAX SIZE = [0.10 .. 2.00]
  • SET ENERGY = [0 .. 200]
  • SET BURN TIME = INFINITE / [1 .. 90] (in minutes)
  • SET SCRIPT API = [INTEGER] / OFF (any whole number, can't be 1)
  • SET SCORE API = [INTEGER] / OFF (any whole number)


Known Issues / Reported Bugs

  • no known issues

Version 2022.06.27 BETA

  • - fixed info text sometimes shows negative energy
  • - fixed using menu to setup Score API shows Damage API channel set in menu instead
  • - fixed fans should not fuel very small fires
  • - fixed Back button in Burn Time Menu is not working and sets fire to 1 minute
  • - fixed API Command for Damage API does not work

Version 2022.06.08 BETA

  • - fixed Burn Time menu Back Button does not work
  • - fixed Difficulty setting is applied reversed
  • - fixed extinguished fire smoke that's not 100% white yet only changes to white very slowly
  • - changed large Fires to grow at a slower pace
  • - changed large Fires to lose energy at a slower pace when hit with an accepted bullet
  • - changed 'Hover Bar' to 'Info Text'
  • - removed horizontal bar from Info Text
  • - fixed Info Text does not update when bullet hits fire
  • - fixed missing Damage API info in menu
  • - added Fan adding energy to active fires that are not extinguished yet
  • - added Hotspot feature
  • - added Score API feature

Version 2022.06.03 BETA

  • - fixed infinite loop on collision with avatar
  • - changed menu to show active location for 'Auto-Detect'
  • - added 'Explode' button to main menu
  • - fixed 'EXPLODE' Script API command is not working
  • - fixed explosion would always rez only one child fire
  • - fixed being able to trigger explosion for fire that is not lit
  • - fixed interior child fires only rez in one direction
  • - fixed exterior child fires object rotation is not fully random
  • - added more current fire settings to the main menu info text
  • - removed Energy and Current size info from menu info texts

Version 2022.05.27 BETA

  • - split main script into fire script and menu script
  • - added new API commands
  • - added Damage API
  • - added Adverse Option
  • - added Explode Option
  • - added Location Option
  • - increased Fan Range to clear lingering smoke