prototypeRoots( ) →

Ids of every active-layer entity carrying the PlayerPrototype component.

editorOnlyEntities( ) → void

Ids of every active-layer entity whose participation is EditorOnly.

setLive(live: boolean) → void

Apply an active/internal state to every prototype root and EditorOnly entity.

setEditorSurfaceLive(live: boolean) → void

Apply an active/hidden state to the tracked EditorOnly entities alone, leaving prototype roots untouched. Pausing play returns the editor authoring surface (the free camera + editor-only visualizers) over the frozen world, but must NOT revive the player-prototype clone sources — those stay deactivated so no duplicate body appears alongside the live avatar. Operates on the tracked-id list (not a fresh query) because the entities are marked internal in play and a query would no longer return them.

showEditorSurface( ) → void

Reactivate and unhide the EditorOnly authoring surface (free camera + editor-only visualizers) without touching player-prototype roots. Used when play mode is paused so the editor camera returns over the frozen world.

hideEditorSurface( ) → void

Deactivate and hide the EditorOnly authoring surface without touching player-prototype roots. Used when play mode resumes so the surface disappears and gameplay cameras take the viewport back.

deactivatePrototypes( ) → void

Deactivate and hide every prototype root and EditorOnly entity so play mode neither simulates nor renders them.

activatePrototypes( ) → void

Reactivate and unhide every prototype root and EditorOnly entity.

registerClone(id: string) → void

Track a runtime clone root so it can be despawned on the return to edit.

despawnClones( ) → void

Despawn every still-existing tracked clone and clear the tracking list.

enterPlay( ) → void

Enter play mode: deactivate and hide prototypes and EditorOnly entities.

enterEdit( ) → void

Enter edit mode: despawn runtime clones, then reactivate prototypes and EditorOnly entities.

install( ) → void

Keep the play-mode invariant applied for every flip, in every world. `enterPlay` / `enterEdit` are what make `PrototypeOnly` and `EditorOnly` mean something at runtime, and until something calls them on the flip a template stays live: its camera competes for the viewport with the camera of the player cloned from it, carries no follow target, and holds the shot at the spawn point; its body answers the same input as a second character. Registered from the prelude beside the other engine installs rather than from a scene-load path — a load that does not run leaves the invariant unapplied with nothing reporting it, and a flip that reloads no scene never reaches a loader hook at all. Idempotent: a second call registers nothing, and the current mode is applied once on install so a world opened straight into play does not start with its templates live.

PrototypeLifecycle.install()