# LG Dispatch These exports allow developers to: * Create dispatch calls * Trigger officer panic buttons * Retrieve active calls This allows easy integration with systems such as: * Robbery scripts * Gunshot detection systems * Alarm systems * Panic button items * Emergency alerts * \+ many more! ## CreateDispatchCall Creates a new call in the dispatch system and broadcasts it to all on-duty units. ``` exports['LG_Dispatch']:CreateDispatchCall(callData) ``` #### Example Usage ``` local callId = exports['LG_Dispatch']:CreateDispatchCall({ type = 'robbery', priority = 1, coords = { x = 215.3, y = -810.5, z = 30.7 }, street = 'Strawberry Ave', description = 'Armed robbery at Fleeca Bank', suspectInfo = 'IC1 male wearing black hoodie', vehicleInfo = 'Red Dominator, plate ABC123', createdBy = 'Store Alarm' }) ``` #### Fields **type** The call type from your config in the `Config.CallTypes` table. Example: ``` type = 'robbery' ``` *** **priority** The call priority / grade level. If not provided, the **defaultPriority from the call type** will be used. Example: ``` priority = 1 ``` *** **coords** The world coordinates where the incident occurred. Format: ``` coords = { x = 215.3, y = -810.5, z = 30.7 } ``` *** **street** The street or location name. Example: ``` street = 'Strawberry Ave' ``` If not provided it defaults to **Unknown Location**. *** **description** A description of the incident. Example: ``` description = 'Armed robbery at Fleeca Bank' ``` *** **callerNotes** Additional notes from the caller. Example: ``` callerNotes = 'Caller reports suspect still inside' ``` *** **suspectInfo** Description of suspects involved. Example: ``` suspectInfo = 'IC1 male wearing black hoodie' ``` *** **vehicleInfo** Vehicle description or plate information. Example: ``` vehicleInfo = 'Red Dominator, plate ABC123' ``` *** **postal** Postal code if your server uses a postal system. Example: ``` postal = '123' ``` *** **createdBy** The name of the system or person who created the call. Example: ``` createdBy = 'Store Alarm' ``` *** ## GetActiveCalls Returns all currently active dispatch calls. ``` exports['LG_Dispatch']:GetActiveCalls() ``` #### Example Usage ``` local calls = exports['LG_Dispatch']:GetActiveCalls() for _, call in ipairs(calls) do print(call.id, call.type, call.street) end ``` #### Returns ``` table ``` An array containing all active call objects. *** ## Panic Button Triggers a **Grade 1 officer assistance call** at the player's location. ``` exports['LG_Dispatch']:TriggerPanic() ``` #### Example Usage ``` -- client side exports['LG_Dispatch']:TriggerPanic() ``` #### What Happens When triggered: * A **Grade 1 panic call** is created * The officer's **current location** is used * The call is broadcast to **all emergency units** * The panic alert sound plays (if enabled) *** ## Default Configuration Below is the default configuration included with LG Dispatch. ``` Config = {} -- Framework detection: 'auto', 'qbcore', 'esx', 'tmc', 'qbox' Config.Framework = 'auto' Config.UseLGModsCAD = false -- leave false, for now... -- Keybind to open dispatch UI Config.OpenKey = 'F6' -- Jobs considered emergency services Config.EligibleJobs = { ['police'] = { label = 'Police', type = 'police', icon = 'shield-halved', color = '#3b82f6' }, ['ambulance'] = { label = 'Ambulance', type = 'Ambulance', icon = 'heart-pulse', color = '#22c55e' } } -- Unit statuses Config.Statuses = { { id = 'available', label = 'Available', color = '#22c55e' }, { id = 'busy', label = 'Busy', color = '#f59e0b' }, { id = 'enroute', label = 'En Route', color = '#3b82f6' }, { id = 'onscene', label = 'On Scene', color = '#8b5cf6' }, { id = 'atstation', label = 'At Station', color = '#64748b' }, { id = 'offduty', label = 'Off Duty', color = '#6b7280' }, } -- Call priorities Config.Priorities = { { id = 1, label = 'Grade 1 - Immediate', color = '#ef4444' }, { id = 2, label = 'Grade 2 - Prompt', color = '#f59e0b' }, { id = 3, label = 'Grade 3 - Standard', color = '#3b82f6' }, { id = 4, label = 'Grade 4 - Scheduled', color = '#64748b' }, } -- Call types with defaults Config.CallTypes = { ['999'] = { label = '999 Emergency Call', defaultPriority = 2, blip = true, blipSprite = 480, blipColor = 1, blipDuration = 30, autoExpire = 1800 }, ['panic'] = { label = 'Officer Assistance', defaultPriority = 1, blip = true, blipSprite = 526, blipColor = 1, blipDuration = 60, autoExpire = 900 }, ['robbery'] = { label = 'Robbery in Progress', defaultPriority = 1, blip = true, blipSprite = 156, blipColor = 1, blipDuration = 45, autoExpire = 1200 }, ['shooting'] = { label = 'Firearms Discharge', defaultPriority = 1, blip = true, blipSprite = 110, blipColor = 1, blipDuration = 45, autoExpire = 1200 }, ['traffic'] = { label = 'Vehicle Stop', defaultPriority = 3, blip = true, blipSprite = 326, blipColor = 38, blipDuration = 20, autoExpire = 1800 }, ['medical'] = { label = 'Medical Assistance', defaultPriority = 2, blip = true, blipSprite = 153, blipColor = 2, blipDuration = 30, autoExpire = 1200 }, ['fire_call'] = { label = 'Fire Incident', defaultPriority = 2, blip = true, blipSprite = 436, blipColor = 1, blipDuration = 30, autoExpire = 1200 }, ['general'] = { label = 'Incident Log', defaultPriority = 3, blip = false, blipSprite = 1, blipColor = 0, blipDuration = 0, autoExpire = 3600 }, } -- GPS update interval (ms) for live unit tracking Config.GPSUpdateInterval = 2000 -- Ignore similar calls within this radius (game units) and time (seconds) Config.DedupeRadius = 50.0 Config.DedupeTime = 30 -- Sounds Config.Sounds = { newCall = true, panic = true, } -- Permissions (minimum job grade required per job) -- Keys must match the job names in Config.EligibleJobs. -- Use ['*'] as a fallback for any job not explicitly listed. Config.Permissions = { closeCalls = { police = 0, -- Police: Grade 0+ ambulance = 0, -- Ambulance: Grade 0+, I've set these as examples ofc you can put whatever jobs you want here }, editPriority = { police = 2, ambulance = 2, }, addNotes = { police = 3, ambulance = 2, }, createCalls = { police = 0, ambulance = 0, }, manageUnits = { police = 2, }, mergeCalls = { police = 2, }, placeMarkers = { police = 2, }, } -- Callsign validation Lua pattern (empty string = no validation) -- Example: '^%u%u%d%d$' requires two uppercase letters + two digits Config.CallsignRegex = '' -- Show off-duty units on map Config.ShowOffDutyOnMap = false -- Default call expiry in seconds (0 = never) Config.DefaultCallExpiry = 3600 -- Notification style: 'toast' | 'chat' Config.NotificationStyle = 'toast' -- Unit trail breadcrumb settings (stored in memory, reset on restart) Config.UnitTrailLength = 50 Config.UnitTrailInterval = 3 -- Discord webhook for call notifications (leave empty to disable) Config.DiscordWebhook = '' Config.DiscordBotName = 'LG Dispatch' Config.DiscordBotAvatar = 'https://media.discordapp.net/attachments/1238207587887874118/1384714689350729808/lg_logo_solo.png?ex=69a98ccc&is=69a83b4c&hm=204f314cf5cf31a0cd2ab07c8f055a6af2a763b06b7fbb1a556a0199aa34a500&=&format=webp&quality=lossless&width=1895&height=1895' ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.lgmods.co.uk/scripts/lg-dispatch.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.