SA:O APINative scene primitives

Ask GTA to preload the world around a destination and viewing direction before revealing a teleport or cutscene.

Syntax

Copy signature

bool enginePreloadWorldAreaInDirection(Vector3 position, float headingDegrees)

Arguments

positionVector3

Finite scene position.

headingDegreesfloat

Finite direction in degrees.

Returns

true after GTA completes the directional load; false for non-finite input.

Ownership and lifecycle

These calls act immediately on streamed native state and do not create a persistent lease. The resource remains responsible for scene timing and authoritative mission progression.

Important behavior

• This call can block while GTA loads the requested scene; stage it under an appropriate fade.

Where this comes from

SOURCECLuaEngineDefs.cppClient/mods/deathmatch/logic/luadefs/CLuaEngineDefs.cpp INTRODUCED / EXTENDEDe4bddaac4Read 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 →

reportVehicleMissionAudioEvent Reports one verified GTA script-audio event on a streamed vehicle's native audio entity. isVehicleOnAllWheels Reproduces GTA opcode 09D0's exact all-four-contact vehicle gate. setPedUseNativeWalkingStyle Make a ped or player automatically use the walk and run animations associated with its current skin, including after changing its model.

Next in category →reportVehicleMissionAudioEvent

← Back to the SA:O Lua API · How Native scene primitives works →