Volt Documentation

Runs a script on an actor's state.

Syntax

run_on_actor(actor: Actor, script: string, ...: any) -> void

Parameters

Parameter	Type	Description
`actor`	`Actor`	The actor to run the script on
`script`	`string`	The Lua code to execute
`...`	`any`	Arguments passed to the script

Returns

This function does not return a value.

Description

run_on_actor executes the provided script string on the specified actor's Luau state. This allows you to run code in parallel on different threads.

Example

local actor = Instance.new("Actor")
actor.Parent = workspace

run_on_actor(actor, [[
    print("Hello from actor!")
    print("Arguments:", ...)
]], "arg1", "arg2")

With Communication Channel

local id, channel = create_comm_channel()
channel.Event:Connect(function(message)
    print("Received:", message)
end)

run_on_actor(Instance.new("Actor"), [[
    local channelId = ...
    local channel = get_comm_channel(channelId)
    channel:Fire("Hello from actor!")
]], id)

Notes

The script runs in the actor's isolated environment
Use communication channels to send data back
Arguments are passed via varargs (...)

getactors - Get all actors
create_comm_channel - Create communication channel

run_on_actor

On this page