Controls - Element Labs

Purpose

configs/controls.jsonc owns the command that opens the map, the key it is bound to by default, and how the camera responds to the mouse. Which controls a player uses is fixed and not configurable: dragging is always the left mouse button, zooming is always the wheel, and setting a destination is always the right button or a double click. What you change here is how those inputs feel. The full list is in How players use the map.

Options

Key	Default	Meaning
`command`	`"map_toggle"`	The internal name of the key binding. The map registers it as the command `+<command>` and binds the key to it. Renaming it after players have bound the key resets their bindings.
`defaultKey`	`"ESCAPE"`	The key bound for a player who has not chosen their own.
`dragSensitivity`	`1.0`	How far the camera moves for a given mouse movement. `2.0` moves twice as far.
`scrollSensitivity`	`100.0`	How much altitude one scroll step changes.
`friction`	`0.6`	How quickly movement decays after the input stops. Lower settles sooner; higher glides longer.
`maxScrollSpeed`	`5000.0`	The ceiling on how fast altitude can change, whatever the scroll input.
`doubleClickMs`	`300`	The longest gap, in milliseconds, between two clicks that still counts as a double click.
`detailKey`	`56`	The control that toggles high/low blip detail on the map. `56` is the gamepad’s right-stick click, the same button the original pause map uses; it is a control index, not a key name, so a keyboard player who wants it should set it to a keyboard control index.

The label players see for the binding in the FiveM key-mapping menu is the controls.description text in the language files. The shipped English label is Toggle 3D Map. Both sensitivities are relative to altitude, not to the world: the same drag covers more ground when the camera is higher. That is what keeps the map usable at every zoom level, and it means the defaults do not need adjusting for a particular part of the map.

Choosing a key

defaultKey accepts the key names FiveM uses, such as M, F5, TAB or ESCAPE. It applies only to players who have not set their own binding; a player who has rebound the key keeps their choice, and changing this value does not move it. ESCAPE is chosen so the map takes the place of the pause map. If your server binds ESCAPE elsewhere, pick another key here.

Example

{
  "namespace": "controls",
  "configVersion": 1,
  "scope": "client",
  "values": {
    // ESCAPE is taken by our own menu.
    "defaultKey": "M",
    "dragSensitivity": 1.4,
    "friction": 0.45
  }
}

Everything not listed keeps its shipped value.

Applying changes

restart element_map

Players who already rebound the key are unaffected by a change to defaultKey. Players who have not are moved to the new key at their next connection.

Safety

Key	Stay within	Why
`friction`	Above `0`, below `1`	At `1` or above, movement never settles and the camera drifts after every drag. At `0` it stops the instant the button is released, which feels abrupt but is usable.
`dragSensitivity`	Roughly `0.5` to `2.0`	Far above that, a small hand movement crosses the map and precise positioning becomes impossible.
`scrollSensitivity`	Roughly `50` to `300`	Far above that, one scroll step crosses most of the altitude range.
`maxScrollSpeed`	Leave as shipped unless zooming feels capped	Lowering it makes zooming feel heavy; raising it lets a fast scroll overshoot.
`doubleClickMs`	Roughly `200` to `500`	Below that, double clicks are hard to perform. Above it, a click on a marker takes noticeably long to act, because the map waits to see whether a second click follows.

command is safe to change, but changing it after players have rebound the key resets their bindings: FiveM keeps a binding against the command name, and a renamed command is a new one.

​Purpose

​Options

​Choosing a key

​Example

​Applying changes

​Safety

​Related