ThreeRendererModule03 / 7

Three-only: 3D-сцена

Создадим куб и камеру в JSON.

Для 3D-игры без Pixi-интерфейса выберем ThreeRendererModule из @gamedevland/engine/renderers/three. Установим библиотеку командой npm install three, а типы — npm install --save-dev @types/three. PixiJS этому режиму не нужен.

В GameConfig зададим system.renderer: new ThreeRendererModule(). В layout сцены создадим куб и камеру:

{
  "world": {
    "type": "Group",
    "children": {
      "cube": {
        "type": "Mesh",
        "props": {
          "geometry": { "type": "box" },
          "material": { "type": "basic", "color": "#40aacc" }
        }
      },
      "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
        }
      }
    }
  }
}

В SceneConfig.render укажем { camera: 'world.camera' }. basic показывает цвет без освещения; для материала standard добавим свет.

GroupОбъединяет Three-узлы
Камераworld.camera → один canvas

Положение и масштаб задаются векторами { x, y, z }, повороты — в радианах. Ось Y направлена вверх, плоскость земли — XZ; единица расстояния — метр. Только Group принимает дочерние узлы в JSON.

Компонент объявляет nodeType = ThreeNode или ThreeGroup и меняет объект через this.node.view. node.input находит ближайший видимый интерактивный узел лучом от камеры. Попадание в часть GLB относится к узлу Model, которому она принадлежит.