> For the complete documentation index, see [llms.txt](https://cylexdev.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cylexdev.gitbook.io/docs/cylex_mdt/features/citizens-and-vehicles.md). # Citizens & Vehicles Look up citizens and vehicles, view criminal records, manage licenses, track wanted status, flag stolen vehicles, and add signed officer notes from the field. The Citizens and Vehicles pages are your department's records database. During a traffic stop or field encounter you can pull a citizen's full criminal history, check their license standing, and read officer notes left by previous shifts — all in seconds. Vehicle lookups surface registration details, stolen flags, active BOLOs, and strike points the moment you enter a plate. *** ### Citizens #### Searching citizens Open the **Citizens** page and type into the search bar. You can search by: * Full name or partial name (minimum 2 characters) * Citizen ID * Phone number (minimum 2 digits) The list filters live as you type. Each result row shows the citizen's full name, citizen ID, date of birth, phone number, status (Clean or Wanted), and active warrant count. Use the **All Status** dropdown to filter to **Clean** or **Wanted** citizens only. You can also filter by gender or by tag. #### Citizen profile Click **View Profile** on any result to open the citizen's full record. The profile is organized into {% tabs %} {% tab title="Overview" %} The overview tab shows all identifying information and current status at a glance: **Personal information** * Photo (mugshot or profile photo) * Citizen ID * First name and last name * Date of birth * Gender * Phone number (tap to copy) * Occupation * Address * Emergency contact **Wanted status** The status banner shows either **WANTED** or **NOT WANTED** in large text. If the citizen has active arrest warrants, an **Active Warrants** count appears below the status. You can change the wanted status directly from this panel. **Alive / dead status** Use the **Mark as Dead** or **Mark as Alive** button to record whether the citizen is currently alive. This is reflected across all incident reports and BOLOs linked to the citizen. **Flags and tags** Add free-form flags or colored tags to the citizen's profile for quick visual identification across the database. Tags are shared with the department-wide tag library. {% endtab %} {% tab title="Criminal record" %} The criminal record tab lists every incident in which the citizen appeared as a suspect, along with the charges applied in each case. At the top of the tab, four auto-totalled figures summarize the citizen's entire history: | Total | Description | | --------------------------- | --------------------------------------------------------- | | **Total Incidents** | Number of incidents the citizen is linked to as a suspect | | **Total Fine** | Sum of all fines across every charge ever applied | | **Total Sentence** | Cumulative jail sentence in months | | **Total Community Service** | Cumulative community service hours | Each incident row links directly to the full incident report. {% endtab %} {% tab title="Licenses" %} The licenses tab shows every license type configured for your server. The defaults are: * **Drivers License** * **Firearms License** * **Pilot License** * **Hunting License** * **Boat License** For each license you can: * Grant a license Click **Add License** and choose an expiry date, or check **Grant Permanent (No Expiry)** to issue it without an expiration. The grant date is recorded automatically. * Ban a license Click **Ban** next to any active license. A confirmation dialog appears — **Ban License — Are you sure you want to ban this license? The current grant becomes void and the license cannot be re-issued.** You can enter an optional ban reason before confirming. Once banned, the license shows a **BANNED** badge with the ban date. * Remove a ban Click **Unban** on any banned license. The confirmation dialog — **Remove Ban — Are you sure you want to remove the ban?** — must be confirmed before the ban is lifted. {% hint style="danger" %} Banning a license is not reversible through the normal grant flow. The ban must be explicitly removed with **Unban** before the license can be re-issued. {% endhint %} {% endtab %} {% tab title="Vehicles" %} Lists all vehicles registered to this citizen. Each entry shows the plate, model, color, and wanted status. Click any vehicle to open its full vehicle profile. {% endtab %} {% tab title="Officer notes" %} Officer notes let you attach rich-text notes to a citizen's profile that persist across sessions and are visible to all officers with access. Click **Add Note** to open the note editor. The toolbar supports **Bold**, **Italic**, **Underline**, **Strikethrough**, **Bulleted List**, and **Mark as Important** formatting. Each saved note is signed automatically with the writing officer's name and badge number — **Signed by: Officer Name**. Notes are ordered chronologically and can be viewed or removed by authorized officers. {% endtab %} {% endtabs %} ### Vehicles #### Searching vehicles Open the **Vehicles** page and type into the search bar. You can search by: * License plate * Vehicle model * Registered owner name Minimum 3 characters are required before results appear. Filter results by status using the tabs: **All**, **Stolen**, **Wanted**, or **Clean**. You can also filter by tag. #### Vehicle profile Click any result to open the vehicle's full record.
Vehicle information The **Vehicle Information** panel shows all registration details: * **Plate number** * **Model** * **Color** (mapped to a hex color swatch) * **Registered owner** — links to the owner's citizen profile * **Registration date** * **Insurance** status The vehicle status badge shows **Wanted** or **Not Wanted** based on active BOLOs linked to the vehicle.
Photo The vehicle photo is captured via the in-game camera. Click **Capture Photo** to open the in-game camera interface — the tooltip reads *Capture photo via in-game camera*. Once a photo is captured it displays at the top of the profile. Click **Remove** to clear it. If no photo has been taken yet, the placeholder reads **No Photo Available**.
Strike points Strike points track repeated violations associated with a vehicle. The counter starts at zero and increments each time you add a strike. The maximum is set by `Config.MaxStrikePoints` in `editable/config.lua` — the default is **5**. ```lua -- Maximum strike points a vehicle can have Config.MaxStrikePoints = 5 ```
Active BOLOs The **Active BOLOs** panel lists every open BOLO currently linked to this vehicle, including the charges, urgency level, and the issuing officer. Click a BOLO entry to open its full record on the BOLOs page. If there are no active BOLOs the panel reads **No active BOLOs.**
Officer notes Vehicle notes work identically to citizen notes. Click **Add Note** to open the rich-text editor. Each note is signed with the officer's name and badge. Notes accumulate chronologically and are visible to all authorized officers.
Tags Attach colored tags from the department tag library to the vehicle. Tags carry across the vehicles list and can be used as a filter. Click **Add Tag** and search for an existing tag or select one from the list.
Involved incidents The **Involved Incidents** panel lists every incident report in which this vehicle was recorded as involved. Each entry links directly to the full incident report. If the vehicle has never been logged in a report, the panel reads **No** registered **incidents**.