Skip to main content

Symptoms

The map opens as expected, but:
  • markers another resource created are missing from it entirely; or
  • they are drawn, but with a generic icon and no name in the legend; or
  • some resources’ markers appear and others’ do not.

Causes

The map finds every marker on its own and reads its icon, colour and position from the game. A marker’s name, size, category and the rest cannot be read back from the game: the resource that created the marker has to tell the map. For Lua resources, the integration does that. Markers listed under a generic name, at the wrong size. The integration is not installed, or the resource was started before it was. A resource that creates all its markers when it starts needs a restart after the integration is installed. Some resources but not others. The integration reaches the resources that existed when it was run. A resource added afterwards was never visited. Markers from a JavaScript or C# resource. The integration only reaches Lua. Those resources send their markers’ details themselves: see Markers from JavaScript and C#. A marker missing entirely. A marker set not to show on the game’s map (SetBlipDisplay) is left off this one too. A radius marker (AddBlipForRadius) is drawn only once the map knows its radius, which a JavaScript or C# resource has to send.

Fix

1. Install the integration

Run the script for your platform, from the install directory inside the map’s resource:
What it changes, and its prerequisites, are in Install an integration. Back up your resources directory first.

2. Restart the server

A full restart, so every resource is loaded with the integration in place and recreates its markers.

3. Confirm the integration reached the resource

Open the fxmanifest.lua of a resource whose markers are missing. Near the top there should be a line pointing into the map:
If it is absent, the script did not visit that resource. The usual reasons are that the resource was added after the script was run, or that it lives outside the resources directory the script found. Run the script again.

4. For markers without a name or icon

That is the creating resource’s part. It attaches map information to the marker it created:
The full set of fields is in Exports. If the resource is not yours, its author has to add the call. The map cannot invent a name for a marker that has none.

5. After updating the map

An update replaces the integration and the installer scripts, so run the installer again and restart.

Check that it worked

Open the map and confirm the previously missing markers are drawn, appear in the legend with the expected name and icon, and can be clicked. Check one marker from each resource that was affected, not only the first one: the integration is installed per resource, so one resource can still be missing while the rest are correct.