getactors - Mintlify Starter Kit

Shows you all Actors a game has, so it can run code on one.

getactors(): {Actor}

The table is a plain array, so getactors()[1] is the first actor. Hand one of them to run_on_actor to run code on that thread.

Returns

{Actor} - an array of every Actor instance currently in the game. The array is empty when the game has no actors.

Example

Grab the first actor in the game and run a script on it.

local actors = getactors()

local actors = getactors()

if actors[1] then -- its not nil[1] its {}[1] -> nil. pls know the difference
    run_on_actor(actors[1], [[
        print("I'm running on an actor! is_parallel: ".. is_parallel())
    ]])
end

Not every Roblox game has actors. Many developers rarely create an Actor, so getactors returns an empty table - check it has an entry before indexing.