Actors

Subscribe a function to a communication channel’s event. Use the returned connection to stop receiving messages when your task is finished.

Send an event through a communication channel to its connected listeners. It is handy for one-way notifications between scripts or states.

Create a communication channel and keep its numeric ID for code running in another state. The returned receiver also lets this script subscribe to or fire the same channel.

Look up a channel created with create_comm_channel by its numeric ID. Use this to share a simple event between pieces of code that do not share ordinary Luau tables.

Find the Actor associated with the current executing thread. Use it inside Actor code to identify its owner without passing the Instance separately.

Resolve the Actor associated with a thread proxy or LuaStateProxy. Use it when state enumeration gave you a proxy and you need the owning Instance.

List live Actor Instances whose Luau states Kawaii can currently see. This is a starting point for choosing an active Actor before calling run_on_actor.

Get thread proxies associated with active Actor states. Pass one of these proxies to run_on_thread when you need to run source in its represented state.

List live thread references whose associated Actor owner has been deleted. This is a diagnostic view of leftover Actor execution state, useful when checking whether old threads are still retained.

Compile and start source in the active state belonging to an Actor. This is useful when a small piece of work must run where that Actor lives.