Skip to content
MTA:SA Neon Documentation

startFileCutscene

Client-side
NEON APINative file cutscenes

Available in Neon, not standard MTA

Starts an owned, fully loaded native file cutscene exactly once.

Syntax

bool startFileCutscene(int token)

Arguments

tokenint

Current loaded file-cutscene token.

Returns

true when GTA started playback; false when loading is incomplete, playback already started, or the token is invalid.

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.

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 NEON APIS

Continue exploring

Read the system guide →
requestFileCutscene Acquires the exclusive camera lease, optionally owns GTA's visible world area, and starts loading a stock file cutscene. 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.

← Back to the Neon Lua API · How Native file cutscenes works →