Every option in shared/config.lua grouped by block, with defaults and descriptions.

Configuration

Most settings live in shared/config.lua. Departments are in shared/departments.lua and the penal code in shared/penalcode.lua. These files, together with editable/ and locales/, are not escrowed, so you can edit them freely. Restart the resource after changes.

File	Purpose
`shared/config.lua`	All options below
`shared/departments.lua`	Departments, jobs, colors, crests, rank to access level. See Departments and permissions
`shared/penalcode.lua`	`Config.PenalCode`: 57 charges seeded into the database on first start. After that, charges are edited in game with the `charges.manage` permission
`editable/server/framework.lua`	Citizen, vehicle, license and roster queries. See Integrations
`editable/server/integrations.lua`	Jail, impound, fine, society payout, medical bill adapters
`editable/client/integrations.lua`	Death check, vehicle-only rule, phone number, notifications
`locales/*.json`	Translations. See Translations

Values shown as {} or '' are empty by default. Percent and seconds are as named.

General

Config.Locale and Config.Languages

Option	Default	Description
`Config.Locale`	`'en'`	Server default language code. Falls back to `en` if the file does not exist.
`Config.Languages.playerChoice`	`true`	Lets each player pick their own language in Settings.
`Config.Languages.offered`	`{}`	Whitelist of language codes players can choose from. Empty offers all languages. The server default is always offered.
`Config.Debug`	`false`	Prints extra debug lines in the server console.

Config.VersionCheck

Option	Default	Description
`enabled`	`true`	Checks for a new version at start and prints the result in the console.
`url`	`'https://versions.kojascripts.com'`	Version service address.
`reportOtherResources`	`true`	Also reports other Koja resources found on the server.

Config.Open

How the MDT is opened.

Option	Default	Description
`command`	`'mdt'`	Chat command. Empty string disables the command and the key.
`keybind`	`'F6'`	Default key. Players can rebind it in the FiveM keybind settings.
`item`	`'mdt_tablet'`	Inventory item that opens the MDT when used. Empty string turns the usable item off.
`requireItem`	`false`	When `true`, the player must carry the item to open the MDT.
`vehicleOnly`	`false`	When `true`, the MDT only opens inside an emergency class vehicle (vehicle class 18).
`allowWhenDead`	`false`	Allow opening the MDT while dead.
`allowOffDuty`	`true`	When `false`, officers must be on duty to open the MDT.

Config.Tablet

Tablet prop and animation while the MDT is open.

Option	Default	Description
`enabled`	`true`	Show the tablet prop and play the animation.
`prop`	`'prop_cs_tablet'`	Prop model.
`bone`	`60309`	Ped bone the prop attaches to.
`offset`	`vector3(0.03, 0.002, -0.0)`	Prop position offset.
`rotation`	`vector3(10.0, 160.0, 0.0)`	Prop rotation.
`dict`	`'amb@code_human_in_bus_passenger_idles@female@tablet@base'`	Animation dictionary.
`clip`	`'base'`	Animation clip.

Config.Ui

Option	Default	Description
`scale`	`1.0`	Overall tablet scale.
`defaultTheme`	`'department'`	Default theme source. `department` uses the department theme.
`allowPersonalAccent`	`true`	Players can pick a personal accent color in Settings. It overrides the accent, not the surfaces.
`fadeOutside`	`0.4`	Tablet opacity when the mouse moves outside it.
`clockFormat`	`'24h'`	Clock format.
`currency`	`'$'`	Currency symbol shown in the UI.
`dateLocale`	`'en-US'`	Locale used to format dates.

Config.Interact

The quick interaction menu for officers: ask for ID, write a citation, run a plate, parking citation, open the MDT. It works with a radial menu or a target resource.

Option	Default	Description
`enabled`	`true`	Turn the interaction menu on or off.
`key`	`'LMENU'`	Default key (left Alt). Hidden when a radial or target provider takes over.
`command`	`'mdtinteract'`	Command behind the key (registered as `+mdtinteract`).
`radial`	`'auto'`	Radial menu provider: `'auto'`, a resource name (`koja-police`, `ox_lib`, `qb-radialmenu`), or `false` / `'off'` / `'none'`.
`target`	`'auto'`	Target provider: `'auto'`, a resource name (`ox_target`, `koja-interactions`, `qb-target`), or `false` / `'off'` / `'none'`.
`keyWithProvider`	`false`	Keep the key binding even when a provider is active.
`replacePoliceItems`	`true`	With koja-police, replaces its own radial items (check ID, check plate, bill, MDT) with the MDT versions.
`distance`	`4.0`	Maximum distance to a person.
`vehicleDistance`	`7.0`	Maximum distance to a vehicle.
`askConsent`	`true`	The other player is asked before their ID card is shown.
`consentTimeout`	`15`	Seconds the other player has to answer.

Config.DebugTools

Demo and test tools. Details in Demo mode.

Option	Default	Description
`enabled`	`true`	Registers `/mdtdebug` and the demo seed. Set to `false` in production.
`aces`	`{ 'koja-mdt.debug', 'command' }`	Aces that may use the tools.
`signChance`	`0.75`	Chance that a fake citizen signs a citation when the mood is `random`.
`officerModel`	`'s_m_y_cop_01'`	Ped model for fake officers (`/mdtdebug cam`).
`citizenModels`	five civilian models	Ped models for fake citizens.
`patrolVehicle`	`'police'`	Vehicle for `/mdtdebug cam drive`.
`citizenVehicle`	`'sultan'`	Vehicle for `/mdtdebug citizen car`.

Records and justice

Config.Records

Option	Default	Description
`sharedBetweenDepartments`	`true`	All law enforcement departments see the same records. When `false`, records are split per department (DOJ still sees all).
`citizenSearchLimit`	`25`	Maximum people returned by a search.
`vehicleSearchLimit`	`25`	Maximum vehicles returned by a search.
`maxNarrativeLength`	`20000`	Maximum characters in a report narrative.
`maxImagesPerRecord`	`12`	Maximum photos per record.
`vehicleStrikeLimit`	`12`	Strike points on a vehicle at which the limit warning shows.
`defaultWarrantHours`	`72`	Default warrant lifetime in hours.
`warrantsNeedApproval`	`true`	New warrants wait for a judge (`warrants.approve`).
`expireWarrantsEveryMinutes`	`5`	How often expired warrants and overdue citations are checked.

Config.Processing

Sentencing a suspect from a report.

Option	Default	Description
`enabled`	`true`	Allow processing (fine and jail) from reports.
`requireOnline`	`true`	The suspect must be online.
`maxDistance`	`10.0`	Maximum distance between officer and suspect.
`fineAccount`	`'bank'`	Account the fine is taken from. If the balance is too low, cash is used.
`fineSociety`	`'society_police'`	Society account that receives fines. Empty string disables the payout.
`allowNegativeBalance`	`false`	Allow the bank balance to go below zero.
`jailSystem`	`'auto'`	`'auto'`, a jail resource name, or `'none'`. See Integrations.
`maxMonths`	`999`	Highest jail sentence.
`pointsLicense`	`'driver'`	License type that receives penalty points.
`pointsRevokeAt`	`12`	Point total at which the license is revoked automatically.

Config.Custody

Jail and impound records. See also the custody guide in Features.

Option	Default	Description
`enabled`	`true`	Turn the Custody module on or off.
`impoundSystem`	`'auto'`	`'auto'`, `'koja-police'`, `'garage'` or `'none'`. `auto` uses koja-police when started, otherwise the garage fallback.
`secondsPerMonth`	`60`	Real seconds per sentence month. Keep it equal to your jail script.
`maxMonths`	`999`	Highest sentence the MDT stores.
`autoRelease`	`true`	Closes a jail record when its release time has passed.
`trackedSystems`	`{}`	Jail systems that report releases themselves; their records are never closed by the clock.
`defaultFee`	`500`	Default impound fee.
`maxFee`	`50000`	Highest impound fee.
`defaultHours`	`24`	Default hold time in hours.
`maxHours`	`720`	Longest hold time in hours.
`despawnRadius`	`15.0`	When an officer impounds in game, a vehicle with that plate within this radius is removed. `0` turns it off.
`lots`	four lots	Impound lots: `{ id, label, coords }`. Defaults are Mission Row, Davis, Sandy Shores and Paleto Bay.

Config.Citations

Option	Default	Description
`enabled`	`true`	Turn citations on or off.
`item`	`'citation'`	Inventory item for printed copies.
`dueDays`	`7`	Days to pay before a ticket becomes overdue.
`lateFee`	`{ percent = 25, flat = 0 }`	Added once when a ticket becomes overdue.
`allowWebPay`	`true`	Pay from the web portal. Works when the citizen is online, or when `Bridge.ChargeOffline` is added in `editable/server/framework.lua`.
`applyPoints`	`true`	Add the ticket's points to the license point total.
`classes`	`{ 'infraction' }`	Penal code classes that can be ticketed.
`allowNoJailCharges`	`true`	Also allow any charge with 0 months.
`maxViolations`	`12`	Maximum violations on one ticket.
`handDistance`	`5.0`	Maximum distance for handing over the ticket.
`showOnHandover`	`true`	Show the paper on the violator's screen after hand-over.
`contestCreatesCase`	`true`	A contested ticket files a court case.
`contestGraceDays`	`3`	Extra days to pay after a contest is upheld.
`prefixes`	`lspd = 'LS'`, `bcso = 'BC'`, `sahp = 'SA'`, `default = 'SAN'`	Ticket number prefix per department id. Numbers look like `LS-2026-000123`.
`quick`	eight charge codes	Charge codes shown as quick-pick chips.
`command`	`'citation'`	Chat command for the ticket book. Empty disables it.
`key`	`''`	Optional default key for the ticket book.
`bookInGame`	`true`	New citation in the in-game MDT opens the ticket book. The web MDT always uses the form.
`nearbyRadius`	`10.0`	Radius of the nearby people list in the book.
`requireOfficerSignature`	`true`	The officer must sign before filing.
`askCitizenSignature`	`true`	The person receiving the ticket is asked to sign or refuse.
`signTimeout`	`30`	Seconds to answer. No answer counts as a refusal.
`issueCooldown`	`8`	Seconds between two tickets from one officer.
`tearSound`	`true`	Paper tear sound in the book.
`readAnim`	clipboard	Animation and prop while reading the paper (`enabled`, `dict`, `clip`, `prop`, `bone`, `offset`, `rotation`).
`writeAnim`	notepad and pencil	Animation and props while writing (`enabled`, `dict`, `clip`, `prop`, `bone`, `offset`, `rotation`, `pencil`, `pencilBone`, `pencilOffset`, `pencilRotation`).
`handAnim`	give and take	Hand-over animation (`enabled`, `dict`, `give`, `take`, `prop`, `bone`, `offset`, `rotation`, `giveHold`, `takeAt`, `takeHold`, `signDelay`).

Config.Doj

Court and DOJ options.

Option	Default	Description
`caseNumberPrefix`	`'SA'`	Case number prefix.
`courtrooms`	`Courtroom 1`, `Courtroom 2`, `Courtroom 3`, `Chambers`	Rooms offered when scheduling.
`caseTypes`	`criminal`, `traffic`, `civil`, `appeal`	Case types.
`hearingKinds`	`arraignment`, `preliminary`, `motion`, `trial`, `sentencing`, `appeal`, `other`	Hearing kinds.
`docketKinds`	`note`, `filing`, `motion`, `ruling`, `order`	Docket entry kinds.
`linkKinds`	`incident`, `evidence`, `bodycam`, `warrant`, `citation`, `document`	Record types that can be linked to a case.
`sentence.enabled`	`true`	Allow carrying out sentences from the court page.
`sentence.requireOnline`	`true`	The defendant must be online.
`sentence.fine`	`true`	A sentence can apply the fine.
`sentence.jail`	`true`	A sentence can apply jail time.
`expungement.enabled`	`true`	Expungement requests.
`expungement.portal`	`true`	Citizens can request through the web portal.
`expungement.maxPending`	`2`	Open requests per person.
`bar.roles`	`attorney`, `public_defender`, `prosecutor`, `judge`	Roles in the bar registry.
`bar.numberPrefix`	`'SABAR'`	Bar number prefix.
`seedForms`	`true`	On first start, DOJ departments get four form templates: subpoena, search warrant order, court order, expungement order.

Config.Police

Link to the koja-police resource.

Option	Default	Description
`enabled`	`true`	Use koja-police when it is started.
`resource`	`'koja-police'`	Resource name.
`dispatch`	`true`	Let koja-police use the MDT dispatch.
`duty`	`true`	Share duty state with koja-police.

Dispatch and units

Config.Dispatch

Option	Default	Description
`enabled`	`true`	Turn dispatch and the public call commands on or off.
`publicCommands`	`/911` (priority 1), `/311` (priority 3)	Commands players use to call. Each entry: `command`, `code`, `title`, `priority`.
`publicCooldown`	`30`	Seconds between public calls from one player.
`anonymousCommand`	`'911a'`	Anonymous call command. Empty disables it.
`panicKey`	`'F9'`	Default key for the panic button (10-99). Empty disables the key.
`panicCooldown`	`15`	Seconds between panic presses.
`keepCallsMinutes`	`30`	How long closed calls stay in the log.
`maxCalls`	`80`	Maximum calls kept.
`blipSeconds`	`90`	How long a call blip stays on the map.
`alertSound`	`true`	Play a sound for new priority calls.
`toastSeconds`	`8`	How long the call toast shows.
`callCodes`	six fire codes	Extra call codes `{ code, title, priority, types }`. `types` is the department types that receive the call (`leo`, `ems`, `fire`). Defaults: `F-STR`, `F-VEH`, `F-BRU`, `F-ALM`, `F-RES`, `F-HAZ`.

Config.Dispatch.gunshots

Automatic "shots fired" calls. The player's client watches for gunfire and the server turns it into a dispatch call to law enforcement, with a witness as the caller.

Option	Default	Description
`enabled`	`true`	Turn gunshot alerts on or off. Also needs `Config.Dispatch.enabled`.
`code`	`'10-71'`	Call code.
`title`	`'Shots fired'`	Call title.
`priority`	`1`	Call priority.
`message`	`'Caller reports gunshots in the area.'`	Call message.
`vehicleMessage`	`'Caller reports shots fired from a vehicle: %s %s.'`	Message when the shooter is in a vehicle. The two values are the vehicle color and model.
`reportDelay`	`{ 3, 8 }`	Random delay in seconds, `{ min, max }`, before the call appears.
`cooldownSeconds`	`30`	Seconds between alerts from one player.
`mergeRadius`	`120.0`	Shots within this distance of a recent alert do not create a new call.
`mergeSeconds`	`60`	How long a recent alert blocks new ones inside `mergeRadius`.
`fuzzRadius`	`35.0`	The call location is moved by a random distance up to this value, so it is not exact.
`ignoreOnDuty`	`true`	Players on duty in one of the `ignoreJobs` do not trigger alerts.
`ignoreJobs`	`{ 'police', 'sheriff', 'sahp' }`	Jobs ignored while `ignoreOnDuty` is on.
`ignoreSilenced`	`true`	Silenced weapons do not trigger alerts.
`ignoreWeapons`	stun gun, fire extinguisher, petrol and hazard cans, flares, snowball, ball, Up-n-Atomizer	Weapons that never trigger alerts. Weapon names, for example `'WEAPON_STUNGUN'`.
`ignoreZones`	three zones	Places where shooting is ignored, such as gun ranges. Each entry: `{ coords = vector3(...), radius = 25.0 }`.

Config.QuickDispatch

The small call overlay shown on screen while the MDT is closed.

Option	Default	Description
`enabled`	`true`	Turn the overlay on or off.
`side`	`'right'`	Screen side.
`maxVisible`	`4`	Calls shown at once.
`idleSeconds`	`20`	Seconds before the overlay fades when idle.
`dropMinutes`	`15`	Minutes after which a call is dropped from the overlay.
`keys.respond`	`'Y'`	Respond to the focused call.
`keys.dismiss`	`'DELETE'`	Dismiss the focused call.
`keys.previous`	`'PAGEUP'`	Focus the previous call.
`keys.next`	`'PAGEDOWN'`	Focus the next call.
`keys.toggle`	`'HOME'`	Show or hide the overlay.

Config.DispatchVoice

A radio dispatcher reads new calls aloud. Officers can turn it off and change the volume in Settings.

Option	Default	Description
`enabled`	`true`	Turn the voice on or off.
`language`	`'en'`	Voice clip language (clips ship for English and Polish).
`volume`	`0.8`	Default volume.
`radioFx`	`true`	Radio effect on the voice.
`alphabet`	`'lapd'`	Phonetic alphabet, `lapd` or `nato`.
`minPriority`	`3`	Priority threshold for spoken calls. Priority 1 is the most urgent.
`maxQueue`	`4`	Maximum queued announcements.
`staleSeconds`	`25`	Announcements older than this are skipped.
`speechFallback`	`true`	Use the browser speech synthesis when a clip is missing.
`announce.new`	`true`	Announce new calls.
`announce.panic`	`true`	Announce panic alerts.
`announce.attach`	`true`	Announce responding units.
`announce.closed`	`false`	Announce closed calls.

Config.Units

Unit statuses shown on the unit board.

Option	Default	Description
`statuses`	`available 10-8`, `busy 10-6`, `enroute 10-97`, `onscene 10-23`, `traffic 10-38`, `break 10-7`	Default statuses `{ id, code, color }`.
`byType`	`ems`, `fire`, `doj` lists	Status lists per department type. EMS adds `transport` and `hospital`, fire adds `staging`, DOJ uses `court`.
`autoEnrouteOnAttach`	`true`	Attaching to a call sets the status to en route.
`setWaypointOnAttach`	`true`	Attaching to a call sets a GPS waypoint.

A department can also define its own statuses list in shared/departments.lua.

Config.Duty

Option	Default	Description
`trackTime`	`true`	Track duty time for hours and the heatmap.
`syncWithFramework`	`true`	Duty in the MDT also sets the framework job duty.
`toggleCommand`	`'mdtduty'`	Chat command to toggle duty. Empty disables it.

Config.Roster

Option	Default	Description
`selfCallsign`	`true`	Officers may set their own callsign and badge.
`hireGrade`	`0`	Job grade given when hiring a nearby player.
`fireJob`	`'unemployed'`	Job given when someone is fired.
`fireGrade`	`0`	Grade given when someone is fired.

Photos and cameras

Config.Camera

The Take a photo button for mugshots, evidence and reports. Needs screenshot-basic.

Option	Default	Description
`enabled`	`true`	Turn the photo button on or off.
`uploadUrl`	`''`	Keyless upload endpoint, for example a Discord webhook. This file is sent to every client, so never put an API key here. For Fivemanage or S3 use `Config.Storage` (below) with `images = 'storage'` instead, which uploads through the server. When both are empty the photo button is hidden. Image links can always be pasted by hand.
`uploadField`	`'files[]'`	Form field name for the file.
`encoding`	`'webp'`	Image format.
`quality`	`0.85`	Image quality (0 to 1).

Config.Storage

Where bodycam footage and MDT images are kept. The default keeps everything on the server disk and images inline in the database, exactly as before. See Storage and CDN for step by step setup of Cloudflare R2, AWS S3, Backblaze B2, MinIO and Fivemanage.

Option	Default	Description
`driver`	`'local'`	`'local'`, `'s3'` (any S3-compatible service) or `'fivemanage'`.
`images`	`'inline'`	`'inline'` stores uploaded pictures as data URLs in the database. `'storage'` uploads them through the server to the driver and saves the public URL.
`footage`	`'local'`	`'local'` keeps bodycam segments in `recordings/` inside the resource. `'storage'` uploads each segment to the driver and removes the local copy.
`segmentSeconds`	`10`	Seconds of footage packed into one segment file (2 to 60). At 8 fps that is 80 frames and 360 uploads per recording hour.
`concurrency`	`3`	Parallel uploads and deletes.
`maxBacklog`	`400`	Jobs held in memory. Extra segments wait on disk and are picked up every 30 seconds.
`s3.endpoint`	`''`	S3 API endpoint, for example `https://<accountid>.r2.cloudflarestorage.com`.
`s3.region`	`'auto'`	`'auto'` for R2. AWS, B2 and MinIO need their real region, for example `'eu-central-1'`.
`s3.bucket`	`''`	Bucket name.
`s3.publicUrl`	`''`	Public base URL of the bucket (r2.dev, a custom domain or a CDN). Required for `images = 'storage'`. When set, footage is also served from it instead of presigned links.
`s3.pathStyle`	`true`	`true` uses `https://endpoint/bucket/key`, `false` uses `https://bucket.endpoint/key`.
`s3.presignMinutes`	`10`	Lifetime of presigned playback links.
`s3.prefix`	`'koja-mdt/'`	Key prefix for every object.
`fivemanage.path`	`'koja-mdt'`	Folder used on Fivemanage.

Secrets never go in shared/config.lua, because that file is sent to every player. Set them as server convars in server.cfg. Use set, not setr or sets, so they stay on the server:

server.cfg

set koja_mdt_s3_access_key "your-access-key-id"
set koja_mdt_s3_secret_key "your-secret-access-key"
set koja_mdt_fivemanage_key "your-fivemanage-api-key"

You can also fill editable/server/storage.lua instead. It is loaded on the server only and a non-empty value there wins over the convar.

The startup banner prints a Storage line with the driver and the result of a self-test (HeadBucket for S3, a tiny upload and delete for Fivemanage). Any missing option is printed as a warning and the MDT falls back to local disk and inline images.

The bucket must allow GET from the MDT interface and from your web portal. Paste this CORS policy and replace the last origin with your portal address:

CORS policy

[
  {
    "AllowedOrigins": ["https://cfx-nui-koja-mdt", "nui://koja-mdt", "https://mdt.example.com"],
    "AllowedMethods": ["GET", "HEAD"],
    "AllowedHeaders": ["*"],
    "ExposeHeaders": ["Content-Length", "ETag"],
    "MaxAgeSeconds": 3600
  }
]

Config.Avatars

Profile pictures taken from the character's head shot.

Option	Default	Description
`enabled`	`true`	Turn avatars on or off.
`captureOnLoad`	`true`	Capture when the player loads in.
`loadDelaySeconds`	`10`	Delay after load before capture.
`refreshMinutes`	`20`	Automatic refresh interval.
`command`	`'mdtphoto'`	Command to refresh your photo. Empty disables it.
`transparent`	`true`	Transparent background.
`size`	`128`	Image size in pixels.
`format`	`'image/webp'`	Image format.
`quality`	`0.85`	Image quality.
`minUploadSeconds`	`60`	Minimum seconds between uploads.
`maxLength`	`150000`	Maximum stored image size.
`selfie.enabled`	`true`	Selfie photo for the profile. Needs `screenshot-basic`.
`selfie.size`	`256`	Selfie size.
`selfie.quality`	`0.88`	Selfie quality.
`selfie.cooldownSeconds`	`20`	Cooldown between selfies.
`selfie.maxLength`	`400000`	Maximum size of a selfie image in characters. The effective limit is the larger of this and `maxLength`. A bigger selfie is rejected and the reason is printed in the server console.
`selfie.phone`	`0`	Phone variant used for the selfie camera.
`selfie.crop`	`{ side = 0.7, centerX = 0.42, centerY = 0.45 }`	Crop area of the captured frame.

Config.Cameras

CCTV cameras and the camera viewer.

Option	Default	Description
`enabled`	`true`	Turn CCTV on or off.
`adminAce`	`'koja-mdt.cameras'`	Ace for placing and editing cameras.
`seedDefaults`	`true`	Seed default cameras on first start.
`timecycle`, `timecycleStrength`, `extraTimecycle`, `brokenTimecycle`	`CAMERA_secuirity`, `1.0`, `scanline_cam_cheap`, `CAMERA_secuirity_FUZZ`	Screen filter while viewing.
`defaultFov`, `minFov`, `maxFov`	`60.0`, `8.0`, `90.0`	Field of view and zoom limits.
`lookSpeed`, `keySpeed`, `zoomStep`	`6.0`, `1.2`, `4.0`	Control speeds.
`hudInterval`	`33`	HUD update interval in ms.
`maxMoveSpeed`	`3.0`	Maximum camera move speed.
`propModel`, `propModels`	`prop_cctv_cam_01a` and six more	Camera prop models offered when placing.
`propDistance`	`150.0`	Distance at which camera props are streamed.
`limits`	pan -180 to 180, tilt -89 to 60	`panMin`, `panMax`, `tiltMin`, `tiltMax`, `defaultPan`, `defaultTiltDown`, `defaultTiltUp`.
`freecam`	speeds	`speed`, `fastMultiplier`, `slowMultiplier`, `lookSpeed`, `raycastDistance` for the placement free camera.
`placement`	placement defaults	`propByDefault`, `wallPan`, `lensGap`, `hiddenGap`, `poleHeight`, `poleLensDrop`, `frustumRange`, `reviewDistance`, `propHeadings`.
`keys`	controls and labels	Key controls used in the viewer and in placement mode. Each is `{ controls = { ... }, label = '...' }`.
`anpr`	camera plate reading	See below.

Camera ANPR (Config.Cameras.anpr):

Option	Default	Description
`enabled`	`true`	Read plates through CCTV cameras.
`range`	`80.0`	Reading range in meters.
`interval`	`200`	Scan interval in ms.
`trackInterval`	`33`	Tracking interval in ms.
`maxVehicles`	`12`	Vehicles tracked at once.
`units`	`'kmh'`	Speed units.
`cacheSeconds`	`60`	Result cache time.
`maxPlatesPerRequest`	`10`	Plates per lookup request.
`hitSound`	`true`	Sound on a hit.

Config.Bodycams

Option	Default	Description
`enabled`	`true`	Turn bodycams on or off.
`item`	`'bodycam'`	Item name.
`requireItem`	`false`	The officer must carry the item.
`key`	`'F7'`	Default key to start or stop. Empty disables the key.
`command`	`'bodycam'`	Command: `/bodycam [on, off, rec, stop]`. Empty disables it.
`auto.duty`	`false`	Start automatically when going on duty.
`auto.siren`	`true`	Start when sirens are switched on.
`auto.weapon`	`true`	Start when a weapon is drawn.
`auto.dispatch`	`true`	Start when attached to a call.
`auto.panic`	`true`	Start on panic.
`idleStopSeconds`	`0`	Stop after this many idle seconds. `0` turns it off.
`breadcrumbSeconds`	`15`	Position sample interval.
`keepDays`	`30`	Days sessions are kept. `0` keeps them forever.
`crossDepartment`	`false`	Allow watching bodycams of other departments.
`label`	`'BODY 4'`	Label shown on the recording overlay.
`shotCooldown`	`3`	Seconds between recorded shot events.
`view`	camera mount	`bone`, `offset`, `fov`, `shake`, `streamTimeout` for the live view.
`keys`	viewer controls	`exit` (Backspace), `next` (E), `previous` (Q).
`recording`	see below	Footage capture and storage settings.

Config.Bodycams.recording

Footage is captured by the wearer's client as a series of pictures (needs screenshot-basic), sent to the server in batches and packed into segments. See Storage and CDN for where segments are kept.

Option	Default	Description
`enabled`	`true`	Record footage. Live view still works without it.
`intervalMs`	`125`	Milliseconds between frames (50 to 10000). 125 is 8 frames per second. See the table below.
`maxInFlight`	`4`	Frames captured at the same time on the client (1 to 8). Higher keeps the frame rate steady on a slow machine but uses more CPU.
`width`	`560`	Frame width in pixels (160 to 1920).
`quality`	`0.42`	Image quality (0.1 to 1.0).
`format`	`'jpg'`	`'jpg'` or `'webp'`.
`batchFrames`	`16`	Frames sent to the server in one message (1 to 24).
`latentBps`	`400000`	Upload speed limit in bytes per second for frame batches. Raise it if frames are dropped at a high frame rate.
`maxFrameKB`	`80`	Largest accepted frame (8 to 512). Bigger frames are dropped.
`keepDays`	`14`	Days footage is kept (0 keeps it forever). Separate from `Config.Bodycams.keepDays`, which keeps the session data.
`keepLinked`	`true`	Footage attached to an incident is deleted last when the disk limit is reached and is not deleted by `keepDays`.
`maxMinutesPerSession`	`60`	Longest footage per recording (1 to 720).
`maxDiskMB`	`20480`	Total disk limit for footage in MB. The oldest footage is deleted when it is exceeded. `0` turns the limit off.
`http`	`true`	Serve footage to the player over the web route.
`baseUrl`	`''`	Public base URL for footage links. Empty uses the web portal address (`Config.Web.publicUrl`).
`tokenMinutes`	`10`	Lifetime of a playback link in minutes (1 to 120).

Frame rate is set with intervalMs:

`intervalMs`	Frames per second	Notes
`200`	5	Lightest. Choppy but good enough for review.
`125`	8	Default. Smooth enough for most uses.
`100`	10	Smoother motion.
`66`	15	Smoothest. Heavy.

Config.Anpr and in-vehicle ALPR

Option	Default	Description
`enabled`	`true`	Turn plate lookups on or off.
`cacheSeconds`	`30`	Lookup cache time.
`maxPlatesPerRequest`	`10`	Plates per request.
`requireDuty`	`true`	Vehicle ALPR only works on duty.
`hitCooldown`	`120`	Seconds before the same plate alerts again.
`unknownIsHit`	`false`	Treat unregistered plates as hits.
`hitFlags`	`{}`	Extra vehicle flags that count as a hit. Stolen, BOLO and warrant are always hits.
`autoDispatch`	`true`	A hit creates a dispatch call.
`dispatchCode`	`'10-ALPR'`	Call code.
`dispatchCooldown`	`300`	Seconds between calls for the same plate.
`blip`	`{ sprite = 225, color = 1, scale = 1.0 }`	Call blip.
`keepDays`	`14`	Days the ANPR log is kept.
`vehicle.enabled`	`true`	Turn the in-vehicle ALPR on or off.
`vehicle.models`	police, police2, police3, police4, sheriff, sheriff2, fbi, fbi2, pranger	Vehicle models with ALPR.
`vehicle.allowEmergencyClass`	`true`	Also allow any emergency class vehicle.
`vehicle.range`	`45.0`	Detection range.
`vehicle.radius`	`2.5`	Detection radius.
`vehicle.cone`	`22.0`	Detection cone angle.
`vehicle.interval`	`400`	Scan interval in ms.
`vehicle.clientCacheSeconds`	`25`	Client side cache.
`vehicle.units`	`'kmh'`	Speed units.
`vehicle.position`	`'bottom-right'`	Panel position.
`vehicle.scale`	`1.0`	Panel scale.
`vehicle.sound`	`true`	Hit sound.
`vehicle.history`	`6`	Plates shown in the panel history.
`vehicle.autoShow`	`true`	Show the panel by default when sitting in an ALPR vehicle.
`vehicle.keys.toggle`	`'F10'`	Show or hide the panel.
`vehicle.keys.lockFront`	`'UP'`	Lock the front plate.
`vehicle.keys.lockRear`	`'DOWN'`	Lock the rear plate.
`vehicle.keys.open`	`'RIGHT'`	Open the locked vehicle in the MDT.

Inventory and forms

Config.Inventory

Option	Default	Description
`system`	`'auto'`	`'auto'` uses koja_grid_inventory when started. `'framework'` forces the framework inventory through koja-lib.
`registerItems`	`true`	With koja_grid_inventory, register `citation`, `mdt_document` and `bodycam` automatically.
`items`	three items	Definitions `{ label, description, size, weight, image }` for those items.

Config.Forms

Option	Default	Description
`enabled`	`true`	Turn forms on or off.
`item`	`'mdt_document'`	Item given when a form is filed.
`requireSignature`	`true`	Forms must be signed.
`readAnim`	clipboard	Animation and prop while reading a document.

Config.Mail, Config.Notifications, Config.Calendar

Option	Default	Description
`Config.Mail.maxRecipients`	`30`	Recipients per mail.
`Config.Mail.maxBodyLength`	`10000`	Maximum characters in a mail.
`Config.Mail.keepDays`	`0`	Days mail is kept. `0` keeps it forever.
`Config.Notifications.keepDays`	`30`	Days notifications are kept.
`Config.Calendar.remindMinutes`	`30`	Reminder before an event.
`Config.Calendar.notifyOnCreate`	`true`	Notify attendees of new events.
`Config.Calendar.notifyOnComment`	`true`	Notify on comments.
`Config.Calendar.maxRangeDays`	`62`	Longest range that can be loaded.
`Config.Calendar.maxAttendees`	`500`	Attendees per event.
`Config.Calendar.maxCommentLength`	`500`	Characters per comment.
`Config.Calendar.reactions`	eight emoji	Reactions offered on events.
`Config.Calendar.court`	`true`	Show court hearings in the calendar.

Logs, admin and security

Config.Logs

Option	Default	Description
`keepDays`	`30`	Days audit entries are kept. `0` keeps them forever.
`webhook`	`''`	Discord webhook for all categories.
`webhooks`	`incidents`, `warrants`, `processing`, `roster`, `dispatch`	One webhook per category, all empty by default.

Config.Admin

Option	Default	Description
`ace`	`'koja-mdt.admin'`	Ace that grants admin panel access.
`allowCommandAce`	`true`	The generic `command` ace also grants access.
`departmentOverrides`	`true`	Admin panel can override departments, ranks and permissions.
`jobEditing`	`true`	Admin panel can edit jobs and grades. Works on ESX with `jobs` and `job_grades` tables.
`logsKeepDays`	`30`	Age used by the purge logs button when `Config.Logs.keepDays` is `0`.

Config.Security

Every request from the UI is rate limited and permission checked on the server.

Option	Default	Description
`burst`	`12`	Request bucket size per player.
`perSecond`	`6`	Bucket refill per second.
`dropAfterFlags`	`0`	Kick a player after this many suspicious flags. `0` never kicks.
`dropMessage`	`'koja-mdt: suspicious activity'`	Kick message.
`limits`	per endpoint	Stricter buckets `{ burst, perSecond }` for `citizens:search`, `vehicles:search`, `incidents:process`, `dispatch:public`, `anpr:lookup`, `anpr:vehicle`, `anpr:camera`, `bodycam:toggle`, `bodycam:auto`, `bodycam:shot`, `bodycam:beat`, `bodycams:watch`.

Web portal

Config.Web

See the portal section in Features.

Option	Default	Description
`enabled`	`true`	Turn the portal on or off.
`publicUrl`	`''`	Your own public address, for example behind nginx. Takes priority over the relay and the Cfx.re proxy.
`allowCitizens`	`true`	Any player can sign in to the citizen portal.
`citizenRecord`	`true`	Citizens see their own record and licenses.
`loginCodeMinutes`	`10`	How long the `/mdtweb` code is valid.
`sessionDays`	`30`	Session length, renewed on use.
`maxSessionsPerAccount`	`5`	Devices per account.
`command`	`'mdtweb'`	Command that gives a login code. Empty disables it.
`allowedOrigins`	`{}`	Extra origins allowed for cross-origin requests.
`trustProxyHeaders`	`false`	Trust the client IP from a reverse proxy, so rate limits see the real address.
`relay.enabled`	`true`	Use the relay for a short HTTPS address.
`relay.url`	`'https://mdt.kojascripts.com'`	Relay address.
`relay.id`	`''`	Readable server id (4 to 40 characters, `a-z`, `0-9`, `-`). Empty generates a random one and keeps it.
`relay.localUrl`	`'http://127.0.0.1:30120'`	Local address the relay forwards requests to.

Staff data

Config.Divisions

List of default divisions created for each department on first start. Each entry has name, short, icon, color, description. Defaults: Firearms, Traffic Enforcement, Detective Bureau, K-9 Unit, S.W.A.T and Human Resources.

Config.Certifications

List of default certifications { id, label, color }. Defaults: fto, swat, k9, air, marine, motor, detective, traffic, negotiator, sniper.

Config.ProfileTags

Flags on a person's file { id, label, color }. Defaults: armed, gang, parole, probation, violent, officer_safety, mental, informant, flight_risk.

Config.IncidentTypes

Report types { id, label, icon, template }. The template is the starting text of the narrative. Defaults: arrest, citation, traffic, pursuit, investigation, use_of_force, death, other.

Config.EvidenceTypes

Evidence types { id, label }. Defaults: weapon, casing, blood, drugs, cash, document, electronic, photo, vehicle, other.

EMS

Config.Ems

Option	Default	Description
`policeSummary.enabled`	`false`	Lets selected police ranks read a patient's medical summary (`patients.summary`). Every view is logged.
`policeSummary.ranks`	`supervisor`, `command`	Access levels that get it.
`bloodTypes`	eight types	Blood types offered.
`incidentTypes`	eleven types	ePCR incident types `{ id, label }`.
`catalog`	procedures and medications	Treatment catalog `{ id, label, kind, dose, price }`. `kind` is `procedure` or `medication`.
`fees`	five fees	Extra fees `{ id, label, price }`: call-out, ground transport, air transport, hospital admission, consultation.
`hospitals`	Pillbox, Sandy Shores, Paleto Bay	Hospitals `{ id, label, short, beds }` for the bed board.
`billing.enabled`	`true`	Medical bills.
`billing.account`	`'bank'`	Account charged. Cash is used if the bank is short.
`billing.society`	`'society_ambulance'`	Society that receives the money.
`billing.requireOnline`	`true`	Patient must be online.
`billing.maxDistance`	`0.0`	Maximum medic to patient distance. `0` means no limit.
`billing.allowCustomItems`	`true`	Allow custom bill lines.
`billing.maxCustomPrice`	`25000`	Highest price of a custom line.
`billing.maxTotal`	`100000`	Highest bill total.
`maxVitals`, `maxInjuries`, `maxTreatments`	`6`, `24`, `40`	Limits per ePCR report.

Config.Ems.ambulance (koja-ambulance link)

Option	Default	Description
`enabled`	`'auto'`	`'auto'` links when koja-ambulance is started. `false` turns the link off.
`resource`	`'koja-ambulance'`	Resource name.
`jobs`	`{ 'ambulance' }`	Must match `Config.Jobs` of koja-ambulance.
`duty`	`'sync'`	`'sync'` the MDT toggle and `/mdtduty` switch koja-ambulance duty. `'follow'` duty is only changed at the hospital. `false` keeps duty separate.
`dutyPollSeconds`	`5`	How often koja-ambulance duty is read.
`import`	`true`	Import from patient button in the ePCR editor.
`history`	`true`	Show koja-ambulance records and invoices on the patient page.
`down`	`true`	Dashboard panel with downed patients.
`billing`	`'mdt'`	`'mdt'` charges bills in the MDT. `'ambulance'` sends them as koja-ambulance invoices.
`treatmentWindowMinutes`	`60`	How far back treatments are read for import.
`dispatch.enabled`	`true`	Distress signals appear as EMS calls.
`dispatch.mirror`	`true`	Mirror calls koja-ambulance sends to medics.
`dispatch.distress`	`true`	Create calls from distress signals.
`dispatch.downed`	`false`	Create a call as soon as someone goes down.
`dispatch.closeOnRevive`	`true`	Close the call when the patient is revived.
`dispatch.forward`	`false`	Send MDT calls for EMS to koja-ambulance.
`dispatch.code`	`'10-52'`	Call code.
`beds.enabled`	`true`	Show occupied koja-ambulance beds on the board.
`beds.admit`	`true`	Check-ins create an MDT admission.
`beds.discharge`	`true`	Freeing the bed discharges the admission.
`beds.admitResting`	`false`	Also admit patients who are only resting.
`beds.map`	`{}`	Bed mapping `[hospital][index]` to MDT beds. Empty uses the MDT bed list in order.
`regions`	head, chest, abdomen, arms, legs	Maps koja-ambulance body zones to the ePCR body diagram.
`injuryKinds`	gunshot, stab, laceration and more	Maps wound types to ePCR injury kinds.
`treatments`	bandage, tourniquet, morphine and more	Maps koja-ambulance treatments to catalog ids.

Configuration

Configuration#

General#

Config.Locale and Config.Languages#

Config.VersionCheck#

Config.Open#

Config.Tablet#

Config.Ui#

Config.Interact#

Config.DebugTools#

Records and justice#

Config.Records#

Config.Processing#

Config.Custody#

Config.Citations#

Config.Doj#

Config.Police#

Dispatch and units#

Config.Dispatch#

Config.Dispatch.gunshots#

Config.QuickDispatch#

Config.DispatchVoice#

Config.Units#

Config.Duty#

Config.Roster#

Photos and cameras#

Config.Camera#

Config.Storage#

Config.Avatars#

Config.Cameras#

Config.Bodycams#

Config.Bodycams.recording#

Config.Anpr and in-vehicle ALPR#

Inventory and forms#

Config.Inventory#

Config.Forms#

Config.Mail, Config.Notifications, Config.Calendar#

Logs, admin and security#

Config.Logs#

Config.Admin#

Config.Security#

Web portal#

Config.Web#

Staff data#

Config.Divisions#

Config.Certifications#

Config.ProfileTags#

Config.IncidentTypes#

Config.EvidenceTypes#

EMS#

Config.Ems#

Config.Ems.ambulance (koja-ambulance link)#

Configuration

General

Config.Locale and Config.Languages

Config.VersionCheck

Config.Open

Config.Tablet

Config.Ui

Config.Interact

Config.DebugTools

Records and justice

Config.Records

Config.Processing

Config.Custody

Config.Citations

Config.Doj

Config.Police

Dispatch and units

Config.Dispatch

Config.Dispatch.gunshots

Config.QuickDispatch

Config.DispatchVoice

Config.Units

Config.Duty

Config.Roster

Photos and cameras

Config.Camera

Config.Storage

Config.Avatars

Config.Cameras

Config.Bodycams

Config.Bodycams.recording

Config.Anpr and in-vehicle ALPR

Inventory and forms

Config.Inventory

Config.Forms

Config.Mail, Config.Notifications, Config.Calendar

Logs, admin and security

Config.Logs

Config.Admin

Config.Security

Web portal

Config.Web

Staff data

Config.Divisions

Config.Certifications

Config.ProfileTags

Config.IncidentTypes

Config.EvidenceTypes

EMS

Config.Ems

Config.Ems.ambulance (koja-ambulance link)