> For the complete documentation index, see [llms.txt](https://docs.imperialcad.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.imperialcad.app/api-and-integrations/fivem-installation/offered-plugins/unit-tracking-map.md).

# Unit Tracking Map

The ImperialCAD LiveMap is bundled with the ImperialCAD FiveM Resource and provides a real-time map view of units, postals, and activity within your community.

{% hint style="warning" %}
This plugin requires a **Premium ImperialCAD subscription**.

View our [pricing](https://imperialcad.app/pricing) for more information.
{% endhint %}

***

### 🚀 Getting Started

#### Step 1: Enable LiveMap

In your resource’s configuration file, set:

```lua
Config.livemap = true
```

By default, this is set to `false`.

***

#### Step 2: Postal Mapping

To display postal codes on the map:

* Go to ImperialCAD Admin panel; **Settings → Integrations → Postal Mapping**
* Upload a `postals.json` file

The system will automatically apply the mapping for your LiveMap.

***

### 🔄 Data Updates

* **Player Updates**:
  * Sent from in-game to the LiveMap every **3.5 seconds**
  * If the player has not moved since the last update, the refresh interval increases to **10 seconds**
* **Unit Information & Postals**:
  * Sent and received based on map activity (user placement and interaction)
  * Cached on the server side and updated periodically
* **Data Sync with CAD**:
  * User data may take up to **1 minute** to fully update and match CAD records
  * This delay is expected as the LiveMap is an external resource.

***

### ⚠️ Notes & Limitations

* LiveMap is **new and evolving**, so expect minor delays in data synchronization
* CAD-linked data is cached and may not appear instantly
* Future updates will improve refresh speed and stability