FAQ
Is Entelechy a game engine?
Section titled “Is Entelechy a game engine?”Not exactly. It is a runtime: the Host knows memory, devices and time, not games, lights or meshes. Games, renderers, physics and sound are programs written as .ent Kernels and .esn scenes, with reusable parts in packages/. The repository does hold whole games (slg, arcade, voxel) and protocol bridges to external hosts and DCC tools.
Do I need Rust?
Section titled “Do I need Rust?”Not to use it. No example has a line of Rust: you write .ent and .esn and run them with entelechy. Rust (1.93 or later) is needed only to build from source or change the runtime.
Is there a prebuilt release?
Section titled “Is there a prebuilt release?”docs/USAGE.md describes a release’s layout (bin/entelechy, include/, lib/, *-wasm32-wasip1.wasm, *-web), but the repository is private and HANDOFF.md says no release is planned. Build from source for now.
The three backends disagree. Which is right?
Section titled “The three backends disagree. Which is right?”The interpreter (--backend cpu). The JIT matches it bit for bit, the GPU to rounding. entelechy replay --round-apart checks whether a program leans on one rounding.
What happens when a change is wrong?
Section titled “What happens when a change is wrong?”Nothing. A change that fails to compile or validate is refused at file:line:column and the running version keeps running; a frame whose evaluation fails commits no state and no file write. See Hot swap & validation.
How does an AI connect?
Section titled “How does an AI connect?”Through the creation protocol: entelechy serve scene.esn, then JSON lines on stdin/stdout; or --listen for TCP/WebSocket, or the C ABI’s entelechy_request. Any model, any language, the same authority rules as the CLI and Player.
Does it run in a browser?
Section titled “Does it run in a browser?”Yes. Entelechy builds to WebAssembly: its JIT writes WebAssembly the page loads, and its GPU backend runs on the browser’s WebGPU (Chrome and Edge 137 and later). bridges/web/play.html is the Player in a page. See Embedding & bridges.
Why don’t the GitHub links open?
Section titled “Why don’t the GitHub links open?”The repository Fynn-3D/entelechy is private; source links open only for accounts with access.
How do these docs relate to the repository’s docs/?
Section titled “How do these docs relate to the repository’s docs/?”The repository’s README.md and docs/*.md are the authoritative English documents. This site reorganizes them and the source into a manual and a reference; the Class reference is generated from the source’s own tables and rustdoc. Where they differ, the repository wins; see About these docs.