Skip to content
astrum-forgePublic

About

A TypeScript game engine built on top of Babylon.js Lite (WebGPU). Runs in the browser and Electron

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

807 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ignifx

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

Start a game

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 dev

Choose 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.

What is included

  • 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.

A spinning cube

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.

Documentation

  • Engine guide and agent skill: setup, concepts, API references, and recipes. The ignifx package ships it under skills/. To give a coding agent the skill in another project, copy skills/ignifx/ into its skills directory (.claude/skills/ for Claude Code) or run npx 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.

License

Apache License 2.0. See LICENSE and third-party notices.

About

A TypeScript game engine built on top of Babylon.js Lite (WebGPU). Runs in the browser and Electron

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages