Skip to content
MTA:SA Neon Documentation

releaseFileCutscene

Client-side
NEON APINative file cutscenes

Available in Neon, not standard MTA

Deletes the owned native cutscene and restores the camera, near clip, widescreen, and controls captured by its lease.

Syntax

bool releaseFileCutscene(int token [, bool preserveFade = false])

Arguments

tokenint

Current file-cutscene token.

preserveFadebooloptional · default false

Keep the current black fade while restoring gameplay state.

Returns

true when the current resource released its generation; false for a stale or foreign token.

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
  • Resource shutdown, disconnect, and authoritative camera takeover run the same native cleanup automatically.

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 →