Loading Existing Games

vgai’s adapter system lets the editor load and edit games it didn’t author — including unmodified Three.js games — by depending on interfaces rather than on any one game’s internals.

In this section

• Adapter architecture — GameAdapter / MountedGame / HostContext and the AuthoringAdapter contract.
• First-party adapters — how vgai’s own scenes plug into the same seams.
• Ingesting unmodified games — the render-accessor trap captures a live scene with zero edits to the game’s code (the anti-shim rule: no fabricated scene data).
• System adapters — coordinate with a game’s physics, networking, input, assets, animation, and navigation.
• Overlay persistence — edits keyed by structural-path id, saved to .vgai/overlays and re-applied on reload.
• iframe tiers — embed-only and reachable-three in-realm editing, with honest ceilings.

In progress

The ingest tutorial loads a real unmodified Three.js fixture, edits it, and confirms the edit persists — validated end-to-end.