# 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

 ![](/files/2PeZdWU5O2EFptDt6qv4)

<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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://nteamdev.gitbook.io/nteam-development/maps/manual-installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.