# Usage

## Usage

### Opening the garage / impound UI

Players interact with the configured **NPC** via your target system:

* `ox_target` / `qb-target` / `qtarget` (auto-detected)

From the UI you can:

* View stored vehicles in that garage
* Spawn a vehicle
* Store a vehicle (if you are in/near it)
* Transfer a vehicle to another garage (if enabled)
* Open impound and pay fee to release

### States

The script uses `garage_state`:

* `1` Stored in a garage
* `0` OUT (spawned)
* `2` Impounded

The script also tracks OUT vehicles server-side and can auto‑impound if a tracked entity disappears.

### Job garages (fleet)

Job garages (type = `job`) show a fleet list with per-model limits.

* Fleet vehicles are **non-persistent** (not owned\_vehicles / player\_vehicles inserts)
* Spawning is limited by `fleet[model] = max`
* UI shows current OUT count vs max
* The script can set a starting fuel level using `orgFuelPct`

### Vehicle Docs (optional)

If enabled (`Config.Docs.enabled = true`) and allowed for that garage (`publicOnly` rules):

#### 1) Buy Registration / Insurance

Inside the garage UI:

* Enter holder first/last name
* Choose **Registration** or **Insurance**
* Pay from the configured account
* Time is added from the later of (current expiry, now)

#### 2) Print papers

* Pay `printFee`
* A new token is generated and stored in the Docs table
* The paper item is given with metadata:
  * `plate`, `vin`, `doc_token`, `printed_at`

#### 3) Use paper item

Using the item:

* The script validates `doc_token` against the Docs table
* Shows the paper UI for the player
* Finds the nearest player (3m), plays a 1s **show papers** animation, and shows the paper UI to that player too (server validates distance)

> Important: If your inventory does not support metadata, papers cannot be validated.

### Transfer (optional)

If `Config.Transfer.enabled = true`, the UI lets the owner transfer a stored vehicle to another garage by paying a fee.

If `Config.Docs.resetOnTransfer = true`, the Docs data is reset (holder + dates + token) while keeping VIN.