enginePreloadWorldArea | Multi Theft Auto: Wiki Skip to content

enginePreloadWorldArea

Client-side
Server-side
Shared

Added in 1.6.0 r22678

This function allows a specific area to be loaded immediately, which can be useful when teleporting a player. The function is not based on a radius, but a specific zone is loaded.

Syntax

nil enginePreloadWorldArea ( ​float x, ​float y, ​float z, [ ​string loadingOption = "all" ] )
Required Arguments
  • x: Position in the X axis.
  • y: Position in the Y axis
  • z: Position in the z axis.
Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use.

  • loadingOption (default: "all"): Argument of what exactly is to be loaded.
    • all: Loads models and collisions in a designated area.
    • models: Only loads models in the designated area.
    • collisions: Loads only collisions in the designated area.

Returns

  • nil: result

Nothing.

Code Examples

client
enginePreloadWorldArea(1000, 500, 0)
local z = getGroundPosition(1000, 500, 100)
setElementPosition(localPlayer, 1000, 500, z)

See Also

Engine Functions