Strict Guardrails & Rules

Critical rules that must be followed when developing an Operator with direct scene control.
Published: 7/10/2026
  • Scene Object References: Use @SceneObjectProperty to reference 3D entities. Always initialize with Layer 2 Operator Refs (e.g., SceneObjects.KEY).
  • Direct Manipulation: You can directly mutate properties on referenced object facades (e.g., this.target.transform). This is preferred for high-frequency or complex 3D logic.
  • Studio Wiring: Properties decorated with @FloatProperty or @StringProperty are automatically exposed to the Visual Studio for designer-led wiring.
  • No WebGL/DOM: Do not attempt to query the DOM or write raw Three.js/WebGL code. Use the provided SDK facades for all scene interactions.
  • Lifecycle Awareness: 3D objects are hydrated during @Setup(). Avoid accessing scene objects in a constructor.