HybridRendererModule04 / 7

Three + Pixi: world and UI

Place a Pixi UI over a 3D world.

When the game world is 3D but buttons and counters are easier to build in PixiJS, select HybridRendererModule from @gamedevland/engine/renderers/hybrid. Install three, pixi.js and @types/three.

Set system.renderer: new HybridRendererModule() in GameConfig. Define two separate roots in one layout:

{
  "world": {
    "type": "Group",
    "children": {
      "camera": {
        "type": "PerspectiveCamera",
        "props": {
          "position": { "x": 0, "y": 2, "z": 5 },
          "lookAt": { "x": 0, "y": 0, "z": 0 },
          "near": 0.1, "far": 100, "fov": 50
        }
      }
    }
  },
  "ui": {
    "type": "Container",
    "children": { "score": { "type": "Text", "props": { "text": "0" } } }
  }
}

Set SceneConfig.render to { camera: 'world.camera' }. Add game objects to world and interface elements to ui.

Upper canvas · PixiTransparent UI, checked first
Lower canvas · Three3D world, receives input when the UI is not hit
One update loop serves both canvases.

The SDK combines them in one logical layout while keeping separate render trees. Group accepts Three children; Container accepts Pixi children. A Pixi text node cannot be placed inside a Three group. The camera moves the world while UI coordinates remain two-dimensional.