Skip to main content

Changelog

This page documents the changes made to FAR.

v1.3.*

v1.3.7 - 12/23/2024

Added:

Fixed:

  • Being unable to open/close Sprinkler Valves properly with OxTarget.
  • Detectors not fully resetting when an Alarm System is reset.

v1.3.6 - 12/16/2024

Added:

Changed:

  • Increased maximum prop spawning distance from 75 meters to 100 meters, and maximum FAR Tool prop placement from 35 meters to 75 meters.
    • The aim of this change is to allow for physically larger Alarm Systems to be created.
  • Editable events such that they cannot be triggered from the client.

Removed:

  • Logic that checked if an interior had loaded before spawning FAR Props.
    • Caused issues with add-on MLOs located in the same position as base-game MLOs.

Fixed:

  • Announcements not working correctly from the Control Panel.
  • Passcode error pop-up when creating a new Alarm Location with the FAR Tool.
  • Erroneous file name being shown when saving an existing draft with the FAR Tool.
  • Being able to load empty .lua files as valid drafts for FAR Tool.

v1.3.5 - 12/09/2024

Added:

  • Alarm System Monitoring
    • Adds a monitoring parameter to the AlarmSystem object.
    • Designed to represent if an Alarm System is being monitored by an Alarm Monitoring Company, such as Gruppe Sechs.
    • Can be used when handling activation events to determine if the alarm activation should result in an automatic page/call/etc. to Emergency Services, for example:
      • RegisterServerEvent("Inferno-Collection:Server:FireAlarmReborn:Editable:AlarmActivation")
        AddEventHandler("Inferno-Collection:Server:FireAlarmReborn:Editable:AlarmActivation", function(alarmSystem)

        -- Monitoring is not enabled, so we will not page the Fire Dept.
        if not alarmSystem.monitoring then
        return
        end

        Pager:NewPage("Fire Alarm - " .. alarmSystem.name .. " - " .. alarmSystem.location)
        end)
    • Value is true by default, and can be changed in one of two ways:
      1. In-game, by using the Control Panel and locating the Disable Monitoring option in the Main Menu.
      2. Out-of-game, by adding monitoringDisabled = "true" to Alarm System entries.
    • MonitoringDisabled event.

Changed:

  • Logic that checked if interiors were full loaded before spawning FAR props.
    • Previously, if an interior was reporting as "not ready", FAR would not spawn props at all.
    • Now, FAR will load props after 15 seconds regardless.
      • This resolves an issue with FAR props not loading at locations where addon MLOs intersected with base-game MLOs.
  • Multiple players can now use the FAR Tool at the same time.

Fixed:

  • "Press E to ..." prompts appearing even when ic_far_oxTargetSupport was set to true.
  • OxTarget Sprinkler Valve interactions duplicating.
  • Random Alarms being triggered even when there were no players in server.
  • Bug that prevented the loading of draft Alarm Systems that shared locations with a live Alarm Systems already loaded.

Removed:

  • Per-Control Panel passcodes.
    • Passcodes are now per-Alarm System.
    • Existing Alarm Systems can be updated by moving passcode = "..." from the Control Panel entry into the Alarm System entry.
      • Reach out in Discord if you need help converting old systems.

v1.3.4 - 12/04/2024

Fixed:

  • Hidden Props reappearing momentarily ('flickering') when an Alarm System changed status, such as from standby into alarm.

v1.3.3 - 12/01/2024

danger

Breaking changes to the Exports were made in this version, do not blindly update.

Added:

Changed:

  • Multiple Sprinklers can now activate for the same fire.
    • Previously, only the closest Sprinkler within X distance of a fire would activate, now all Sprinklers with X distance will activate.
    • The distance ('X') from the fire to the Sprinkler has been reduced slightly to avoid "too many" Sprinklers activating.
  • Pre-activated Sprinklers now extinguish new fires.
    • note

      This only applies to z_Fires and SmartFires.

    • Previously, once a Sprinkler was activated, any new fires in the same location while the Sprinkler was still active would not be extinguished; this is no longer the case.
  • triggerPullStationAtPosition export now activates the closet Pull Station to the provided position, not a random Pull Station.

Fixed:

  • Issue where randomly generated z_Fires smoke was causing server errors and Sprinklers not to activate.

v1.3.2 - 11/27/2024

Fixed:

  • All fires created by z_Fires were put out after a few seconds, regardless of Sprinklers.
  • AlarmActivation event being fired multiple times.
  • Typo in ic_far_defaultSprinklerValveDistanceCheck config option.
  • ALARM and BUZZER Control Panel LEDs still blinking after being muted.

v1.3.1 - 11/25/2024

Fixed:

  • Resets being soft locked if first reset attempt failed.
  • FIRE LED state not updating until FIRES button was pressed.
  • Sprinklers reactivating for a few seconds if the Sprinkler Valve is Closed, and a new component is activated.
  • Edge case where the distance check for the nearest interactable component would fail.
  • ic_far_disablePasscodes config option being ignored.
  • TEST button saying a passcode is required, when ic_far_disablePasscodes is true.
  • ALARM and BUZZER LEDs being stuck in the ON condition after being tested.
  • SILENCE ALARM button not working if an Alarm System was silence, but a second component was then activated.

v1.3 - 11/19/2024

Added:

  • Sprinkler Valves
    • Sprinkler Valves are optional, any systems without a Sprinkler Valve will behave as it did prior to v1.3.
    • Only one Sprinkler Valve can be placed per Alarm System.
    • Sprinkler Valves have two positions:
      • Open
        • Water can flow.
        • Sprinklers will activate.
        • Sprinkler Bell will sound.
      • Closed
        • Water cannot flow.
        • Sprinklers will not activate, and pre-activated Sprinklers will stop showing water.
          • If the Sprinkler Valve is Opened again after being Closed, but before a system reset, pre-activated Sprinklers will show water again.
        • Sprinkler Bell will not sound.
    • If an Alarm System is in Alarm, and there is a triggered Sprinkler, the Sprinkler Valve must be placed in the Closed position before the system can reset.
      • tip

        Be sure to place it back in the Open position afterward though, or else Sprinklers will not activate when there's a fire!

    • Sprinkler Valves have their own Ace Permission.
    • SprinklerValveChanged event.

Changed:

  • If an Alarm System contains a Sprinkler Valve, the Sprinkler Bell sound effect will come from the position of the Sprinkler Valve instead of the center of the Alarm System.
    • tip

      Not sure where the Sprinkler Valve is located in an Alarm System? Follow the sound of the bell!

Removed:

  • Server console warning about permissions not being correctly set-up.

v1.2.*

v1.2.2 - 11/18/2024

danger

Major breaking changes to the Events were made in this version, do not blindly update.

Added:

Changed:

Removed:

  • getAlarmSystem export.
    • If you know the ID of the Alarm System, you likely already have access to an AlarmSystem object.
    • If you want to get all of an Alarm System's Control Panels, Pull Stations, etc., use the new getAlarmSystemCompontents export.
  • Components from the AlarmSystem data type.
  • alarmSystemId from all components (Pull Stations, Sounders, etc.).
    • If you know the ID of the Alarm System, you likely already have access to an AlarmSystem object.

v1.2.1 - 11/17/2024

Added:

  • Example in editable/pager.lua for changing tones paged based on which Alarm System is activated.

Fixed:

  • Issue where not passing enough arguments to Exports would throw a confusing error.
  • PullStationTriggered event example code referencing a non-existed variable.
  • alarmSystemId parameter on data returned by Exports incorrectly being passed as alarmSystem.

v1.2 - 11/16/2024

Added:

  • Check to prevent multiple of the same Alarm System being loaded.
  • Error message when a file listed as an fire_alarms file could not be found.

Changed:

  • Warning and Error messages when ingesting Alarms System files to match the style of others from the resource, as well as to include both the file and resource name when referring to Alarm Systems.
    • Example: INFO: Ingested 15 Alarm Systems from **food_stores.lua** (**inferno-alarms**), 48 total.

Fixed:

  • Errors appearing in the client console complaining about config values not being set, when really they had.
  • The error message that appeared when you had no set default model values, showing the default values as Dictionary<bool,sting> etc instead of their actual JSON values.
  • Multiple people being able to interact with an Alarm System Control Panel at once.
    • Even if there are multiple Control Panels for one Alarm System, only one can be used at once.
  • SystemDisabled event not being fired.

v1.1.*

v1.1 - 11/11/2024

Added:

  • IgnoreProximity flag for Alarm Systems which removes the warning in the server console when one or more systems are within 30 units of each other.
warning

We suggest only using this if you're confident you've set up your alarm systems far enough away from each other not to overlap.

  • Error message to the server console that appears when the config.cfg file has not been executed.
  • triggerPullStationAtPosition Export which allows for the activation of a random Pull Station of a system within 50 units of the provided position.
  • getAlarmSystemPasscode Export which returns just an Alarm System's passcode.

Fixed:

  • Space Bar missing from the Tool controls helper.
  • Typos 😔
  • Outdated docs link.
  • Bug that prevent all but the first Alarm System's Control Panel from opening.
  • Postal codes not being loaded from Alarm System files.
  • Missing sounders in some of the stock resources.

v1 - 11/11/2024

Initial resource release.