Markers - Element Labs

Purpose

configs/blips.jsonc controls how the map draws the markers it shows: those created by your other resources, the player’s own marker, the destination marker, and the points of interest players place. These are fallbacks and shared behaviour. A marker that states its own icon, colour or size keeps it; the values here apply to markers that state nothing, and to the parts of a marker no resource controls.

Options

Fallback appearance

Used for a marker whose creator did not set that property.

Key	Default	Meaning
`defaultSprite`	`1`	The icon. `1` is the standard round marker.
`defaultColor`	`0`	The colour, as a game colour index.
`defaultScale`	`1.0`	The size, where `1.0` is the standard size.
`defaultFont`	`1`	The font used for the marker’s label.

Pointing at a marker

Key	Default	Meaning
`hoverScale`	`1.15`	How much a marker grows while the cursor is on it. `1.15` is fifteen percent larger.
`hoverRadiusWorld`	`250.0`	The ground distance, in metres, the cursor counts as pointing at a marker within. A marker 250 metres away lights up, whatever the zoom.
`hoverRadius`	`10.0`	The smallest hover distance, in interface units. It matters only at extreme zoom-out, where the ground distance above would shrink below it.
`hoverRadiusMax`	`16.0`	The largest hover distance, in interface units. It is what the cursor uses at every ordinary zoom, and it is about the size of a marker: without it, zooming in close would make the ground distance cover most of the screen and everything would light up at once.

Markers outside the view

Key	Default	Meaning
`edgeIndicators`	`false`	Whether a marker off the edge of the screen is drawn as an indicator at that edge, pointing towards it.

This is the default for every marker. A marker that states its own setting keeps it, which is why the player’s own marker is always shown at the edge regardless of this value. Turning it on shows where things are while zoomed in, at the cost of a busier edge when many markers are off view.

The player’s marker

Key	Default	Meaning
`playerSprite`	`6`	The icon for the player’s own position. `6` is the standard player arrow.
`playerColor`	`0`	Its colour.

This marker follows the player, is always drawn on top, cannot be clicked, and is shown at the edge of the screen when the player is off view.

The destination marker

Key	Default	Meaning
`waypointMarkerSprite`	`8`	The icon the map places where a destination is set.
`waypointMarkerColor`	`27`	Its colour.

Points of interest

Personal markers a player places from the map. See How players use the map.

Key	Default	Meaning
`poiSprite`	`162`	The icon.
`poiColor`	`5`	Its colour.
`poiMax`	`10`	How many a player may have at once. Placing one more moves the oldest marker instead of rebuilding it.
`poiAtCursor`	`false`	Place a point under the mouse pointer. When false, place it at the centre of the map.
`poiRemoveFactor`	`0.06`	How the removal distance grows with altitude: six percent of the camera’s height above ground.
`poiMinRemove`	`15.0`	The smallest removal distance, in metres, whatever the altitude.

The removal distance is whichever of the two is larger. At the default values, a camera 200 metres up removes a point of interest within 15 metres, and a camera 2,000 metres up removes one within 120 metres. That keeps removal usable at every zoom level.

Vision cones

A marker can show a cone in the direction it faces. The keys here apply to a marker that asks for a cone without stating its own values.

Key	Default	Meaning
`coneFov`	`90.0`	How wide the cone is, in degrees.
`coneRange`	`50.0`	How far it reaches, in metres.
`coneColor`	`11`	Its colour. A marker that carries a colour outside the game’s palette draws its cone in that colour instead, unless it names a `coneColor` of its own.
`coneAlpha`	`153`	How opaque it is, from `0` (invisible) to `255` (solid). Applies to every cone; a marker cannot override it.

Flashing and numbers

Key	Default	Meaning
`flashInterval`	`500`	The flash period in milliseconds, for markers that flash. Lower is faster.
`numberFont`	`"$Font2"`	The embedded Scaleform font name used for numbered markers.
`numberSize`	`16`	Its size.

Example

Larger markers, with a wider hover target and more room for points of interest:

{
  "namespace": "blips",
  "configVersion": 1,
  "scope": "client",
  "values": {
    "hoverScale": 1.3,
    "hoverRadiusMax": 22.0,
    "poiMax": 25,
    "coneAlpha": 200
  }
}

Applying changes

restart element_map

Markers created by other resources take these values the next time the map is opened.

Safety

Key	Stay within	Why
`poiMax`	Roughly `5` to `30`	Each point of interest is drawn every frame while the map is open. Raising it far above the default costs performance for every player.
`hoverRadius`	Roughly `6` to `20`	Too large and neighbouring markers overlap, so the wrong one is selected. Too small and markers become hard to hit. Only matters at extreme zoom-out.
`hoverRadiusWorld`	Roughly `100` to `400`	The same range of ground as the original pause map. Very large, markers far from the cursor light up while the map is zoomed out.
`hoverRadiusMax`	Roughly `10` to `25`	The on-screen ceiling for the hover area, and the value the cursor actually uses at ordinary zoom. Above it, a marker lights up while the cursor is well away from it. Below it, hitting a marker needs more cursor precision.
`hoverScale`	Roughly `1.05` to `1.5`	Below `1.0` a marker shrinks when pointed at, which reads as an error.
`coneRange`	A plausible world distance, roughly `10` to `200`	A very large value draws cones covering the whole view, hiding what is under them.
`coneAlpha`	`0` to `255`	Outside that range the value is not meaningful. `0` hides every cone.
`flashInterval`	Above `100`	Below that, flashing is fast enough to be uncomfortable to look at.
`poiRemoveFactor`	Roughly `0.02` to `0.15`	Higher removes points of interest a player did not intend to remove; lower makes them hard to remove when zoomed out.

Sprite, colour and font values are game indexes, not names. An index the game does not have produces a blank or default icon rather than an error, so check the result in game after changing one.

Configuration
Exports: the properties a resource can set per marker
Markers do not appear

​Purpose

​Options

​Fallback appearance

​Pointing at a marker

​Markers outside the view

​The player’s marker

​The destination marker

​Points of interest

​Vision cones

​Flashing and numbers

​Example

​Applying changes

​Safety

​Related