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

  1. Start fx-3dmap. The order against fx-phone does not matter: when fx-3dmap starts or restarts, the phone sends its list again.
  2. 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.Enabled is not false, that the shop has a blip, and that ShopCategory exists in fx-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 (ShopCategory for the shops, TempCategory for the trace pin); add them to fx-3dmap/locations.lua or 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.