# Overview

`seeker_dsr2x` is a police radar modelled on the STALKER DUAL DSR 2X. Two antennas run at the same time, each with its own windows, so a car closing from the front and a car overtaking from behind are both tracked without switching antennas. For anything not covered here, the real DSR 2X Operator's Manual applies.

## Requirements

- [ox_lib](https://github.com/overextended/ox_lib), started before the radar.
- The radar only appears for a player driving or riding in front in an emergency vehicle (`Config.allowedVehicleClasses`).

> [!TIP]
> Run this radar or the [Seeker Dual](/docs/seeker_dual/overview), not both on the same key. Both open with F5.

Press **F5** to open the remote. See [Remote and operator menu](/docs/seeker_dsr2x/remote).

## The windows

```
 SAME  ┌────────────┐  FRONT REAR  ┌────────────┐
 OPP   │   TARGET   │↑  FAST       │  FAST/LOCK │↑   ┌────────────┐
 XMIT  └────────────┘↓  LOCK       └────────────┘↓   │   PATROL   │   <- shared
 SAME  ┌────────────┐↑  FAST       ┌────────────┐↑   └────────────┘
 OPP   │   TARGET   │   LOCK       │  FAST/LOCK │
 XMIT  └────────────┘↓  REAR FRONT └────────────┘↓
```

- **Top row:** the FRONT antenna. **Bottom row:** the REAR antenna. **Right:** PATROL SPEED, shared by both rows.
- There's no ANT button: neither antenna is ever "the active one". Zones, hold and locks are set per row.

| Window | Colour | Shows |
|---|---|---|
| **TARGET** | Orange | The strongest car in that antenna's beam, live |
| **FAST / LOCK** | Red | A car faster than TARGET (FAST lamp), or a locked speed (LOCK lamp). A lock wins |
| **PATROL** | Green | Your own speed |

| Arrows | Closing | Moving away |
|---|---|---|
| FRONT (top row) | ▼ | ▲ |
| REAR (bottom row) | ▲ | ▼ |

A car pacing you lights neither arrow.

## Audio

- **Doppler** tracks the TARGET window's speed only; your own speed doesn't come into it. Only one row makes noise at a time (`Config.dopplerSource`: `front`, `rear` or `strongest`). Pitch stops climbing at 100 mph.
- **Squelch** on (normal): you hear it only while a car is tracked. Off: it runs all the time, like an open beam.
- **Voice callouts:** on a lock the unit speaks the antenna, the mode and the direction. `Front`, `Rear`, `Closing` and `Away` ship; drop your own `Stationary`, `Opposite` and `Same` clips into `nui/sounds/` for the full three-word phrase.
- **Start-up:** every lamp lights and `888` shows in all five windows for three seconds.

## Plate reader

An optional overlay showing the plate each antenna is reading, with a freeze per side (`/togglepr2x` to show or hide). Set `Config.alpr.provider` to `'cde'` or `'imperial'` and every new plate runs through your CAD: stolen, impounded, expired registration, no insurance and any other flag your CAD returns raise an in-game alert, and can be posted to Discord. ImperialCAD also reports on the owner (wanted, licence revoked, expired or missing).

Results are cached, but **locking a plate always asks the CAD fresh**. CAD credentials go in `server.cfg`, never in the resource; setup is in the comments at the bottom of `shared/config.lua`, and works the same as the [Seeker Dual's](/docs/seeker_dual/alpr).

## What gets saved

Everything you set is remembered per player and comes back after a restart or rejoin: zones, XMIT/HLd, MOV/STA, PS BLANK, the whole Operator Menu, volumes, stopwatch distance, speed unit, plate reader, Doppler, and where the display, plate reader and remote sit.

Four things don't come back, on purpose: the power switch (it always starts off), locks, live readings, and where you were in a menu.

On the real unit a power-on resets your zones to factory positions. Here it doesn't; set `Config.rememberOperationalState = false` if you'd rather it behaved like the real thing.

## Exports and state bags

```lua
-- client
exports.seeker_dsr2x:GetRadarState()        -- full state, rows keyed front / rear
exports.seeker_dsr2x:GetRadarDetailedState()
exports.seeker_dsr2x:IsRadarActive()        -- on, and at least one antenna transmitting
exports.seeker_dsr2x:IsRadarDisplayed()
exports.seeker_dsr2x:CanControlRadar()
exports.seeker_dsr2x:CanViewRadar()

-- server
exports.seeker_dsr2x:GetPlayerRadarState(source)
exports.seeker_dsr2x:IsPlayerRadarActive(source)
```

Player state bags: `seekerDsr2xPower`, `seekerDsr2xFrontXmit`, `seekerDsr2xRearXmit`, `seekerDsr2xFrontLocked`, `seekerDsr2xRearLocked`.