Renderer selection01 / 7

Four rendering modes

Choose how PixiJS and Three.js render the game.

Select rendering once in GameConfig.system.renderer. The SDK supports four options:

ModeModuleWhat it renders
Pixi-onlyPixiRendererModuleA 2D game using PixiJS
Three-onlyThreeRendererModuleA 3D game using Three.js
Three + PixiHybridRendererModuleA 3D world with a Pixi UI overlay
Pixi + Three-as-texturePixiThreeTextureRendererModuleA 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.