Operators

Modular logic centers in Aircada responsible for managing state, processing event bus signals, and directly manipulating 3D SceneObjects.

Published: 7/10/2026

Aircada Operators are the custom scripting components of your application. They are designed to act as highly responsive brains: receiving events, reading/writing from the global Twin-Proxy store, and directly manipulating 3D mesh transforms, materials, and components in the scene loop.

Anatomy of an Operator

Every Operator is a TypeScript class decorated with metadata. The @Operator decorator configures its identity within the visual docs.studio and the engine's query system.

Data & String Processing

Perform mathematical calculations, numerical precision rounding, date conversions, and string transformations.

State & Data Blocks

Manage global session variables, reactive key-value stores, local database files, and preset object loaders.

DOM & Scroll Controls

Monitor scroll viewport positions, track window coordinates, and trigger direct DOM element updates.

E-Commerce & Transactions

Coordinate shopping cart transactions, store checkout pipelines, and commercial gateway integrations.

Generate custom image assets, draw dynamic canvas text decals, capture screenshots, and execute background removals.

Core Philosophy

Operators serve as the 'brain' of a scene, bridging declarative property state with direct, imperative control of 3D objects.

Property Sync & Styling

Manage custom inspector fields, dynamic layout themes, and responsive display variables across form-factor break points.

Runtime Instantiation

How to programmatically instantiate built-in or custom Operators at runtime using the Aircada Context API.

Spatial & Motion

Handle 3D coordinate vectors, orbital rotation cycles, follow tracking behavior, and bounding box math.

System & Flow Control

Manage core execution flows, lifecycle triggers, conditional validation gating, delays, and background event routing.

Code Implementation Template (The Gold Standard)

This is the flawless structural template for a modern Aircada Operator. Note the complete absence of 3D mesh code.

Built-in vs. Custom Operators

Understand the distinction between built-in operators created via Aircada Studio and custom operators developed using the SDK.