# XWUIGameTestingScene

A 3D scene backdrop used to preview game UI against a realistic render. It builds a procedural Three.js scene from a `sceneId` template (e.g. `char_back_world`, `char_front_idle`, `char_over_shoulder_combat`) and exposes a separate overlay layer via `getOverlay()` so HUD/UI elements can be mounted on top of the 3D view. Use it standalone or as the backdrop inside `XWUIGameTesterGame`: switch templates at runtime with `setScene(sceneId)` and choose continuous vs. on-demand rendering with the `continuous` config flag.

## Basic Usage

Mounts the scene with defaults, so it renders the `char_back_world` template in continuous mode behind an empty overlay layer ready for HUD elements.

```example
file: examples/BasicUsage.ts
html: examples/BasicUsage.html
title: Basic Usage
description: The default char_back_world 3D scene rendering continuously with an empty HUD overlay on top.
```

## Combat Backdrop

An over-the-shoulder combat template with a health-bar HUD mounted on the overlay layer via `getOverlay()`.

```example
file: examples/CombatBackdrop.ts
html: examples/CombatBackdrop.html
title: Combat Backdrop
description: The char_over_shoulder_combat scene with a simple HP HUD appended to the overlay layer.
```

## On-Demand World Map

The overhead world-map template rendered on demand (`continuous: false`) to avoid a constant render loop on static backdrops.

```example
file: examples/OnDemandWorldMap.ts
html: examples/OnDemandWorldMap.html
title: On-Demand World Map
description: The world_map_overhead scene with continuous rendering disabled to save GPU cycles.
```

```api
```