A code-first TypeScript engine for 2D and 3D games in WebGPU-capable browsers and Electron. Built on Babylon Lite, with script lifecycles, scene trees, signals, and documentation for developers and coding agents.
By Astrum Forge Studios · ignifx.com · Apache-2.0
Use Node 24 or later and pnpm:
npx --package=@ignifx/cli@latest create-ignifx my-game --template 2d-topdown
cd my-game
pnpm install
pnpm devChoose 2d-topdown, 2d-sidescroller, 3d-third-person, or 3d-first-person.
Each template includes menus, settings, input rebinding, and saves. Add --desktop when creating
the project to include Electron support, then run pnpm dev:desktop.
See the CLI guide for options.
ignifx requires WebGPU; there is no WebGL fallback. The engine is pre-1.0, so minor releases may include breaking changes. See the changelog for release history and the engineering plan for open work.
- Core: scenes, prefabs, entities, scripts, rendering, custom shaders, assets, tweens, storage, and hot reload.
- Lighting: HDR, shadows, ambient occlusion, reflection probes, and baked light probes and lightmaps.
- 2D: sprites, tilemaps, animation, pixel-perfect cameras, 2D particles, and Rapier physics.
- 3D: Havok physics, character controllers, camera rigs, animation, navigation, particles, and terrain.
- Game systems: input actions, rebinding, audio, DOM UI, and devtools.
- Tooling: Vite integration, starter templates, Electron builds, and the host an editor embeds (
@ignifx/editor-host).
Use ignifx for core and the standard runtime extensions, or choose individual @ignifx/* packages.
Register the extensions your game needs when creating the app.
This browser example needs a <canvas> element and @ignifx/core installed. It creates a camera,
a directional light, and a cube that rotates each frame. speed is in degrees per second;
dt is the frame duration in seconds.
import { Camera, Light, MeshAsset, MeshRenderer, Script, createApp, f32 } from "@ignifx/core";
import type { ScriptCallbacks } from "@ignifx/core";
class Spinner extends Script.define({ speed: f32(90) }) implements ScriptCallbacks {
static typeId = "demo/Spinner";
update(dt: number): void {
this.transform.rotate({ x: 0, y: this.speed * dt, z: 0 });
}
}
const canvas = document.querySelector("canvas");
if (!(canvas instanceof HTMLCanvasElement)) {
throw new Error("ignifx needs a <canvas> element on the page.");
}
const app = await createApp({ canvas, settings: { rendering: { features: { shadows: true } } } });
app.registerComponents([Spinner]);
const eye = app.world.createEntity("Main Camera");
eye.transform.localPosition.set(0, 2.5, -4.5);
eye.transform.lookAt({ x: 0, y: 0.6, z: 0 });
eye.addComponent(Camera, { fov: 55 });
const sun = app.world.createEntity("Sun");
sun.transform.lookAt({ x: 0, y: -1, z: 0.5 });
sun.addComponent(Light, { type: "directional", intensity: 3 });
const cube = app.world.createEntity("Cube");
cube.addComponent(MeshRenderer, { mesh: MeshAsset.box(app, { size: 1.3 }) });
cube.addComponent(Spinner, { speed: 120 });
await app.start();Explore the runnable examples and compiled recipes for scene loading, prefabs, input, physics, audio, and UI.
- Engine guide and agent skill: setup, concepts, API references, and recipes. The
ignifxpackage ships it underskills/. To give a coding agent the skill in another project, copyskills/ignifx/into its skills directory (.claude/skills/for Claude Code) or runnpx skills add astrum-forge/ignifx. - Architecture: engine structure and subsystem design.
- Contributing: repository setup, commands, and checks.
- Coding standards and constitution: development rules.
- Agent entry point: instructions for working in this repository.
Apache License 2.0. See LICENSE and third-party notices.