Installation
Dependencies
| Dependency | Required | Why |
|---|---|---|
| hz_lib | Yes | The panel's UI kit, theme and fonts. Free. |
| Framework (ESX / QBCore / QBox) | No | Not used. HZ-Map runs the same on any of them, or none |
| Database | No | None. Player choices are saved on their own machine |
| A Cayo Perico loader | No | Only if you want players to walk on the island. HZ-Map draws it on the map |
Steps
- Drop the
hz_mapfolder into yourresourcesdirectory, next tohz_lib. - Add both to your
server.cfg, hz_lib first:
ensure hz_lib
ensure hz_map- Restart the server and reconnect.
One map resource at a time. Postal maps, satellite maps and other map recolours replace the same files as HZ-Map. Remove them, or the two will fight over the map.
What you should see
- The radar shows the Atlas style straight away.
- Open the pause map and go full screen: the places panel appears on the right, the area name top left and the scale bottom left.
- At the bottom of the panel, Map style and Day / night let each player pick their look.
Updating
When you update HZ-Map, players must close FiveM completely before they reconnect. The game keeps the old pause map in memory until it is closed, so a simple reconnect can show a mix of the old and new map.
Lighter download
The styles you don't offer can be deleted, and players won't download them:
| Not offering | Delete |
|---|---|
| Satellite | stream/satellite |
| Native | stream/native |
| The night map | stream/night |
Config.Themes and Config.Night.