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

# Installation guide

How to install an FM Shop resource on your FiveM server.

This guide works for every FM Shop map. Read the product page as well: it shows the location, the features and the links of that specific map.

{% hint style="info" %}
Have an **All Maps Access** subscription? Use the [All Maps Access installation](https://fm-shop.gitbook.io/fm-shop-docs/installation/all-maps-access-installation) guide instead.
{% endhint %}

## Requirements

* A working **FiveM server** you can edit (access to the `resources` folder and to `server.cfg`).
* The resource you bought, downloaded from the Cfx.re Portal. See [Receiving your purchase](https://fm-shop.gitbook.io/fm-shop-docs/getting-started/receiving-your-purchase).
* Any script or resource your server already needs for that map, if it uses one.

## Steps

{% stepper %}
{% step %}

### Extract the archive

Extract the archive you received after purchase into a temporary folder.
{% endstep %}

{% step %}

### Copy the resource folder

Copy the resource folder into `resources/` on your server. For example: `resources/cfx-fm-aldente-interior`. Keep the folder name exactly as delivered, because it is the name you will use in `server.cfg`.
{% endstep %}

{% step %}

### Add the resource to `server.cfg`

Add the resource **after any dependencies**:

```
ensure cfx-fm-aldente-interior
```

Use the folder name of the map you installed. `cfx-fm-aldente-interior` is the folder of Al Dente, as an example.
{% endstep %}

{% step %}

### Restart

Restart the resource, or the whole server, and check the console for any loading errors.
{% endstep %}

{% step %}

### Check it in game

Go to the in-game location listed on the product page. Confirm that the interior or rework is visible and that **collisions, doors and lighting** work correctly.
{% endstep %}

{% step %}

### Avoid conflicts

If the resource replaces a vanilla interior or exterior, make sure no other resource is already removing or hiding the same IPL. Two systems acting on the same object cause conflicts. See [Load order and conflicts](https://fm-shop.gitbook.io/fm-shop-docs/installation/load-order-and-conflicts).
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Missing textures or collisions?** Make sure you copied the **entire resource folder**, including the streamed assets (`.ytd`, `.ydr`, `.ybn`, `.ymap`, `.ytyp`), and that no file was excluded when extracting the zip.
{% endhint %}

## Quick checklist

* [ ] The resource folder is inside `resources/`.
* [ ] The folder name matches the name used in `server.cfg`.
* [ ] The `ensure` line of the map comes after its dependencies.
* [ ] The console shows no errors when the resource starts.
* [ ] No other resource edits the same interior.
* [ ] The full folder was copied (all streamed files present).

If something still does not work, go to [Troubleshooting](https://fm-shop.gitbook.io/fm-shop-docs/help/troubleshooting).