Make any Roblox model an intelligent world actor.

• Humanoids and characters

  Guards · Villagers · Companions · Crowd extras

  Observes

  Pose, footing, nearby actors, audible events, held items, damage state.

  Actuates

  Locomotion targets, animation intent, item use, speech and emote hooks.

• Merchants and service actors

  Shopkeepers · Quest givers · Repair stations · Brokers

  Observes

  Inventory, price table, reputation with the counterparty, open offers.

  Actuates

  Offers, counter-offers, reservations, and settled resource transactions.

• Ground vehicles

  Cars · Trucks · Trams · Service vehicles

  Observes

  Speed, heading, lane or path progress, obstacle lookahead, fuel, occupancy.

  Actuates

  Throttle, brake, steering target, gear, signals, doors.

• Aircraft

  Fixed wing · Rotorcraft · Drones · Airport ground traffic

  Observes

  Altitude, attitude, airspeed, waypoint progress, clearance state, separation.

  Actuates

  Throttle, control surfaces, gear, waypoint commitment, hold and go-around.

• Boats and watercraft

  Ferries · Cargo vessels · Patrol craft · Dock tenders

  Observes

  Heading, drift, berth availability, draft clearance, cargo and passenger load.

  Actuates

  Throttle, rudder, mooring lines, ramps, loading and unloading sequences.

• Animals and wildlife

  Herds · Predators · Mounts · Ambient fauna

  Observes

  Home range, threat proximity, food and water sources, herd members, fatigue.

  Actuates

  Movement targets, flee and pursue behaviours, feeding, resting, vocalisation.

• Swarms and formations

  Flocks · Drone groups · Convoys · Crowd units

  Observes

  Member states, formation error, shared objective, separation constraints.

  Actuates

  Formation targets, role assignment, split and merge, coordinated arrival.

• Robots and machines

  Cranes · Robotic arms · Conveyors · Turrets · Drills

  Observes

  Joint state, working envelope, load, queue depth, maintenance state.

  Actuates

  Joint targets, grip and release, feed rate, start, stop and safe-hold.

• Infrastructure and systems

  Signals · Doors and gates · Power grids · Logistics networks

  Observes

  Node states, throughput, backlog, fault flags, dependency graph.

  Actuates

  Routing, scheduling, capacity allocation, isolation and restoration.

• Creator-defined actors

  Anything with observable state and a way to act on it

  Observes

  Whatever your adapter chooses to normalise.

  Actuates

  Whatever your adapter chooses to expose, subject to the same validation.

return Runtime.defineAdapter({
    id = "machine/gantry",

    -- Normalise the model into the observation the kernel reasons over.
    observe = function(model)
        return {
            boom_angle  = model.Boom:GetAttribute("Angle"),
            hoist_height = model.Hoist.Position.Y,
            payload      = model:GetAttribute("PayloadId"),
            envelope     = { radius = 42, height = 28 },
            faults       = model:GetAttribute("Faults") or {},
        }
    end,

    -- Everything this embodiment can be asked to attempt.
    actions = {
        slew    = { params = { angle = "number" },  cost = { power = 2 } },
        hoist   = { params = { height = "number" }, cost = { power = 3 } },
        grip    = { params = { target = "Instance" } },
        release = {},
    },

    -- Actuation only. Validation and resource settlement already happened.
    apply = function(model, action, params)
        if action == "slew" then
            model.Boom:SetAttribute("TargetAngle", params.angle)
        end
    end,
})

return {
    id = "domain/port-operations",

    roles = {
        ["port.crane_operator"] = {
            capabilities = { "machine.slew", "machine.hoist", "machine.grip", "cargo.transfer" },
            constraints = {
                max_payload_tonnes = 40,
                forbid_when        = { "storm_warning", "quay_closed" },
                require_clearance  = "port.deck_clear",
            },
            resources = {
                power = { budget_per_minute = 240 },
            },
        },
    },

    goals = {
        ["port.clear_inbound_queue"] = {
            satisfied_when = "inbound_queue.depth == 0",
            decompose_to   = { "cargo.select_next", "cargo.transfer", "cargo.stow" },
            abandon_when   = { "storm_warning" },
        },
    },
}

Interfaces shown here are abridged for readability — the full signatures are in the SDK reference. Interface changes land only in a major release, always with a migration note, and are never absorbed silently into a patch.

Server authority

No client can cause a world-state commit by sending a message.

Planning, validation, resource settlement and commit all execute server-side. Client input enters as a goal request that passes through the same validation as everything else, and carries no capability of its own.

Capability boundaries

An actor cannot attempt anything its role did not declare.

The planner composes plans exclusively from the action surface declared by the adapter and granted by the role manifest. There is no dynamic dispatch into arbitrary code at decision time, so an undeclared action has no reachable call path.

External-provider isolation

An external model can propose. It cannot act.

Providers receive a redacted subset of the observation, explicitly enumerated per configuration. Their response re-enters as a proposal at the validation step and is checked identically to a local plan. They hold no capability, no resource authority and no commit path.

Safe failure

Degradation stops the actor; it does not loosen the rules.

A provider timeout falls back to the deterministic planner. A manifest that fails to load prevents attachment rather than defaulting to a permissive role. A stalled planner holds the last safe state and stops issuing actions.