ignifx

Builds 2D and 3D web games with the ignifx TypeScript engine on WebGPU.

Updated Sep 5, 2026
One-click install
npx skills add https://github.com/astrum-forge/ignifx --skill ignifx-astrum-forge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ignifx
Source: https://github.com/astrum-forge/ignifx/tree/main/skills/ignifx
Command: npx skills add https://github.com/astrum-forge/ignifx --skill ignifx-astrum-forge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Writing games with the ignifx TypeScript engine requires knowing its entity-component model, Script lifecycle, scene JSON format, asset system, and WebGPU-only constraints; this Skill supplies that knowledge so generated code compiles and behaves correctly the first time. ## Core Features & Use Cases - Game code generation: Creates ignifx apps, entities, Script classes with schemas and typeIds, scenes, prefabs, and input actions using createApp and the @ignifx/* extension packages. - Subsystem guidance: Covers rendering, 2D sprites and tilemaps, 3D physics and character controllers, audio, UI, particles, terrain, and Electron desktop builds through detailed reference documents. - Scaffolding and environment checks: Ships Node scripts that scaffold new Script classes (new-script.mjs) and report WebGPU browser support (check-webgpu.mjs). - Use Case: Ask for a top-down 2D player controller with Rapier physics and sprite animation, and receive a registered Script class plus the scene JSON wiring that follows engine conventions and avoids documented gotchas. ## Quick Start Use the ignifx skill to create a spinning cube app with a camera, directional light, and a registered Spinner script for my WebGPU browser game.

Frequently Asked Questions about ignifx

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a game with the ignifx TypeScript engine?

Run npx @ignifx/cli@latest my-game with a template like 2d-topdown or 3d-third-person, then pnpm install and pnpm dev. In code, call createApp with a canvas, register your Script classes, build entities, and await app.start().

How do I write a Script component in ignifx?

Extend Script.define with a schema of serialized fields, set a namespaced static typeId like "mygame/Mover", and implement lifecycle callbacks such as update(dt). Register the class with app.registerComponents before loading any scene that uses it.

Does ignifx support WebGL or browsers without WebGPU?

No, ignifx renders exclusively through WebGPU with no WebGL fallback. It supports Chrome/Edge 113+, Safari 26+, and Firefox 141+ on Windows; createApp rejects with IGX-0701 when no adapter is available.

Can I test ignifx games headlessly in Node without a GPU?

Yes, call createApp with headless: true and drive frames with app.step(dt), optionally using createManualClock. Physics, input simulation, and audio all run headless, making gameplay logic testable in Node 24.

Why does my ignifx mesh not appear right after spawning at runtime?

A material family that did not exist when the scene was registered takes Babylon Lite's runtime build path, adding up to three frames before the mesh appears. Call app.renderer.warmUp with the materials for anything loaded after start.

Can ignifx games ship as desktop apps with Electron?

Yes, scaffold with the --desktop flag and register the electron() extension. The @ignifx/electron package provides createGameWindow, a sandboxed preload bridge, file-system storage, and handles the required WebGPU flags.