Arma 3 Scripting

Command in Interaction

showHUD

Also available as Markdown and JSON, or read the original wiki page.

Description

Enable / disable showing of HUD. Defines visibility of weapon crosshair and any informational tags that appear when pointing the weapon at an object as well as availability of the default action menu. Unfortunately, it also hides icons drawn with drawIcon3D.

Note

Arma 3: Since Arma 3 v1.50 there is a Description.ext's showHUD[] array param that is identical in format to the extended showHUD command. When present, it will disable showHUD command entirely, allowing mission makers to permanently alter visibility of some HUD elements.

Since Arma 3 v2.04 it is possible to force drawing of drawIcon3D icons when HUD is hidden. The icons will also show when custom camera is created and the view is switched to it via switchCamera or cameraEffect provided cameraEffectEnableHUD is enabled. For more information see drawIcon3D.

Syntax

Syntax 1

showHUD enable

Parameters:

Returns: Nothing

Syntax 2

showHUD [scriptedHUD, info, radar, compass, direction, menu, group, cursors, panels, kills, showIcon3D]

Parameters:

Returns: Nothing

Examples

Example 1

showHUD false;

Example 2

Hide vehicle radar and compass:

showHUD [
    true,  // scriptedHUD
    true,  // info
    false, // radar
    false, // compass
    true,  // direction
    true,  // menu
    true,  // group
    true,  // cursors
    true,  // panels
    true,  // kills
    true   // showIcon3D
];

Example 3

Check if HUD visibility is hardcoded in mission config and showHUD command is overridden:

private _disabledShowHUD = isArray (missionConfigFile >> "showHUD");

See also

shownHUD · showCinemaBorder · showSubtitles · showWatch · showRadio · showMap · showGPS · showCompass · showPad

Community notes

Killzone_Kid

The "cursors" parameter controls visibility of the action menu as well as weapon cursors. However if 1st param "hud" hides and disables action menu, param "cursors" only hides it. So you get invisible action menu that is fully operational. inGameUISetEventHandler will still fire on interaction, giving the information about selected item on the action menu even if you cannot see it. Unfortunately it also hides icons drawn with drawIcon3D.

POLPOX
showHUD false;

removes Contact's compass that is shown at the top of the screen.