LEO Interaction

{:links-list}

This page describes the current project source and supplied resource configuration, whose manifest lists version 1.2.0+.

NOT COMPATIBLE WITH SEM INTERACTIVE

Do not run LEO Interaction and SEM together; they conflict.

INSTALLATION

  1. Extract the downloaded resource folder into your server's resources folder. Keep the name BigDaddy-LEO.
  2. Add your product key from your account to key1 under [licensing] in settings.ini.
  3. Choose a menu using the configuration below. Start BigDaddy-BDMenu before LEO if you choose BDMenu.
  4. Start any optional integrations you use before LEO, then add ensure BigDaddy-LEO to server.cfg.

DO NOT RENAME THE FOLDER.

The resource uses the name BigDaddy-LEO to load its files and call its exports.

{:is-danger}

Integrations

Resource Used for
BigDaddy-BDMenu The non-radial menu. See BDMenu documentation.
pma-voice Megaphone voice effects and proximity override. The supplied megaphone scripts call this resource directly.
BigDaddy-TrafficControl Traffic equipment from the trunk. /trunkitems is registered only if Traffic Control is already running when LEO initializes.
BigDaddy-UnderTheInfluence Drug test results and alcohol readings. See the breathalyzer limitation below.
BigDaddy-Bombs Actual bomb detection during a vehicle bomb search. Without it, the search provides a roleplay animation and chat prompt.

PLAYING

Use the menu or the commands below. Most player interactions require you to stand close to the target; cuffing, breathalyzer tests, and drug swabs require a target within two metres and outside a vehicle.

Commands

Commands can also be assigned to a Stream Deck or other macro setup. Almost all of these can also be fired from the menu.

Command Action
/setbac <level> Set your roleplay blood alcohol level, for example /setbac 0.21. /setbac 0 or /setbac 0.0 clears the override.
/cuff Cuff the nearest player.
/cuffh Cuff the nearest player roughly.
/uncuff Uncuff the nearest cuffed player.
/tackle Attempt to tackle a nearby player.
/hu Toggle hands up.
/huk Toggle hands up and kneel.
/drop Drop your current weapon.
/pickup Pick up the nearest dropped weapon.
/grab Grab and guide a nearby player, or release the player you are holding.
/frisk Frisk the nearest player.
/seat Put the player you are holding into a nearby vehicle. If you are not holding a player, attempt to remove a nearby occupant.
/unseat Alias of /seat; it uses the same context-dependent action.
/pull Pull a player from a vehicle roughly.
/megaphone Toggle the megaphone. Requires pma-voice for its voice integration.
/breath Give a nearby player a breathalyzer test.
/drugswab [type] Test for Weed, Meth, Opiates, MDMA, LSD, or All. Defaults to All. Results require Under the Influence.
/spotlight Activate a vehicle spotlight from the driver or front passenger seat. Aim with the camera, press Z to lock/unlock its direction, and X to switch it off. The driver-side action excludes planes and helicopters.
/trunkitems Open Traffic Control's item menu at a nearby vehicle's trunk. Requires Traffic Control to be running when LEO initializes.
/copidle Toggle cycling cop idle animations. Movement interrupts the idle animation; it resumes when idle.
/searchvehicle Perform a roleplay vehicle search with repeated chat prompts. Press X to stop. This does not automatically query a vehicle inventory.
/bombsearchvehicle Search a nearby vehicle for a bomb using BigDaddy-Bombs, or perform a roleplay search if that resource is absent.
/flashlight [mode] Use a flashlight: 1 = shoulder, 2 = waist, 3 = pointable. Defaults to 1. Press X to put it away.

The following commands are registered when useRadialMenu=false:

Command Action
/open_leo_menu Open the BDMenu version of LEO Interaction.
/bdleo_open_menu Alternate menu command if another resource conflicts with /open_leo_menu.

Breathalyzer and drug tests

A manually set BAC takes priority over the alcohol reading from Under the Influence. Clearing the override lets the test use Under the Influence again, or a calculated fallback of BAC: 0.0 if that resource is absent.

Current source limitation: the breathalyzer only displays its result notification when BigDaddy-UnderTheInfluence is running, even when a player has set a manual BAC. Drug swabs also only display results with that integration running.

Keys

Default key/control Action Configuration
F1 Open the selected menu. BDMenu: MenuKey in settings.ini; radial: openKey in menu.ini.
U Hands up. handsUpKey
Left Alt + U Hands up and kneel. kneelActivatorKey + handsUpKey
Left Alt + E Tackle. tackleActivatorKey + tackleKey
Control 79 Cycle flashlight modes while the flashlight is active. flashlightSwapKey
X Stop a normal vehicle search or put away the flashlight; switch off an active spotlight. Fixed control 73.
Z Lock/unlock spotlight direction. Fixed control 48.
Hold the vehicle exit key Leave the vehicle door open when exiting. keepDoorOpen

X is not a universal animation cancel key. During a bomb search it ends the initial search loop, but the BigDaddy-Bombs detection sequence can still continue.

CONFIGURATION

settings.ini

These values match the supplied resource's settings.ini. Section and setting names are case-insensitive. Restart LEO after changing configuration; existing client key bindings may also need to be changed in FiveM's key binding settings.

[licensing]

Setting Value Description
key1 Your product key Enter your own key from your account.

[settings]

Setting Supplied value Description
useMenu true Legacy entry in the supplied file. The inspected LEO client does not read it; use the menu selection settings below.
useRadialMenu false false registers BDMenu commands and its key binding; true omits them. The radial menu is enabled/disabled separately in menu.ini.
MenuKey F1 Default BDMenu key. Players can change the binding named Open LEO Menu (non radial) in FiveM's key binding settings.
NoFlashLightFightStance false Disable the fight stance while using the flashlight.
NoFightStance true Disable the fight stance generally.
wheelPositionSticksOnStop true Keep the steering angle when stopped.
safetyZoneOnStop true Enable the traffic-stop safety zone around stopped emergency vehicles with lights on.
keepDoorOpen true Hold the exit key briefly to leave the vehicle door open.
useAcePermissions false Request an ACE check at startup. The current LEO client does not enforce the returned result; see Permissions below.
acePermission command ACE checked by the server when useAcePermissions=true.
flashlightSwapKey 79 Control ID for cycling flashlight modes.
tackleActivatorKey 19 Modifier control for tackling; Left Alt by default.
tackleKey 38 Primary tackle control; E by default.
handsUpKey 303 Hands-up control; U by default.
kneelActivatorKey 19 Modifier for hands up and kneel; Left Alt by default.
chanceResistingFails 50 Resistance failure threshold. Higher values make resistance less likely to succeed; 100 prevents success.
spotlightEmergencyVehiclesOnly false Restrict vehicle spotlights to emergency-class vehicles when enabled.
distance 150 Radius used to collect nearby vehicles for spotlight processing.
Debug false Enable additional client/server debug logging. Some diagnostic messages are always printed.
DesyncKey Supplied with the resource Internal synchronization setting. Keep the supplied value.

[locales]

Setting Supplied value Description
frisk You are being searched, WDIF Chat prompt during a player search.
vehicleSearch Your vehicle is being searched, WDIF Chat prompt during a vehicle search; also used by the roleplay bomb-search fallback.

Choose a menu

Desired menu settings.ini under [settings] menu.ini under [settings]
BDMenu only useRadialMenu=false disableMenu=true
Radial only useRadialMenu=true disableMenu=false
Both menus useRadialMenu=false disableMenu=false; assign different keys to the two menus.
Neither menu useRadialMenu=true disableMenu=true

BDMenu

Install and start BigDaddy-BDMenu before LEO. Edit the menu.json inside the installed BigDaddy-LEO resource to customize its actions and permissions. See BDMenu documentation.

The supplied Police Vehicle Actions submenu has "permission": "police.vehicle". Configure that ACE for the players who should see the submenu, or customize the menu permission for your server.

Permissions

BDMenu item permissions control menu access. The radial menu does not use those BDMenu permission fields.

Radial menu: menu.ini

All entries below belong under [settings] and apply to the bundled radial menu.

Setting Supplied value Description
MenuName LEO INTERACTION Radial menu title.
menuBaseSize 60 Legacy size entry in the supplied configuration; the current shared radial source does not read it.
openKey 288 Default radial opening control (F1).
disableMenu false Disable the radial menu when true.

To change the radial menu key, update openKey in menu.ini and the active OpenKey = "F1"; assignment in html/index.html to the matching key name. The INI uses a numeric control ID; the HTML uses the keyboard key name. Edit the active script, not the older commented-out scripts elsewhere in the file. Existing client bindings may also need updating in FiveM's key binding settings.

The bundled HTML closes the radial menu when the configured OpenKey is released, or when Escape or Backspace is released. Alt toggles menu focus.

Cop idle animations

CopAnims.json supplies the animations cycled by /copidle. Entries use isScenario, dict, and anim to describe scenarios or animation dictionary/clip pairs.