SA:O APINative file cutscenes

Reads GTA's original cutscene skip input without applying the skip locally.

Syntax

Copy signature

bool isFileCutsceneSkipInputPressed(int token)

Arguments

tokenint

Current started file-cutscene token.

Returns

true on GTA's native skip-input edge; false otherwise or for invalid ownership.

Ownership and lifecycle

File cutscenes share GTA's exclusive camera lease. Release, resource shutdown, disconnect, or a camera takeover deletes the native cutscene before restoring gameplay state.

Important behavior

• In co-op, send only the authorized participant's request to the server and broadcast the decision before calling skipFileCutscene on every client.

Where this comes from

SOURCECLuaCameraDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaCameraDefs.cpp INTRODUCED / EXTENDED4f2be00c1Read the commit and why the change was made TEST RESOURCE tagging-up-turf test-resources/tagging-up-turf

RELATED SA:O APIS

Continue exploring

Read the system guide →

requestFileCutscene Load one of GTA:SA's original mission cutscenes by name. The returned handle lets Lua start it, detect completion, skip it, and restore gameplay afterward. isFileCutsceneLeaseActive Reports whether the calling resource still owns this file-cutscene generation. isFileCutsceneLoaded Reports whether GTA has finished loading the owned DAT/CUT/IFP cutscene data.

← Previous in categoryisFileCutsceneFinished Next in category →wasFileCutsceneSkipped

← Back to the SA:O Lua API · How Native file cutscenes works →