# F.A.Q > Answers about UI and DUI maps, minimap styles, calibration, discovery and saved annotations. Category: CARTOGRAPHY · Source: https://miciomods.it/docs/ml-custommap-faq · Last updated: 2026-10-05 ## Setup and map modes ### Which maps are included? The four full-world designs are Custom Tourist, Satellite, Road and Atlas. Each has a UI and DUI item. The separate Del Perro treasure image is a regional test example; its red X and route do not create a quest or reward. ### What is the difference between UI and DUI? UI opens the map interface on screen. DUI draws the interactive map onto a paper prop held by the player, with its own viewing camera and lighting. Both modes support panning, zooming, annotations, fog of war and waypoints. ### How do players choose a map? Use the matching inventory item. `P` opens the first eligible map item found and does not show a selector. Set `Config.Keybind.key` to change its default key; players can rebind it in the FiveM settings. ### Can I configure several map items? Yes. In multi-item mode, `Config.Items` binds each inventory item to a map ID and display mode. UI bindings use a map ID string; DUI bindings use `{ map = 'id', mode = 'dui' }`. Register every item in your inventory. ### Do UI and DUI items share annotations and explored areas? In metadata mode, each item has its own serial, so separate items have separate progress. In database mode, progress belongs to the player and map ID. Two bindings to the same map ID use that player's same row. The tourist UI and DUI bindings use different map IDs, `tourist` and `mappa`. ### How do I remove item requirements? Set `Config.ItemMode = 'none'`. The map keybind opens `Config.DefaultMapId` and the compass requires no item. Staff commands keep their permission checks. ### The map opens but its image is blank. Check `Config.Maps[mapId].image` and the file in `maps/`. Use the exact filename, including its extension and letter case on Linux. The image also needs to be included by the resource manifest. ### Which inventory icons should I install? Copy the ten PNG map icons from `_INSTALL/images` to your inventory's image directory. Their filenames match the map item names. Use `_INSTALL/items.lua` as the item reference and adapt it to your inventory format. ### How can staff test a map? Enable `Config.Debug` and use `/map ` for UI or `/duimap ` for DUI. `/mapclose` closes the viewer and `/compass` tests the compass. The server requires admin permission for `/map`; debug mode does not remove staff checks. ## Minimap ### How do I select Satellite, Road or Atlas for the radar? Set `Config.MinimapStyle` to `custom`, `satellite`, `road` or `atlas`. This selects one native style for the server, independently of map items. Keep `Config.MinimapControl` enabled and apply the change before players connect. ### Does the circular minimap require ml_hud? No. The radar layout and border run inside `ml_custommap`. Diameter and margins in `Config.RadarPosition` scale from 1080p, with aspect ratio and safe-zone settings included in the layout. ### Another HUD should control the minimap. What should I change? Set `Config.MinimapControl = false`. The item maps, DUI mode, fog, compass and waypoints remain available. Keep one resource responsible for native radar texture replacement and positioning. ### The radar is incomplete after stopping and starting the resource in game. Keep the streaming resource running before players connect. A stop/start can leave an already connected client with incomplete native minimap assets. Reconnect with `ml_custommap` running before testing those assets again. ### Can staff use the native GTA map? Enable `Config.NativeMap.allowStaff` and use its configured command, `nativemap` by default. The server checks `staffPermission`; nil uses any admin group accepted by `ml_bridge`. The toggle affects only the calling player. `allowEveryone` keeps native map access enabled for everyone. ## Regional images and calibration ### How do I make a map for one area? Start from the `del_perro_treasure` entry, use your own image, and give it a unique map ID and item bindings. Set its coordinate dimensions, zoom bounds and `fogRevealRadius` for the area. A cropped image needs calibration for that crop. ### How do I calibrate an image? Stand at a recognizable world location and run `/mapcalibrate `. Click that position on the overlay. Move to another point and repeat, spreading points across the image and both axes. Run `/mapcalibrate done` to compute and copy the calibration, then paste it into that map's entry. The solver accepts two points; four or more are recommended. `/mapcalibrate reset` clears the session. ### Can I share calibration between images? Yes, when projection, framing and coordinate dimensions match. The bundled Satellite, Road and Atlas maps share calibration. Resizing, cropping or rotating an image changes its alignment. The calibration solver cannot correct rotated artwork or roads moved while drawing it. ### Why are the player and waypoints in the wrong place? Check the map's coordinate dimensions and calibration against its image. Use recognizable locations across the image to calibrate again. Copying full-world values into a regional crop will place positions incorrectly. ## Fog of war ### The reveal radius is too small or too large. Set `fogRevealRadius` inside that `Config.Maps` entry. It overrides `Config.FogOfWar.revealRadius` in meters. The tourist maps use 800; the Del Perro example uses 75. The visible edge is feathered, while discovery still uses the saved grid. ### Does discovery continue while the map is closed? Yes, for the active map session while its item remains eligible. The resource can start that session on player load or after starting in game. Opening another map can switch the session; it does not track every carried map at once. Discovery deltas sync to the server every 30 seconds. ### How do I reset fog progress? Back up the database, stop the resource so its cache cannot overwrite the change, and clear `discovered` for the affected map. Start the resource before players connect so sessions load the reset data. ```sql UPDATE ml_custommap_data SET discovered = NULL WHERE map_id = 'del_perro_treasure'; ``` Omit the WHERE clause only when you intend to reset discovery for every map. Changing map dimensions, calibration scale or reveal radius can change the fog grid and require a reset for that map. ### How do I show the full map? Set `Config.FogOfWar.enabled = false` to disable tracking and display the full image. The staff map editor also shows the full image. `bypassDebug` hides fog while debug mode is enabled. ## Annotations and storage ### How do I share a marker? Right-click the marker and choose Copy. Another player can open their map, right-click, choose Import and paste the code. ### How do I place markers for everyone? Use `/addblip ` with staff permission. Each marker produces a config entry in the console and clipboard. Paste it into `Config.DefaultMarkers`. Those markers belong to the chosen map ID. ### My annotations are missing when I reopen a map. Check that you are opening the same item serial in metadata mode, or the same map ID in database mode. Check server database errors and keep map item metadata intact. Admin marker placement produces config entries rather than saving player annotations. ### Where does metadata mode store map data? The item stores a unique serial. MySQL stores its annotations and fog in `ml_custommap_data`. When an inventory preserves that serial during a trade or drop, the item keeps access to its map data. Database mode stores progress by player identifier and map ID. ### Why do pasted images need an HTTP or HTTPS URL? The server accepts HTTP and HTTPS image URLs and rejects other schemes, including data:, file: and javascript:. Use an accessible image URL on your web host or image CDN. ## Compass and held map ### The compass does not appear. Check `Config.Compass.enabled` and the access mode. Multi-item mode requires `Config.Compass.item`; single-item mode requires `Config.SingleItem`. The compass is hidden while the map viewer is open. ### Which markers appear on the compass? The compass uses `Config.DefaultMarkers`. Player annotations stay on the map. ### How do I adjust the held map camera or prop? Enable `Config.Debug` and run `/duistudio `. Tab switches between camera and prop editing. Enter copies both settings to the clipboard and F8 console; paste them into `Config.DuiMaps`. Scale both DUI resolution values together if changing texture size. ## Update the resource ### How do I update without losing custom settings? Back up `shared/config.lua`, locales, custom map images and the database. Replace the resource files from CFX Portal and merge your settings into the supplied config so every required field remains present. Preserve registered items and their metadata. Start the resource before players connect and confirm the console has no errors.