Features
Map integration
What FX Phone reports to the fx-3dmap resource and how to set it up.
fx-3dmap is a separate resource that replaces the pause-menu map with a 3D map. It only shows the places other resources tell it about; it does not read the game's own blips. When it runs, fx-phone reports its own blips to it, so they show on the 3D map too.
Without fx-3dmap nothing here does anything, and you can leave Config.Map3D as it is.
#What the phone puts on the 3D map
| What | When | Category |
|---|---|---|
| Phone shops | Every shop of Config.PhoneShop that has a blip, while the shops are switched on |
ShopCategory |
| Anon trace zone | While an Anon trace result is on the map, then removed |
TempCategory |
That is the whole list. Waypoints need nothing: fx-3dmap follows the game's own waypoint, so a waypoint set from the phone (for example the directions button of a company in Services) shows there by itself.
#Phone shops
Each shop goes on the map with its name, its blip sprite and colour (default sprite 459, colour 3). When you add, move or remove a shop on the admin tablet, the list on the 3D map is replaced.
The game's own shop blips stay as they are, with one link between the two: when a player switches the shop category off on fx-3dmap (radial menu > Blips), the game's shop blips are hidden as well, and they come back when the category is switched on. Outside opening hours the game's blip is dimmed; the 3D map shows the shop either way. See Phone shop.
#Anon trace zone
An Anon trace draws a circle on the game's map that the traced phone is somewhere inside; see Anon. fx-3dmap has no circles, so the 3D map gets a single pin at the centre of the zone. The pin goes away with the circle, after the trace command's Seconds.
#Options
luaConfig.Map3D = {
Enabled = true,
ShopCategory = 'servisler',
TempCategory = 'other',
Category = 'other',
}
| Option | Default | What it does |
|---|---|---|
Enabled |
true |
false: nothing is reported to fx-3dmap, even when it runs |
ShopCategory |
'servisler' |
fx-3dmap category the phone shops are listed under. The game's shop blips follow its on / off switch |
TempCategory |
'other' |
Category of short-lived markers: the Anon trace pin |
Category |
'other' |
Fallback for a marker that has no category of its own |
The category ids are the ones in fx-3dmap/locations.lua > Config.Categories. A category that does not exist there is refused by fx-3dmap.
#Setting it up
- Start fx-3dmap. The order against fx-phone does not matter: when fx-3dmap starts or restarts, the phone sends its list again.
- Check that the category ids above exist in
fx-3dmap/locations.lua. Change them if your fx-3dmap uses other names.
Changing Config.Map3D is a client setting: restart fx-phone after changing it.
#Companion apps
Config.Map3D covers fx-phone's own blips only. The bundled apps in Config.BundledApps (for example fx-mapsapp with friends' live locations) are separate resources with their own settings; this block does not change what they do.
#Good to know
- The shops do not show on the 3D map. Check that fx-3dmap is started, that
Config.Map3D.Enabledis notfalse, that the shop has a blip, and thatShopCategoryexists infx-3dmap/locations.lua. - Console:
fx-3dmap did not take the "shops" locations. Is the category "servisler" defined…. fx-3dmap refused the list for 30 seconds. The message names the categories that list really uses (ShopCategoryfor the shops,TempCategoryfor the trace pin); add them tofx-3dmap/locations.luaor change them here. - The game's shop blips disappeared. The shop category is switched off in fx-3dmap's radial menu. Switch it back on there.
- When fx-phone starts, it first clears whatever it left on fx-3dmap in an earlier session, then sends the current list.