Log inGet started
World

Builtin Library

Branchmain
Branchesmainpublish
Commit44fd9e59bd

README.md

entityOps shared

Cross-tool helpers for the entityOps toolbox — the pieces more than one of its tools reuse.

  • Entity resolution — resolveEntity / resolveTargets / toList turn a name / id / proxy / scene.find record (single or a list) into live entity proxies, raising a legible error on anything that doesn't match.
  • Subtree removal — collectDescendants / despawnSubtree remove an entity and its whole subtree, raising rather than leaving a half-removed tree behind.
  • Slot capture — captureSlot snapshots the parent + local transform
    • name + sync flag an entity occupies, so a replacement can take its exact place.
  • Asset resolution — resolveAsset turns a caller's name / path / identity string (or an already-resolved AssetRef) into a resolved asset, reporting the canonical identity/path it hit, optionally limited to one asset category.

Tools are thin wrappers over these; the helpers call the engine APIs.