# How to Add Custom Maps to Your FiveM Server

Custom maps transform a standard GTA V map into a unique world that defines your server's identity. Whether you are adding MLO interiors, map additions, or full location overhauls, the process follows the same core principles.

## Types of Custom Maps

**MLO interiors** — Custom interior spaces accessible through doors. These add new enterable buildings to existing GTA V locations or empty spaces. Most premium custom maps are MLOs.

**Map additions (ymaps)** — External objects, props, and structures added to the world without creating enterable interiors. Used for added street furniture, decorations, or simple exterior modifications.

**IPL loading** — Activating existing but disabled GTA V interiors. Some GTA V interiors exist in the game files but are disabled by default. IPL resources re-enable them.

**Full map replacements** — Resources that completely replace large sections of the GTA V map. These are rare and require careful compatibility checking.

## Prerequisites

Before adding any custom map resources, make sure your server has:

**Updated server artifacts** — Run the latest recommended FiveM server build. Outdated builds have known issues with certain map file types. Check cfx.re/artifacts for the latest version.

**Sufficient streaming bandwidth** — Custom maps add to your server's streaming assets. Each player needs to download and stream these files. Ensure your server hosting has adequate bandwidth.

**A working base server** — Test with a clean, working server before adding complex map resources. If your server already has issues, adding maps will make troubleshooting harder.

## Step 1 — Prepare the Resource

Download and extract your custom map resource. Verify the folder structure:

custom-map-resource/
├── fxmanifest.lua
└── stream/
└── [map files here]

If you see this structure, the resource is ready to install. If files are loose without a proper folder structure, you need to organize them first or contact the developer.

## Step 2 — Check for Conflicts

Before uploading, check if you already have any resources covering the same map area. Two MLOs in the same location cause severe flickering and visual glitches.

Check your existing resources for anything that modifies the same building or location, nearby map areas that might overlap, or the same YDR or YMAP file names.

## Step 3 — Upload to Resources

Upload the complete resource folder to your server. Many server owners organize maps into a [maps] category folder:

resources/
├── [core]/
├── [scripts]/
└── [maps]/
├── baasha-gang-hideout/
├── baasha-car-dealership/
└── baasha-villa/

## Step 4 — Update server.cfg

Add the ensure line to your server.cfg. For multiple maps, add each on its own line:

ensure baasha-gang-hideout
ensure baasha-car-dealership
ensure baasha-villa

Map resources should be loaded after your framework but they do not generally need to be in a specific order relative to each other unless one map depends on another.

## Step 5 — Restart and Test

Restart your server fully and test each map location. Check for visibility at normal gameplay distance, correct LOD behavior at far distance, interior accessibility through doors, collision on all surfaces, and no texture flickering.

## Managing Multiple Custom Maps

**Keep a spreadsheet** tracking each map resource, its location on the GTA V map, and its source and purchase details. This is invaluable when troubleshooting conflicts.

**Test one at a time when troubleshooting** — If you add multiple maps at once and have issues, you cannot identify which one is causing the problem. Add one, test, then add the next.

**Back up before adding new maps** — Keep a clean server backup before installing major map changes. Rolling back is much easier than troubleshooting a broken server.

## Streaming Optimization

Every custom map resource adds to your server's streaming pool. Players need to download and stream these assets.

**Compress textures properly** — Quality MLOs use DXT compressed YTD files. Uncompressed textures massively increase streaming load.

**Remove unused maps** — If you have old map resources that are no longer used, remove them. Every resource adds streaming overhead even if players never visit the location.

**Use sv_enforceGameBuild** — Setting the correct game build ensures map files load correctly for all players:

sv_enforceGameBuild 2944

## Common Issues

**Map resource loads but is invisible:**
- Wrong game build set in server.cfg
- fxmanifest.lua not declaring the stream files correctly
- Files in wrong subfolder

**Server stutters after adding maps:**
- Too many high-resolution texture files loading simultaneously
- Check individual YTD file sizes — anything over 50MB per file is a problem

**Only some players see the map:**
- Ensure sv_enforceGameBuild is set consistently for all players

## Final Thoughts

Adding custom maps to FiveM is one of the most rewarding server improvements you can make. Done correctly, custom MLOs transform the player experience immediately. The key is methodical installation, conflict checking, and proper testing before opening to players.