> For the complete documentation index, see [llms.txt](https://nteamdev.gitbook.io/nteam-development/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nteamdev.gitbook.io/nteam-development/maps/manual-installation.md).

# Manual Installation

### 🧩 Installation Guide

1. Download our asset from your [CFX Portal](https://portal.cfx.re/assets/granted-assets)
2. [Extract ](#user-content-fn-1)[^1]our asset in your [resources ](#user-content-fn-2)[^2]folder
3. Ensure asset inside your server.cfg and restart server

***

### 📦 Map Data Installation Guide

#### 1. When Do You Need Map Data?

You only need to install **Map Data** if you are using **one or more** of the following maps:

* Vice CarDealer
* Mile High
* Legion Square *(V1 & V2 share the same map data)*
* Park Color
* MRPD

If you are **not** using any of the maps listed above, this step can be safely skipped.

***

#### 2. Selecting the Correct Map Data

If you are using at least one of the maps listed above, follow these steps:

1. Extract the **`MAP DATA.zip`** archive.
2. Open the folder that matches **your exact map combination**.

**Examples**

* **Example 1**\
  If you are using **Vice CarDealer**, **Mile High**, and **Legion Square**:\
  → `LEGION SQUARE, MILE HIGH, VICE CAR DEALER`
* **Example 2**\
  If you are using **Vice CarDealer**, **MRPD**, and **Legion Square**:\
  → `MAP DATA / MRPD MAP DATA COMBINATIONS / LEGION SQUARE, VICE CAR DEALER, MRPD`
* **Example 3**\
  If you are using **MRPD only**:\
  → `MAP DATA / MRPD MAP DATA COMBINATIONS / MRPD`

> ⚠️ **Important:**\
> Always choose the folder that **exactly matches** the maps you are using to avoid conflicts or missing data.

***

#### 3. Installing the Map Data

1. Copy the **`cfx-nteam-mapdata`** folder.
2. Paste it into your server **`resources`** directory.

***

#### 4. Server Configuration

Add the following line to your **`server.cfg`**:

```cfg
ensure cfx-nteam-mapdata
```

***

#### 5. Restart the Server

Restart your server to apply the changes.

***

💡 **Tip:** Always make sure to use the **correct combination folder** for your maps to avoid conflicts.

💡Example: How to find correct (cfx-nteam-mapdata) file for LEGION and MILEHIGH map combination

 ![](https://4178656587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSTkcNc8cdqEI4vqyefLy%2Fuploads%2FLaA0y6BvQP4OnOir6qHC%2Fimage.png?alt=media\&token=ff756f20-73e9-47f5-be5c-795aaf5851d3)

<br>

[^1]: To **extract a file from a .zip folder** means to **unpack** or **decompress** the files that are stored inside a compressed `.zip` archive.

    When you download something (like a FiveM resource or map), it often comes as a `.zip` file to keep everything in one package and make the file smaller.\
    Extracting it simply means **opening** that `.zip` file and **copying its contents** (folders and files) to a normal location on your computer — for example, into your `resources` folder.

[^2]: In a **FiveM server**, the **resources folder** is the main directory where all your **server assets and scripts** are stored.

    It contains everything your server loads when it starts — such as:

    * Custom **maps (MLOs)**
    * **Scripts** (Lua, JS, etc.) for gameplay features
    * **Vehicles, peds, and textures**
    * Any other modifications or resources used in the server