Dispatcher

Introduction

Squizer's police dispatch for FiveM — a live tactical map of on-duty officers and police vehicles, with bodycam / dashcam spectating and an on-screen bodycam HUD. Works on ESX · QBCore · Qbox.

Get it now!

FiveM Post

Tebex Store

What you get

• Live map of every on-duty officer and police vehicle (smooth, no lag).
• Bodycam spectate — watch an officer's live first-person feed while their camera is ON.
• Dashcam + crew camera — watch a police vehicle; press E to switch to the cabin cam.
• Bodycam HUD — a small REC badge on the officer's screen while recording.
• No hard dependencies — needs only your framework (ESX / QBCore / Qbox).
• Fully translatable — ships with 🇨🇿 🇬🇧 🇪🇸 🇩🇪.

Full setup guide

This page focuses on the bodycam. The complete setup (map tiles, terminals, calibration, logging, …) is included with the resource in docs/en.md.

---

The Bodycam

What it does — in plain words

Every police officer has a bodycam. It can be ON or OFF:

• When it is ON → a dispatcher can click that officer on the map and watch their live first-person camera, and the officer sees a small REC badge on their screen.
• When it is OFF → nobody can watch that officer. If someone was already watching them, the view stops automatically.

That's the whole idea. The only thing you have to decide is how officers turn their bodycam on — and you set that with a single option.

Step 1 — pick how it turns on

Open config.lua, find Config.BodycamHud and set mode to one of these:

Mode	How the officer turns the bodycam on	Best for
event (default)	Another script/item, a command, or an export turns it on	Most servers — flexible, works with anything
item	The officer uses a bodycam item in their inventory	ox_inventory servers that want a physical item
always	It is always ON automatically while the player is police	The simplest possible setup — no item, no command

If you are not sure, start with always (nothing to configure) or event and a simple command (shown below).

Step 2 — the settings

Config.BodycamHud = {
    mode  = 'event',   -- 'event' | 'item' | 'always'  → pick ONE (see the table above)
    hud   = true,      -- show the small REC badge on the officer's screen
    emote = true,      -- play a short bodycam gesture when it turns on/off

    -- Used only by mode = 'event'
    toggleEvent  = 'sqz_dispatcher:bodycam:toggle',
    disableEvent = 'sqz_dispatcher:bodycam:disable',

    -- Used only by mode = 'item'  (must match the item name in ox_inventory)
    item = 'bodycam',

    -- Advanced: server-side events you can trigger to force it on/off for a player
    enableServerEvent  = 'sqz_dispatcher:bodycam:serverEnable',
    disableServerEvent = 'sqz_dispatcher:bodycam:serverDisable',
}

You usually only touch mode

hud and emote are personal taste. The event/item names already work out of the box — only change them if you have a good reason.

---

Turn it on/off from any script (exports)

These three exports work in every mode and can be called from any resource or command:

exports.sqz_dispatcher:ToggleBodycam()   -- ON if it's OFF, OFF if it's ON
exports.sqz_dispatcher:EnableBodycam()   -- force ON
exports.sqz_dispatcher:DisableBodycam()  -- force OFF

Beginner example — a simple /bodycam command that toggles it:

RegisterCommand('bodycam', function()
    exports.sqz_dispatcher:ToggleBodycam()
end)

Drop that into any client script and your officers can flip their bodycam with /bodycam.

---

Using it as an item (only for mode = 'item')

If you chose item, add the item to ox_inventory/data/items.lua and point it at this resource:

['bodycam'] = {
    label = 'Body Camera',
    weight = 250,
    stack = false,
    close = true,
    consume = 0,                                -- 0 = reusable (the item is NOT used up)
    server = { export = 'sqz_dispatcher.bodycam' },
}

Two things must match

1. The name after the dot in sqz_dispatcher.bodycam must equal Config.BodycamHud.item.
2. Keep consume = 0 so the camera can be toggled again and again.

Restart the server after editing items.lua.

---

How a dispatcher watches a bodycam

1. Walk to a dispatch terminal and open the map.
2. Click an officer on the map or in the unit list.
   • Officers are only watchable while their bodycam is ON (shown with a green marker).
3. While watching:

Key	Action
◄ / ►	switch to the previous / next unit
BACKSPACE	stop watching

---

Bodycam not working? Quick fixes

• Can't watch an officer → their bodycam is OFF. Dispatchers can only watch officers whose bodycam is ON (green marker).
• The item does nothing → in ox_inventory/data/items.lua the item's server.export must be sqz_dispatcher.<your item name> and consume = 0; then restart the server.
• No REC badge on screen → set hud = true in Config.BodycamHud.
• Want it on for everyone with no setup → set mode = 'always'.