General Installation Guide

2 min read

General Installation Guide

This guide applies to all WXMAPS map and interior resources. Individual map pages may include extra steps specific to that release.

Requirements

  • A licensed FiveM server (latest recommended artifact)
  • A Cfx.re account linked to the license used for purchase
  • Basic access to your server's resources/ folder (SFTP, file manager, or direct)
  • wxmaps_commons running before any WXMAPS map. It holds shared common files every WXMAPS map depends on. Download it the same way and start it once, ahead of your maps.

Step 1: Download your resource

  1. Log in to the Cfx.re portal at portal.cfx.re with the Cfx account you purchased with.
  2. Find the WXMAPS asset in your asset list.
  3. Download the .zip file from there.

If you have an All Maps or All Access subscription, all included assets appear together in the same asset list.

Step 2: Extract and upload

  1. Extract the .zip file. The folder inside is your resource, and its name matches the resource identifier.
  2. Upload the entire folder into your server's resources/ directory (or a sub-folder such as resources/[wxmaps]).

Step 3: Add to server.cfg

Open your server.cfg and add start lines, with wxmaps_commons before any WXMAPS map:

ensure wxmaps_commons
ensure resource-name-here

wxmaps_commons holds shared files every WXMAPS map depends on, so it has to start first. You only need one copy no matter how many WXMAPS maps you run. Replace resource-name-here with the exact folder name you uploaded.

Step 4: Restart your server

Restart the server fully (not just a refresh). The map or interior will load on next start.

Verification

Join the server and travel to the map location. If you see the interior loading, the resource is running correctly.

Do not rename the resource folder. WXMAPS resources use encrypted Cfx assets that are license-bound to the original folder name.

Common issues

SymptomLikely causeFix
Resource fails to startWrong folder name or corrupted downloadRe-download and check server.cfg spelling
Interior not visible in-gameResource not started, or server artifact too oldCheck ensure line; update artifact
"License mismatch" errorResource started on a different license keyContact support on Discord
Streaming errors in consoleFiles missing from uploadRe-upload the full extracted folder

Still stuck?

Open a ticket on our Discord with your server console output and the resource name.