Map setup

Installing a map

Every map ships as a ready resource folder. There is nothing to compile and no key to redeem — the download in your Cfx.re Portal is already tied to your account.

1. Download from your Portal

Open Portal → Granted assets and download the map. You get a .zip containing a single resource folder, for example v3_cloister.

Unzip it somewhere local first. Do not upload the .zip itself.

2. Drop it into your resources folder

Copy the resource folder into your server's resources directory. Most people keep maps grouped together:

resources/
  [maps]/
    v3_cloister/

Any folder name in square brackets is just a group and can be called anything. The resource folder itself is different — see the warning below.

3. Start it in server.cfg

Add one line to server.cfg:

ensure v3_cloister

Use ensure rather than start: it restarts the resource cleanly if it is already running. Put map lines near the top of your resource list so anything that depends on the geometry loads after it.

4. Restart and check

Restart the server — not just the resource — the first time you install a map, so streaming picks up the new assets. Then teleport to the coordinates listed on the product page and look around.

Requirements

Game build

Every map is built for game build 3095 or newer. If your server runs an older build, add this to server.cfg:

sv_enforceGameBuild 3095

Without it the map may load with missing props or wrong textures, because objects introduced in later builds will not exist on the client.

Server artifacts

Use a reasonably current artifact version. Very old artifacts predate parts of the streaming and escrow handling these maps rely on.

Keep the default folder name

We recommend leaving the resource folder named exactly as it ships. Renaming is not something we suggest: these docs, future updates and every support answer refer to the default name, so a renamed resource makes any problem harder to trace.

If you do rename it, the name in your ensure line has to match the new folder name — and if anything stops working afterwards, put the original name back first.

Common problems

The resource will not start

The name in ensure v3_cloister must match the folder name exactly, including case. Check the server console on boot — it prints the resource it could not find.

Objects are invisible, black, or you fall through them

This is almost always streaming rather than the map: the client has not received the assets yet. Restart the server fully, and make sure the resource is not being started before the server is ready. If it persists on one machine only, have that player clear their FiveM cache.

The server has no internet access

Escrowed assets are validated against Cfx.re when the resource starts. A server that cannot reach Cfx.re will fail to start the map. This also means the map will not run on a fully offline LAN server.