YimMenu/docs/lua/tables/script.md

Table: script

Table containing helper functions related to gta scripts.

Functions (6)

register_looped(name, func)

Registers a function that will be looped as a gta script. Example Usage:

script.register_looped("nameOfMyLoopedScript", function (script)
     -- sleep until next game frame
     script:yield()

     local ModelHash = joaat("adder")
     if not STREAMING.IS_MODEL_IN_CDIMAGE(ModelHash) then return end
     STREAMING.REQUEST_MODEL(ModelHash) -- Request the model
     while not STREAMING.HAS_MODEL_LOADED(ModelHash) do -- Waits for the model to load
         script:yield()
     end
     local myPed = PLAYER.PLAYER_PED_ID()
     local myCoords = ENTITY.GET_ENTITY_COORDS(myPed, true)
     -- Spawns a networked vehicle on your current coords
     local spawnedVehicle = VEHICLE.CREATE_VEHICLE(ModelHash, myCoords.x, myCoords.y, myCoords.z, ENTITY.GET_ENTITY_HEADING(myPed), true, false)
     -- removes model from game memory as we no longer need it
     STREAMING.SET_MODEL_AS_NO_LONGER_NEEDED(ModelHash)
     -- sleep for 2s
     script:sleep(2000)
     ENTITY.DELETE_ENTITY(spawnedVehicle)
end)

• Parameters:
  • name (string): name of your new looped script
  • func (function): function that will be executed in a forever loop.

Example Usage:

script.register_looped(name, func)

run_in_fiber(func)

Executes a function once inside the fiber pool, you can call natives inside it and yield or sleep. Example Usage:

script.run_in_fiber(function (script)
     -- sleep until next game frame
     script:yield()

     local ModelHash = joaat("adder")
     if not STREAMING.IS_MODEL_IN_CDIMAGE(ModelHash) then return end
     STREAMING.REQUEST_MODEL(ModelHash) -- Request the model
     while not STREAMING.HAS_MODEL_LOADED(ModelHash) do -- Waits for the model to load
         script:yield()
     end
     local myPed = PLAYER.PLAYER_PED_ID()
     local myCoords = ENTITY.GET_ENTITY_COORDS(myPed, true)
     -- Spawns a networked vehicle on your current coords
     local spawnedVehicle = VEHICLE.CREATE_VEHICLE(ModelHash, myCoords.x, myCoords.y, myCoords.z, ENTITY.GET_ENTITY_HEADING(myPed), true, false)
     -- removes model from game memory as we no longer need it
     STREAMING.SET_MODEL_AS_NO_LONGER_NEEDED(ModelHash)
     -- sleep for 2s
     script:sleep(2000)
     ENTITY.DELETE_ENTITY(spawnedVehicle)
end)

• Parameters:
  • func (function): function that will be executed once in the fiber pool.

Example Usage:

script.run_in_fiber(func)

is_active(script_name)

Returns true if the specified script is currently active/running. Example Usage:

local is_freemode_active = script.is_active("freemode")

• Parameters:
  • script_name (string): The name of the script.

Example Usage:

script.is_active(script_name)

execute_as_script(script_name, func)

• Parameters:
  • script_name (string): Target script thread.
  • func (function): Function that will be executed once in the script thread.

Example Usage:

script.execute_as_script(script_name, func)

add_patch(script_name, name, pattern, offset, _patch)

Adds a patch for the specified script. Example Usage:

script.add_patch("fm_content_xmas_truck", "Flickering Fix", "56 ? ? 4F ? ? 40 ? 5D ? ? ? 74", 0, {0x2B, 0x00, 0x00})

• Parameters:
  • script_name (string): The name of the script.
  • name (string): The name of the patch.
  • pattern (string): The pattern to scan for within the script.
  • offset (integer): The position within the pattern.
  • _patch (table): The bytes to be written into the script's bytecode.

Example Usage:

script.add_patch(script_name, name, pattern, offset, _patch)

start_launcher_script(script_name)

Tries to start a launcher script. Needs to be called in the fiber pool or a loop. Example Usage:

script.run_in_fiber(function()
     script.start_launcher_script("am_hunt_the_beast")
end)

• Parameters:
  • script_name (string): The name of the script.

Example Usage:

script.start_launcher_script(script_name)