stevieeoo

Immersive Ambient Events is an ambient events plugin designed to fill in gaps of your patrol where nothing happens for long periods of time, without interfering with callouts, pursuits, pullovers, or anything else you may be doing!

Important: Due to how the severe weather event works, the game time cannot be frozen, or else the event will never end, there is a workaround in the FAQ below.
 
Events:
- Aggressive Driver
- Drunk Driver
- Gas Leak
- Hotboxing
- Severe Weather
- Vehicle BOLO
- Vehicle Trouble
- Speeding
- Street Racing
- Driver on Phone
- Drug Deal
- Drinking On Beach
 
Features:
- Timer System:
The plugins timer system constantly checks if you're available for calls and not doing anything significant. If you accept a callout or do anything else that would make the plugin consider you busy (Get into a pursuit, start a traffic stop, or otherwise set yourself as not available for calls) the plugins timer system stops and resets to the time you specify in the ini file, and it doesn't start again until you are no longer busy. Only one event in this plugin spawns at a time (with the exception of the Vehicle BOLO event, more on this below), to avoid overloading you with things to do. 
 
- Two Menus:
The plugins menu allows you to customize all your ini values in game, and save them to the ini file. It even allows you to change the keybinds for the menu in game! The menu also has multiple other uses, like interacting with peds in specific events through the interaction submenu. 
The plugin also has a second menu, which can be accessed in the RPH F4 console using the command "IAEOpenForceEventMenu" This second menu will allow you to forcefully spawn any event in the plugin, as well as forcefully end the current event that's active.
 
- Error Handling System:
We've all been there, you're enjoying a nice patrol on LSPDFR, then suddenly one plugin has an error and it crashes LSPDFR. This plugin has an error handling system that will help prevent that from happening! If for any reason an error happens within the plugin, a notification will be displayed, notifying you that an error occurred, it will log the error, and it will prevent a full LSPDFR crash. If the error happens to come from an ambient event and not one of the plugins backend systems, the plugin will log the error, display a notification, and forcefully end the event and continue on spawning new events like nothing happened. However, this system is not full-proof, so there is still a (small) chance that LSPDFR might crash if there's an error. I will continue to improve this system in future updates. 
 
- In Depth Vehicle BOLO System:
One of the events, Vehicle BOLO, saves between game sessions. Meaning that if you don't catch the guy during your patrol and get off LSPDFR, that exact same suspect(s) and vehicle will be there waiting for you in the same BOLO the next time you hop on. There's even a chance that an AI unit could locate the BOLO suspect and initiate a pursuit. Pay close attention to the details regarding the crime, as it can hint as to how the suspect will react when trying to be pulled over. This event is designed to be as randomized as possible for maximum replayability, even the amount of details you get on the vehicle is randomized. Sometimes you may get the make and model, sometimes maybe the make and a partial plate, etc etc. "But what if I have custom vehicles installed that replaces AI traffic?" Well I have good news for you, I included a file (bolomodels.json) within the Immersive Ambient Events folder that allows you to customize the names of the make, model, and class of vehicles in the notification. With this file you can even add new vehicles to the list of vehicles used in the event. Because this event usually lasts long periods of time, it runs on its own timer that's independent from the other ambient events. 

- Realistic Severe Weather Event:
No more patrols where the weather stays the exact same unless you manually change it. With the severe weather event, a storm (or blizzard if the current weather is a snow based one) can roll in at any moment, and even have the potential to knock out power across the map, making it extremely dark if it happens to be late at night. Hopefully your vehicle has spotlights or takedowns! 

FAQ:
How can I patrol during a specific time of day while having the severe weather event enabled?:
In simpletrainer, go to the time settings, and enable "Real Time Duration" what this does is it makes one minute in game the same as one minute in real life. Then you can change the ini setting for the severe weather event and set "HoursItLasts" to 0, and set the minutes option to be however long you want the storm to last. 
 
How can I tell when an ambient event is happening?:
Events will either display a notification of some sort, or a yellow question mark blip will appear on the minimap where the event is happening.
 
The question mark blip for an event disappeared when I got close to the event or exited my vehicle, is this normal?:
Yes, most events automatically delete the blip once you get close enough to be considered participating in the event, the events also take into consideration whether you're on foot or not before deleting the blip as well.
 
Why is the "Interaction" item on the plugins menu greyed out?: 
The interaction submenu is only enabled whenever there's an active event that uses it. If it is greyed out, that means no event that uses that system is active.

Why am I not getting updated sightings for the Vehicle BOLO event?:
For the Vehicle BOLO event, you need to be set as available for calls for the blip to update and for you to receive a notification. By default the event is set up to not show updated sighting notifications unless you are within 1000 meters of the area, however this can be changed in the BOLO event section of the plugins menu
 
Why can't I pull over the vehicle involved with the Vehicle Trouble event?: 
This is done on purpose, to prevent the pullover from interfering with tasks given to the driver. Don't worry, this is temporary and once the event is finished, you can pull that driver over if needed!

Wanna see what the mod is all about? Check out these videos!
 
This mod is also compatible with RansomAmbience!

Future Plans:
- Many new ambient events
- Updates to existing events
 
Want to report bugs? See previews of future mods? Suggest things related to my mods? 
Join the Discord Server!