Bodycam & Dashcam

Installation

ensure ox_lib
ensure sx_bodycamdashcam

set R2_BUCKET ""
set R2_ACCOUNT_ID ""
set R2_ACCESS_KEY_ID ""
set R2_SECRET_ACCESS_KEY ""

Configuration

Ace Permission Setup

Available Ace Permissions

Example Usage

add_ace group.admin "DashcamSetup" allow
add_ace group.police "BodycamDashcam" allow # Only needed for standalone mode

Inventory Integration

ox_inventory

If you are using the ox_inventory inventory, you must include the export table within the item data for the bodycam item.

Example:

['bodycam'] = {
  label = 'Bodycam',
  weight = 0.1,
  consume = 0,
  server = {
    export = 'sx_bodycamdashcam.bodycam'
  }
},

-- Optional and only required if you're using the battery feature
['bodycam_battery'] = {
  label = 'Bodycam Battery',
  weight = 0.1,
  consume = 0,
  server = {
    export = 'sx_bodycamdashcam.battery'
  }
},

This is required for the item(s) to function properly with ox_inventory.

Bodycam Configuration

The bodycam script is highly configurable via the ClientConfig.Bodycam section. Below are the key options and their explanations:

Recording Storage

Bodycam recordings support:

• Fivemanage
• Cloudflare R2

Discord webhooks are not supported for bodycam video uploads as it is very limited in terms of the max file size.

Fivemanage Setup

To use Fivemanage for recording storage, you need to generate an API key from your Fivemanage dashboard.

Fivemanage = {
  ApiUrl = 'https://api.fivemanage.com/api',
  ApiKey = 'replace_with_your_api_key', -- HERE
  OnlyShowDepartmentRecordings = true,
  DepartmentFolderPaths = {
    ['police'] = '/police',
  },
}

Storage = {
  Provider = "fivemanage"
}

Cloudflare R2 Setup

To use Cloudflare R2, configure both your Cloudflare credentials and storage provider.

set R2_BUCKET "your_bucket_name"
set R2_ACCOUNT_ID "your_account_id"
set R2_ACCESS_KEY_ID "your_access_key_id"
set R2_SECRET_ACCESS_KEY "your_secret_access_key"

Storage = {
  Provider = "r2"
}

Recording Time Limit: The maximum recording duration can be configured in Recording.RecordingLimit (default: 300 seconds).

Permissions Configuration

If you are using a framework (not standalone), you must configure the Permissions table to control access to bodycam and dashcam features:

Permissions = {
    BodycamDashcam = {
        Ace = 'BodycamDashcam',
        Jobs = {
            ['police'] = 1
        }
    },
    ViewCameras = {
        Ace = 'BodycamDashcam',
        Jobs = {
            ['police'] = 2
        }
    },
    DeleteRecordings = {
        Ace = 'BodycamDashcam',
        Jobs = {
            ['police'] = 3
        }
    }
},

• BodycamDashcam: Allows the specified jobs to use bodycam & dashcam features.
• ViewCameras: Allows the specified jobs to view camera recordings.
• DeleteRecordings: Allows the specified jobs to delete recordings.

If you set ClientConfig.Framework to standalone, the script will ignore the Jobs table and instead require the Ace permission.

Storage Options

• OnlyShowDepartmentRecordings: Ensures that players with a job can only see recordings from their own folder path set in DepartmentFolderPaths. For example, a player with the police job will only be able to see recordings in the /police folder.
• DepartmentFolderPaths: Specifies the folder where recordings for each job are saved. For example, ['police'] = '/police' saves police recordings in the /police folder. Leaving this table empty will save all recordings in the root directory.

Dashcam Configuration

The dashcam script is configurable via the ClientConfig.Dashcam section. Below are the key options and their explanations:

Usage

Bodycam

• Toggle the bodycam overlay using the /bodycam command.
• Start recording by pressing the X or using the /recordbodycam command.
• The bodycam must be equipped and allowed for your job.
• If ClientConfig.Bodycam.Battery.Enabled is true, battery drains based on DrainInterval and DrainPercentage and the remaining percentage is shown in the Bodycam UI.
• Recording uploads footage to your configured provider (fivemanage or r2).

Dashcam

Use the /dashcamsetup command in-game to set up dashcam positions for vehicles. This command requires the DashcamSetup ace permission.

exports['sx_bodycamdashcam']:registerVehicleDashcam(netId, {
    jobName = player.PlayerData.job
})

Developers

Exports

Client exports

openCamerasTablet

Opens the Cameras tablet UI.

Returns true if the tablet was opened, false if the player is missing permissions.

local opened = exports.sx_bodycamdashcam:openCamerasTablet()
if not opened then
  -- player does not have ViewCameras permission
end

viewBodycamFeed

Starts viewing a specific bodycam feed.

Parameters

local result = exports.sx_bodycamdashcam:viewBodycamFeed(1)
if not result then
  -- e.g. show an error notification
end

Returns false on failure (permission denied, bodycam not found, target ped not reachable) or a table on success.

{
  targetServerId = 12,
  targetPedCoords = vec3(0, 0, 0),
  isRecording = false
}

viewDashcamFeed

Starts viewing a vehicle's dashcam feed.

Parameters

local vehicleNetId = NetworkGetNetworkIdFromEntity(vehicleEntity)
local result = exports.sx_bodycamdashcam:viewDashcamFeed(vehicleNetId)
if not result then
  -- e.g. show an error notification
end

Returns false on failure (no dashcam on vehicle, permission denied, vehicle not found) or a table on success.

{
  dashcamId = 1,
  vehicleNetId = 123,
  vehicleCoords = vec3(0, 0, 0)
}

Server exports

getActiveBodycams

Returns a list of currently active bodycams.

Returns table[].

local bodycams = exports.sx_bodycamdashcam:getActiveBodycams()
for _, cam in ipairs(bodycams) do
  print(cam.officerName, cam.status, cam.coords)
end

isBodycamActive

Returns whether a specific player currently has an active bodycam.

Parameters

Returns boolean

local isActive = exports.sx_bodycamdashcam:isBodycamActive(source)

isPlayerRecording

Returns whether a specific player is currently recording their bodycam.

Parameters

Returns boolean

local isRecording = exports.sx_bodycamdashcam:isPlayerRecording(source)
if isRecording then
  -- player is actively recording right now
end

getActiveDashcams

Returns a list of currently registered dashcams.

Returns table[].

local dashcams = exports.sx_bodycamdashcam:getActiveDashcams()
for _, cam in ipairs(dashcams) do
  print(cam.vehicleNetId, cam.jobName)
end

getRecordings

Fetches a paginated list of recordings from the configured storage backend (fivemanage or r2).

Parameters

local recordings = exports.sx_bodycamdashcam:getRecordings(1, 20, 'police/')
if not recordings then
  return
end

for _, rec in ipairs(recordings.data) do
  print(rec.name, rec.url)
end

Returns table[] or nil on error.

Guides

Troubleshooting

• Ensure ox_lib is installed and started before sx_bodycamdashcam. Click here
• Make sure you have the correct ace permissions for the Bodycam & Dashcam. Click here