# FiveM/Redm Mapping

## 🗺️ How to Install a FiveM Mapping

This guide explains **step-by-step** how to install a **FiveM mapping** (custom map) after purchase — from **the Cfx Portal** to the final `ensure` line in your `server.cfg`.

***

### 🧾 1. Download the mapping from the Cfx Portal

1. Go to <https://portal.cfx.re/>.
2. Log in using the **Cfx account** you used to make the purchase.
3. Click on your **profile icon** (top right) and open **“My Assets”**.
4. Find the mapping you purchased in the list.
5. Click **Download** to get the `.zip` file.

***

### 📦 2. Extract the files

1. Once the `.zip` file is downloaded, **extract it** (right-click → “Extract here”).
2. You should see a folder that looks something like this:

   ```
   mymapping/
   ├─ stream/
   ├─ fxmanifest.lua
   └─ ...
   ```
3. Make sure the folder contains a `fxmanifest.lua` file.

   > 💡 Without this file, FiveM won’t recognize the resource.

***

### 📁 3. Move the folder into your server

1. Open your server directory (usually named `resources/`).
2. Drag and drop the mapping folder inside, for example:

   ```
   resources/[maps]/mymapping
   ```

   > ⚠️ Avoid spaces and special characters in the folder name.

***

### ⚙️ 4. Add the mapping to your `server.cfg`

1. Open your `server.cfg` file.
2. Add this line at the bottom (or in your resource section):

   ```cfg
   ensure mymapping
   ```
3. Save the file.

***

### 🚀 5. Restart your server

* Restart your FiveM server via your control panel or console.
* Join your server and check that the mapping has loaded correctly.

> ✅ If everything is working, you’ll see the new mapping directly in-game!

***

### 🧰 6. Troubleshooting

If the mapping doesn’t load:

* Double-check the folder name.
* Make sure it’s placed inside a **folder that is ensured in your `server.cfg`**.
* Check your console logs for any resource errors.

To stay organized, you can structure your resources like this:

```
resources/[maps]
resources/[scripts]
resources/[vehicles]
```

***

### 🧡 Example setup

```bash
resources/
├─ [maps]/
│  ├─ mymapping/
│  │  ├─ fxmanifest.lua
│  │  └─ stream/
│  └─ anothermap/
└─ [scripts]/
   └─ myscript/
```

And in your `server.cfg`:

```cfg
ensure [maps]
ensure [scripts]
```


---

# 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://rex-studio.gitbook.io/rex-studio-docs/mapping/fivem-redm-mapping.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.
