FiveM-MiniMaps
Sign in
Built for

Installing a custom FiveM minimap

Installing a minimap is two steps and one thing everybody forgets. It is worth writing down properly because the failure mode is confusing: you do everything right, restart, join, and the map looks exactly as it did before — which makes it look like the resource is broken when it is not.

Our picks

What we would run on this kind of server

Three concrete recommendations rather than a shrug — with the reason attached.

Black OBSIDIAN FiveM minimap for GTA V — without postal codes — showing Los Santos street detailBlack OBSIDIAN FiveM minimap for GTA V — without postal codes — showing the whole San Andreas map No postals
BlackOBSIDIAN

A safe first install — neutral, no numbers, nothing to conflict with.

6144 × 9216 px · 78 files · without postal codes
$8.00+ $1 / elementView
Orange EMBER FiveM minimap for GTA V — with postal codes — showing Los Santos street detailOrange EMBER FiveM minimap for GTA V — with postal codes — showing the whole San Andreas map Postal codes
OrangeEMBER

If you want to see the difference immediately, numbers and all.

6144 × 9216 px · 78 files · with postal codes
$8.00+ $1 / elementView
Mixed light TOPO DAY FiveM minimap for GTA V — google style — showing Los Santos street detailMixed light TOPO DAY FiveM minimap for GTA V — google style — showing the whole San Andreas map Google style
Mixed lightTOPO DAY

The most obviously different map, for testing that it took.

6144 × 9216 px · 78 files · google style
$8.00+ $1 / elementView

The three steps

Unzip the resource into your `resources` folder, keeping the folder name it came with. Add one line to `server.cfg`. Restart the server. That is the install.

Then the step people miss: clear the client cache on the machine you are testing from. FiveM caches streamed textures aggressively, and the old minimap will keep being served to you long after the new one is live for everybody joining fresh.

  • 1 — drop the folder into resources
  • 2 — add `ensure pityus_minimap_<name>` to server.cfg
  • 3 — restart the server
  • 4 — delete FiveM Application Data\data\cache on your own machine

Only one map resource at a time

Two resources streaming the same texture names is a coin flip over which one wins, and the result is a map that changes depending on load order or even on the session. Stop or remove any other minimap, postal map, satellite map or atlas pack before you start.

Look for anything with `minimap`, `map`, `postal`, `satmap` or `atlas` in the name. If you inherited the server from somebody, look twice.

If the map still has not changed

Check the resource actually started — the console says so on restart, and a folder with a bad name or a missing manifest simply will not. Check no second map resource is running. Then clear the cache again, because the first clear frequently happens while the client is still open and FiveM writes it back on exit.

If it changed for you and not for a player, that is the cache on their machine, not your install.

Rolling it out to players

Nobody has to install anything. Streamed assets are downloaded on join, so the first connection after the change takes a little longer and every one after that is normal. Twenty-two megabytes is small enough that most players will not notice it at all.

Questions

Where do I put a FiveM minimap resource?
In your server resources folder, as its own directory, exactly as it came out of the zip. Then add an ensure line for it in server.cfg.
Why has my minimap not changed after installing?
Almost always the client cache. Delete FiveM Application Data\data\cache with FiveM closed and reconnect. The second most common cause is another map resource still running.
Do players need to download or install anything?
No. The map streams from the server on join like every other asset.
Can I run two minimaps and switch between them?
Not at the same time — they overwrite each other unpredictably. Swap which one is ensured and restart.
Does it need a specific artifact version?
No. It is texture streaming, which has worked the same way for years and does not depend on a recent build.

Not sure yet?

Open the live preview and look at any street on any theme before you spend a cent.