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

# Energy Compatible Maps

One package that makes every Energy map work together on the same server, with zero conflicts.

**`zz_energy_mapdata`** makes all Energy maps work together on the same server.

When two or more Energy maps edit the same GTA file (occlusion, LOD, collision, props, grass), FiveM keeps only one copy and the other map breaks: holes in the ground, missing props, wrong occlusion. This package fixes that automatically for **any combination** of Energy maps.

{% hint style="info" %}
Free for Energy customers who already own at least one Energy map or an active ALL MAPS subscription. Delivered on the Cfx portal (Keymaster) and protected by Cfx Asset Escrow: install it on a server linked to the account that owns your Energy maps.
{% endhint %}

## What it does

* Detects which Energy maps are running on your server (even if you renamed the resource folders).
* Picks the right merged version of every conflicting file for exactly the maps you have.
* Writes those files into its own `stream` folder at server start and keeps them updated when you add or remove a map.
* Newer game builds (3717 and above): the files from the maps' `build` folders are applied automatically. No manual copying.

## Install

1. Download `zz_energy_mapdata` from the Cfx portal and extract it into your `resources` folder (a category folder like `[energy]` is fine).
2. In `server.cfg`, **after** your Energy maps, add:

```
ensure zz_energy_mapdata
```

3. Also in `server.cfg` (anywhere), allow the resource to restart itself after writing the files:

```
add_ace resource.zz_energy_mapdata command.restart allow
```

Without this line the console shows `Access denied for command restart` and you have to restart the server once more (or type `restart zz_energy_mapdata`) every time your maps change.

4. Restart the server. The console shows:

```
[energy_mapdata] Energy maps detected (12): dealershipauto, lostranch, palazzoranch, ...
[energy_mapdata] 32 file(s) applied, 0 removed, 0 failure(s) [boot]
[energy_mapdata] restarting zz_energy_mapdata so the game streams the new files
```

The resource restarts itself once after writing the files. That is expected.

{% hint style="warning" %}
Do not rename the `zz_energy_mapdata` folder. FiveM resolves duplicated files by resource name (alphabetical, last wins); the `zz_` prefix is what makes the package win over the maps' own copies.
{% endhint %}

{% hint style="warning" %}
Delete the old conflict-fix files you used to copy inside the maps. They are no longer needed and can override the package.
{% endhint %}

## Adding or removing a map

Just restart the server (or `ensure` / `stop` the map). The package recalculates by itself. Manual re-check: type `energy_mapdata` in the server console.

## Good to know

* Console messages follow the `sets locale` of your `server.cfg` (English, Portuguese, Spanish). To force one: `set energy_mapdata_locale en`.
* The package writes only inside its own folder, so it works with the FXServer script sandbox. The only permission it needs is the `command.restart` ACE from the install steps, used to reload its own files.

## Supported maps

All current Energy maps: Auto Car Dealership, Downtown Medical Center, Eclipse Police DP, Eclipse Roof Top, Evo Motors Mechanic, Gear Head Customs, La Fuente Blanca, Liberty Customs, Los Santos Customs, LS Tunnel, Luxury Autos, Mansion Dubai, Mansion Vinewood, Mansion Vinewood V2, Mansion Vinewood Elite, Marlowe Vineyard, Mosley Mechanic Dealership, Mount Zonah Medical Center, O'Driscoll Ranch, O'Neil Ranch, Palazzo Ranch, Ponsonbys, Prestige Motorsport, RedLine, Ride Out Customs, Rockford Medical Center, Sandy Shores Hospital, Sandy Shores Sheriff Department, Stores, Sushi Bar, The Lost Ranch, Over Speed Mechanic, L.S.P.D Vinewood, `energy_galaxy`, `energy_vanilla`, `energy_underground`.

New maps are added to the package as they are released. Update the package from the Cfx portal when a new version is announced.

## Troubleshooting

* `Access denied for command restart`: add `add_ace resource.zz_energy_mapdata command.restart allow` to `server.cfg` (see Install). The files were already written; one more server restart loads them.
* `no variant for <file>`: a combination not covered by the package. Send the console line on our Discord and we add it.
* `N file(s) failed: not restarting`: the server could not write inside the `zz_energy_mapdata` folder. Check the folder permissions on your host, then run `energy_mapdata` in the console.
* Console shows `sv_enforceGameBuild not set`: the package treats the server as an old build and does not apply the `build` folders of the maps. Set `sv_enforceGameBuild` in `server.cfg` if your server runs a newer build.