> For the complete documentation index, see [llms.txt](https://rex-studio.gitbook.io/rex-studio-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rex-studio.gitbook.io/rex-studio-docs/mapping/fivem-redm-mapping.md).

# 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]
```