{
  "schemaVersion": 1,
  "title": "Instructional Buttons",
  "sourceUrl": "https://docs.fivem.net/docs/game-references/instructional-buttons/",
  "retrievedAt": "2026-09-23",
  "downloadUrl": "/game-references/data/instructional-buttons.json",
  "sections": [
    {
      "id": "icon-list",
      "title": "Icon list",
      "columns": [
        "ID",
        "Name"
      ],
      "rows": [
        {
          "id": "icon-list-0",
          "cells": [
            {
              "text": "0"
            },
            {
              "text": "Arrow Up"
            }
          ]
        },
        {
          "id": "icon-list-1",
          "cells": [
            {
              "text": "1"
            },
            {
              "text": "Arrow Down"
            }
          ]
        },
        {
          "id": "icon-list-2",
          "cells": [
            {
              "text": "2"
            },
            {
              "text": "Arrow Left"
            }
          ]
        },
        {
          "id": "icon-list-3",
          "cells": [
            {
              "text": "3"
            },
            {
              "text": "Arrow Right"
            }
          ]
        },
        {
          "id": "icon-list-4",
          "cells": [
            {
              "text": "4"
            },
            {
              "text": "Dpad up"
            }
          ]
        },
        {
          "id": "icon-list-5",
          "cells": [
            {
              "text": "5"
            },
            {
              "text": "Dpad down"
            }
          ]
        },
        {
          "id": "icon-list-6",
          "cells": [
            {
              "text": "6"
            },
            {
              "text": "Dpad left"
            }
          ]
        },
        {
          "id": "icon-list-7",
          "cells": [
            {
              "text": "7"
            },
            {
              "text": "Dpad right"
            }
          ]
        },
        {
          "id": "icon-list-8",
          "cells": [
            {
              "text": "8"
            },
            {
              "text": "Dpad"
            }
          ]
        },
        {
          "id": "icon-list-9",
          "cells": [
            {
              "text": "9"
            },
            {
              "text": "Dpad all"
            }
          ]
        },
        {
          "id": "icon-list-10",
          "cells": [
            {
              "text": "10"
            },
            {
              "text": "Dpad up down"
            }
          ]
        },
        {
          "id": "icon-list-11",
          "cells": [
            {
              "text": "11"
            },
            {
              "text": "Dpad left right"
            }
          ]
        },
        {
          "id": "icon-list-12",
          "cells": [
            {
              "text": "12"
            },
            {
              "text": "Left stick up"
            }
          ]
        },
        {
          "id": "icon-list-13",
          "cells": [
            {
              "text": "13"
            },
            {
              "text": "Left stick down"
            }
          ]
        },
        {
          "id": "icon-list-14",
          "cells": [
            {
              "text": "14"
            },
            {
              "text": "Left stick left"
            }
          ]
        },
        {
          "id": "icon-list-15",
          "cells": [
            {
              "text": "15"
            },
            {
              "text": "Left stick down"
            }
          ]
        },
        {
          "id": "icon-list-16",
          "cells": [
            {
              "text": "16"
            },
            {
              "text": "Left stick"
            }
          ]
        },
        {
          "id": "icon-list-17",
          "cells": [
            {
              "text": "17"
            },
            {
              "text": "Left stick"
            }
          ]
        },
        {
          "id": "icon-list-18",
          "cells": [
            {
              "text": "18"
            },
            {
              "text": "Left stick up down"
            }
          ]
        },
        {
          "id": "icon-list-19",
          "cells": [
            {
              "text": "19"
            },
            {
              "text": "Left stick left right"
            }
          ]
        },
        {
          "id": "icon-list-20",
          "cells": [
            {
              "text": "20"
            },
            {
              "text": "Left stick clockwise"
            }
          ]
        },
        {
          "id": "icon-list-21",
          "cells": [
            {
              "text": "21"
            },
            {
              "text": "Right stick up"
            }
          ]
        },
        {
          "id": "icon-list-22",
          "cells": [
            {
              "text": "22"
            },
            {
              "text": "Right stick down"
            }
          ]
        },
        {
          "id": "icon-list-23",
          "cells": [
            {
              "text": "23"
            },
            {
              "text": "Right stick left"
            }
          ]
        },
        {
          "id": "icon-list-24",
          "cells": [
            {
              "text": "24"
            },
            {
              "text": "Right stick right"
            }
          ]
        },
        {
          "id": "icon-list-25",
          "cells": [
            {
              "text": "25"
            },
            {
              "text": "Right stick"
            }
          ]
        },
        {
          "id": "icon-list-26",
          "cells": [
            {
              "text": "26"
            },
            {
              "text": "Right stick"
            }
          ]
        },
        {
          "id": "icon-list-27",
          "cells": [
            {
              "text": "27"
            },
            {
              "text": "Right stick up down"
            }
          ]
        },
        {
          "id": "icon-list-28",
          "cells": [
            {
              "text": "28"
            },
            {
              "text": "Right stick left right"
            }
          ]
        },
        {
          "id": "icon-list-29",
          "cells": [
            {
              "text": "29"
            },
            {
              "text": "Right stick clockwise"
            }
          ]
        },
        {
          "id": "icon-list-30",
          "cells": [
            {
              "text": "30"
            },
            {
              "text": "A"
            }
          ]
        },
        {
          "id": "icon-list-31",
          "cells": [
            {
              "text": "31"
            },
            {
              "text": "B"
            }
          ]
        },
        {
          "id": "icon-list-32",
          "cells": [
            {
              "text": "32"
            },
            {
              "text": "X"
            }
          ]
        },
        {
          "id": "icon-list-33",
          "cells": [
            {
              "text": "33"
            },
            {
              "text": "Y"
            }
          ]
        },
        {
          "id": "icon-list-34",
          "cells": [
            {
              "text": "34"
            },
            {
              "text": "RB"
            }
          ]
        },
        {
          "id": "icon-list-35",
          "cells": [
            {
              "text": "35"
            },
            {
              "text": "LT"
            }
          ]
        },
        {
          "id": "icon-list-36",
          "cells": [
            {
              "text": "36"
            },
            {
              "text": "RB"
            }
          ]
        },
        {
          "id": "icon-list-37",
          "cells": [
            {
              "text": "37"
            },
            {
              "text": "RT"
            }
          ]
        },
        {
          "id": "icon-list-38",
          "cells": [
            {
              "text": "38"
            },
            {
              "text": "Start"
            }
          ]
        },
        {
          "id": "icon-list-39",
          "cells": [
            {
              "text": "39"
            },
            {
              "text": "Select"
            }
          ]
        },
        {
          "id": "icon-list-40",
          "cells": [
            {
              "text": "40"
            },
            {
              "text": "Invalid"
            }
          ]
        },
        {
          "id": "icon-list-41",
          "cells": [
            {
              "text": "41"
            },
            {
              "text": "Invalid"
            }
          ]
        },
        {
          "id": "icon-list-42",
          "cells": [
            {
              "text": "42"
            },
            {
              "text": "Invalid"
            }
          ]
        },
        {
          "id": "icon-list-43",
          "cells": [
            {
              "text": "43"
            },
            {
              "text": "Invalid"
            }
          ]
        },
        {
          "id": "icon-list-44",
          "cells": [
            {
              "text": "44"
            },
            {
              "text": "Clockwise Spinner"
            }
          ]
        },
        {
          "id": "icon-list-45",
          "cells": [
            {
              "text": "45"
            },
            {
              "text": "Arrow up down"
            }
          ]
        },
        {
          "id": "icon-list-46",
          "cells": [
            {
              "text": "46"
            },
            {
              "text": "Arrow left right"
            }
          ]
        },
        {
          "id": "icon-list-47",
          "cells": [
            {
              "text": "47"
            },
            {
              "text": "Arrow left right up down"
            }
          ]
        },
        {
          "id": "icon-list-48",
          "cells": [
            {
              "text": "48"
            },
            {
              "text": "Clockwise spinner"
            }
          ]
        },
        {
          "id": "icon-list-49",
          "cells": [
            {
              "text": "49"
            },
            {
              "text": "Cloud save spinner (Yellow, Clockwise)"
            }
          ]
        },
        {
          "id": "icon-list-50",
          "cells": [
            {
              "text": "50"
            },
            {
              "text": "Counter-clockwise spinner"
            }
          ]
        }
      ]
    },
    {
      "id": "scaleform-movie-methods",
      "title": "Scaleform movie methods",
      "columns": [
        "Signature",
        "Contract"
      ],
      "rows": [
        {
          "id": "scaleform-movie-methods-0",
          "cells": [
            {
              "text": "TOGGLE_MOUSE_BUTTONS(bool toggle)"
            },
            {
              "text": "Toggles clickable buttons"
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-1",
          "cells": [
            {
              "text": "SET_SAVING_TEXT(int iconEnum, string saveStr)"
            },
            {
              "text": "Sets a text with loading icon"
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-2",
          "cells": [
            {
              "text": "REMOVE_SAVING()"
            },
            {
              "text": "Removes the loading icon text"
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-3",
          "cells": [
            {
              "text": "CLEAR_ALL()"
            },
            {
              "text": "Clears all instructional button slots"
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-4",
          "cells": [
            {
              "text": "CLEAR_RENDER()"
            },
            {
              "text": "Stops rendering buttons"
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-5",
          "cells": [
            {
              "text": "OVERRIDE_POSITION(float x, float y, bool alignBottomRight)"
            },
            {
              "text": "Overrides buttons' position."
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-6",
          "cells": [
            {
              "text": "SET_CLEAR_SPACE(float clearSpace)"
            },
            {
              "text": ""
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-7",
          "cells": [
            {
              "text": "SET_DATA_SLOT(int index, any icon, string text, bool clickable, int controlIndex)"
            },
            {
              "text": "Adds a button slot. You can add up to 20 icons, those can be either input strings (e.g ~INPUT_FRONTEND_ACCEPT~ for enter) or icon id's.\nNote: Make sure to not add last two parameters if TOGGLE_MOUSE_BUTTONS is FALSE to prevent glitchy buttons."
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-8",
          "cells": [
            {
              "text": "SET_DATA_SLOT_EMPTY()"
            },
            {
              "text": "Alias for CLEAR_ALL()"
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-9",
          "cells": [
            {
              "text": "CLEAR_BACKGROUNDS()"
            },
            {
              "text": "Removes background for the buttons."
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-10",
          "cells": [
            {
              "text": "DRAW_INSTRUCTIONAL_BUTTONS(int layoutType)"
            },
            {
              "text": "Sets buttons to be drawn."
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-11",
          "cells": [
            {
              "text": "GET_NUMBER_OF_ROWS()"
            },
            {
              "text": "Returns number of rows. Note: You need to use scaleform movie method return value natives for this."
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-12",
          "cells": [
            {
              "text": "SET_BACKGROUND()"
            },
            {
              "text": "Adds background."
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-13",
          "cells": [
            {
              "text": "SET_PADDING(int top, int right, int bottom, int left)"
            },
            {
              "text": ""
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-14",
          "cells": [
            {
              "text": "SET_BACKGROUND_COLOUR(int r, int g, int b, int a)"
            },
            {
              "text": "Overrides background colour."
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-15",
          "cells": [
            {
              "text": "OVERRIDE_RESPAWN_TEXT(int index, string text)"
            },
            {
              "text": "Overrides text for a button."
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-16",
          "cells": [
            {
              "text": "FLASH_BUTTON_BY_ID(int buttonID, int alpha, int duration)"
            },
            {
              "text": "Flashes a button"
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-17",
          "cells": [
            {
              "text": "SET_MAX_WIDTH(float maxWidth)"
            },
            {
              "text": "Sets max width for buttons. This prevents buttons from being off-screen if there are too many data slots set. Instead, they will stack up."
            }
          ]
        },
        {
          "id": "scaleform-movie-methods-18",
          "cells": [
            {
              "text": "SET_HIT_AREA_VISIBLE(bool isVisible)"
            },
            {
              "text": "Shows debug hit area for mouse visible. This hit area is used for native 0x3d9acb1eb139e702, which returns whether or not the mouse cursor is above instructional buttons if TOGGLE_MOUSE_BUTTONS is true."
            }
          ]
        }
      ]
    },
    {
      "id": "examples-and-illustrations",
      "title": "Examples and illustrations",
      "columns": [
        "Preview",
        "Context"
      ],
      "rows": [
        {
          "id": "examples-and-illustrations-0",
          "cells": [
            {
              "text": "",
              "images": [
                {
                  "src": "/game-references/instructional_buttons_result.png",
                  "alt": "Code Result",
                  "width": 111,
                  "height": 56
                }
              ]
            },
            {
              "text": "Lua"
            }
          ]
        },
        {
          "id": "examples-and-illustrations-1",
          "cells": [
            {
              "text": "",
              "images": [
                {
                  "src": "/game-references/instructional_buttons_result_2.png",
                  "alt": "Code Result",
                  "width": 100,
                  "height": 49
                }
              ]
            },
            {
              "text": "Lua"
            }
          ]
        },
        {
          "id": "examples-and-illustrations-2",
          "cells": [
            {
              "text": "",
              "images": [
                {
                  "src": "/game-references/instructional_buttons_result_3.png",
                  "alt": "Code Result",
                  "width": 180,
                  "height": 43
                }
              ]
            },
            {
              "text": "Lua"
            }
          ]
        }
      ]
    }
  ]
}
