A collection of wrapper functions to handle asset requests in GTA. It simplifies the process of loading models, animations, interiors, textures, and more, ensuring resources are available before use.
Functions
request_model
Load and wait for a specified model to be available.
--- Specify model
local model_hash = GetHashKey('a_m_m_business_01')
--- Utils object
utils.requests.model(model_hash)
--- Direct export
exports.boii_utils:request_model(model_hash)
request_interior
Request an interior and wait until its ready.
--- Get interior id
local interior_id = GetInteriorAtCoords(440.84, -983.14, 30.69)
--- Utils object
utils.requests.interior(interior_id)
--- Direct export
exports.boii_utils:request_interior(interior_id)
request_texture
Requests a texture and waits until loaded.
--- Specify texture
local texture_dict = 'mpweaponscommon'
--- Utils object
utils.requests.texture(texture_dict, true)
--- Direct export
exports.boii_utils:request_texture(texture_dict, true)
request_collision
Request collision at a location and wait until its loaded.
--- Define location
local x, y, z = 440.84, -983.14, 30.69
--- Utils object
utils.requests.collision(x, y, z)
--- Direct export
exports.boii_utils:request_collision(x, y, z)
request_anim
Request animation dictionary and wait until its loaded.
--- Specify anim dict
local anim_dict = 'amb@world_human_smoking@male@male_a@base'
--- Utils object
utils.requests.anim(anim_dict)
--- Direct export
exports.boii_utils:request_anim(anim_dict)
request_anim_set
Request animation set and wait until its loaded.
--- Specify anim set
local anim_set_name = 'move_m@brave'
--- Utils object
utils.requests.anim_set(anim_set_name)
--- Direct export
exports.boii_utils:request_anim_set(anim_set_name)
request_clip_set
Request animation clip set and wait until its loaded.
--- Specify clip set
local anim_clip_set = 'move_m@confident'
--- Utils object
utils.requests.clip_set(clip_set)
--- Direct export
exports.boii_utils:request_clip_set(clip_set)
request_audio_bank
Requests a script audio bank and waits until loaded.
--- Specify audio bank
local audio_bank = 'DLC_HEIST_HACKING_SNAKE'
--- Utils object
utils.requests.audio_bank(audio_bank)
--- Direct export
exports.boii_utils:request_audio_bank(audio_bank)
request_scaleform_movie
Requests a scaleform movie and waits until loaded.
--- Specify scaleform movie
local scaleform = 'instructional_buttons'
--- Utils object
utils.requests.scaleform_movie(scaleform)
--- Direct export
exports.boii_utils:request_scaleform_movie(scaleform)
request_cutscene
Request a cutscene and play once loaded.
--- Specify cutscene
local cutscene_name = 'mp_intro'
--- Utils object
utils.requests.cutscene(cutscene_name)
--- Direct export
exports.boii_utils:request_cutscene(cutscene_name)
request_ipl
Request an IPL and activate it.
--- Specify IPL name
local ipl_name = 'hei_dlc_heist_police_station'
--- utils object
utils.requests.ipl(ipl_name)
--- Direct export
exports.boii_utils:request_ipl(ipl_name)