Four rendering modes
Choose how PixiJS and Three.js render the game.
Select rendering once in GameConfig.system.renderer. The SDK supports four options:
| Mode | Module | What it renders |
|---|---|---|
| Pixi-only | PixiRendererModule | A 2D game using PixiJS |
| Three-only | ThreeRendererModule | A 3D game using Three.js |
| Three + Pixi | HybridRendererModule | A 3D world with a Pixi UI overlay |
| Pixi + Three-as-texture | PixiThreeTextureRendererModule | A Pixi game with 3D inside a sprite texture |
For example, select Three for a new project:
import { ThreeRendererModule } from '@gamedevland/engine/renderers/three';
// Inside GameConfig:
system: { renderer: new ThreeRendererModule() },
The module registers rendering and standard node types. Scenes, FSMs, commands and asset loading use shared APIs. Switching renderers during the game is not supported.
For Pixi, install pixi.js; for Three, install three and @types/three. Both combined options need all three packages. Install the SDK without a version suffix: npm install @gamedevland/engine @gamedevland/vite.
The next four lessons cover each mode separately. Then we will load a GLB and set the update order for the camera, world and UI.