Skip to content
MTA:SA Neon Documentation

releaseScriptCamera

Client-side
NEON APINative script camera

Available in Neon, not standard MTA

Restores captured gameplay camera state and optionally leaves a successful scene under its black fade.

Syntax

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

Arguments

tokenint

Current lease generation token.

preserveFadebooloptional · default false

Keep the fade black so gameplay can fade in after restoration.

Returns

true when the calling resource released its current generation; false for stale or foreign tokens.

Ownership and lifecycle

Only one resource can own the global script camera. Neon rejects stale callbacks and releases ownership on stop, restart, disconnect, or an authoritative server camera RPC.

Where this comes from

SOURCECLuaCameraDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaCameraDefs.cpp INTRODUCED / EXTENDED8cf6cc3cbRead the commit and why the change was made RELATED CATEGORY HARNESS native-script-camera-test Category-level coverage · test-resources/native-script-camera-test
RELATED NEON APIS

Continue exploring

Read the system guide →
acquireScriptCamera Acquires the resource-exclusive GTA script camera and returns a generation token. isScriptCameraLeaseActive Reports whether the calling resource still owns the specified camera generation. setScriptCameraFixed Activates GTA's fixed script camera and native point-at control.

← Back to the Neon Lua API · How Native script camera works →