Beat Partners - Autonomous Partners, Proximal Pursuit Logic, Supervisor - Page 4 - Script Modifications & Plugins

5 Screenshots

This plugin beta allows you to spawn units that will act as your beat partner. They will persistently patrol given the selected parameters in the creation menu. This allows for further immersion, realism, and ambiance. The goal of this plugin is to create autonomous AIs that will patrol, in a close-to-similar fashion as a human player and eventually eliminate the need of needing to manually request backup units during certain situations.

Scenario Example: You can assign multiple units to patrol Grapeseed while you patrol Sandy Shores. If you get involved in a shooting, the Grapeseed units can automatically respond to assist. Or if you get in a pursuit, the Grapeseed units will only join the pursuit if the suspect enters the Grapeseed area. If the suspect exits the Grapeseed area, then those Grapeseed units will disengage from the pursuit and return to patrol.

Various features and customizations:

Assign a partner to patrol a specific zone (e.g. Vinewood)
Give the partner a name and a call sign (call sign will be displayed on the partner's blip on the map)
Assign a partner to patrol within a specified distance from the player (partner will try to stay within distance X from the player's position)
Assign a partner to respond to pursuits/callouts within their assigned zone
Display either the name tag or call sign tag above partners that are driving by the player
Have partners always respond to player-involved shootings
If a partner gets into a shooting away from the player, they will report it to dispatch
If a partner gets severely injured, they will radio "Officer down"
If a partner's vehicle is badly damaged or destroyed, they will become "out of service" to go to the nearest police station to retrieve a new vehicle or repair their vehicle, then return back to service
Partners will persistently be available to respond to calls / assist the player
Take a smoke break with your partner at a specified location

Proximal Pursuit Logic

You can select for each partner to only engage in pursuits if the pursuit passes within their assigned zone (e.g. Vinewood). Once the pursuit leaves their zone, the unit will drop out of the pursuit and return back to patrol. You can also have it where the partner will only engage pursuits when it is within a certain distance of their location (regardless of their assigned zone).

Make sure to put BeatPartners.dll and BeatPartners.ini and BeatPartners.pdb into \Plugins\LSPDFR folder.

Make sure to have the latest version of RageNativeUI installed.

Developer API

Spoiler

namespace BeatPartnersAPI
{
using BeatPartners.API;
using System.Collections.Generic;
using System.IO;
using Rage;

internal static class BeatPartnersAPI
{
private const string DllPath = @"Plugins\BeatPartners.dll";
private static readonly bool DllExists = File.Exists(DllPath);

/// <summary>
/// One more wrapper to prevent <see cref="CanBeUsed"/> from trying to load the BeatPartners assembly.
/// </summary>
private static class IsLoadedWrapper
{
public static bool IsLoaded => Functions.IsLoaded;
}

/// <summary>
/// Gets whether the API functions can be called.
/// The 'BeatPartners.dll' must exist and has been loaded by the user.
/// </summary>
public static bool CanBeUsed => DllExists ? IsLoadedWrapper.IsLoaded : false;

public static ushort GetNumberOfBeatPartnersCreatedSinceLoaded => Functions.GetNumberOfCreatedBeatPartners;

public static int GetNumberOfActiveBeatPartners => Functions.GetNumberOfActiveBeatPartners;

public static bool IsPlayerMeetingWithAnyPartner => Functions.IsPlayerMeetingWithAnyPartner;

public static IReadOnlyCollection<Ped> RetrievePossibleEnemiesOfPlayer => Functions.RetrievePossibleEnemiesOfPlayer;
}
}

Take a look at the INI at least once to make sure you are satisfied with the settings. You can also modify the INI values within the in-game plugin menu.

If you are encountering crash upon ForceDuty, then install the latest version of RageNativeUI.

FYI: This plugin has been tested on vanilla settings (no additional plugins, only LSPDFR). There were minimum amount of crashes experienced. Also, due to a specific lack of feature in the LSPDFR API, units will not respond to callout locations, but will respond to the player's location and follow the player. They should be able to respond to the callout location in a future update.

Special thanks to:

@NoNameSet
LSPDFR Developer Discord

Edited August 7, 20223 yr by OJdoesIt

What's New in Version 1.0.0

Released August 7, 20223 yr

Cycling through Load Preset Data automatically loads the respective preset without needing to press the option
Allowed additional models to be added to the INI (also checks if they are appropriate models e.g. is a vehicle or ped)
Allowed additional presets to be added to the INI, and saved to the INI from the menu
Properly loads addon vehicles
Added dependency checker to verify RageNativeUI is installed
Added radio traffic monitor to prevent overload of notifications clogging the screen (e.g. 12 notifications of units responding to the pursuit)
Added monitoring of shooting to allow partners to respond if suspect(s) within assigned zone or within proximity
Added hotkey (double-press and hold control) to conveniently request partners to respond, outside of the main menu
Implemented feature where partner's blip will flash when they become involved in an incident (e.g. shooting, injured)
Added one-click option to immediately create partners based upon the number of defined presets
Implemented a buddy messaging system where your partners will send random text messages and ask to meetup for a smoke/drink break
Added option to remove all beat partners from Remove Partner menu item
Added ambient pursuit listener that'll have partners initiate random pursuits
Added option for newly created partners to immediately respond to any active events
Resolved crash when partner is used by LSPDFR to transport a suspect
Added API functions and events to be used for developers