Core Concepts

Loomle gives structured Unreal Editor objects a text workflow without replacing UE’s own object model. Four ideas explain nearly every request.

SAL Is the Shared Language

sal_query and sal_patch accept self-contained SAL Text and return canonical SAL Result Text. Its objects section is ordered Object Text, so bindings, fields, relationships, and factual comments remain readable in one format.

Learn the SAL working model

Identity Is Scoped

One flat Target selects a Domain and locates the UE owner. Native identity paths select stable contained objects inside that exact Target:

@node-guid
@node-guid/pin-guid
@widget-guid

Local aliases make one request readable but do not persist into another request.

Understand targets and stable references

Schema Is Discovered in Layers

The resident guide gives the minimum language model. Static interface cards describe one UE domain. Exact reads can append the dynamic-schema clause:

with schema

This exposes the fields, constraints, and operations available for one resolved object or Palette capability.

Use schema discovery

Mutation Is Explicit

A Patch is ordered and self-contained. Dry run uses the real validation and planning path before any live mutation. Authored edits, readback, compile, and save remain explicit steps so an agent can verify what happened.

Understand dry run and finalization

The Complete Loop 

project binding
  → locate the UE target
  → query a compact view
  → discover exact capability
  → dry-run the complete Patch
  → apply the same authored Patch
  → read back the result
  → compile and save through the owner

The Quickstart demonstrates this loop end to end.

Table of contents