CutscenesClientNot in this build

getCutFileOffset

GET_CUT_FILE_OFFSET0x1FA904B60E492336

The GTA V native GET_CUT_FILE_OFFSET of the CUTSCENE namespace, as LS:MP client scripts call it: the global function getCutFileOffset, in JavaScript and in Lua.

SignatureJavaScript
getCutFileOffset(
  cutsceneName: string,
  index: number
): { x: number, y: number, z: number }
SignatureLua
getCutFileOffset(cutsceneName: string, index: integer): Vector3
⚠
Not in this game build

The global exists, but the native is not part of the game build LS:MP runs: calling it does nothing and returns undefined in JavaScript, nil in Lua. It never throws. See Coverage.

Usage

JavaScript
const { x, y, z } = getCutFileOffset(cutsceneName, index);
Lua
local coords = getCutFileOffset(cutsceneName, index)
-- coords.x, coords.y, coords.z

Parameters

ParameterTypeJavaScriptLua
cutsceneNamestringstringstring
indexintnumberinteger

Returns

Vector3 JavaScript { x: number, y: number, z: number }, Lua Vector3

A 3D vector. JavaScript gets a plain { x, y, z } object; Lua gets a real Vector3, with .x .y .z and arithmetic. As an argument, one vector fills three consecutive coordinates.

Reference

Namespace
Cutscenes CUTSCENE
In the game
Vector3 GET_CUT_FILE_OFFSET(const char* cutsceneName, int index)
Hash
0x1FA904B60E492336
Introduced
Game build 3570 legacy numbering

Open in the interactive natives reference