Type Alias: WorldOptions

WorldOptions = object

Defined in: packages/core/src/init/world-initializer.ts:76

Options for initializeWorld / World.create.

Remarks

Defaults are tuned for VR; you can override camera frustum and default lighting via WorldOptions.render.

Properties

assets?

optional assets: AssetManifest

Defined in: packages/core/src/init/world-initializer.ts:78

Asset manifest to preload before the first frame.

---

features?

optional features: object

Defined in: packages/core/src/init/world-initializer.ts:101

Opt‑in feature systems.

camera?

optional camera: boolean

Camera access for video streaming.

Default Value

false

environmentRaycast?

optional environmentRaycast: boolean

Environment Raycast (hit-test against real-world surfaces).

Default Value

false

grabbing?

optional grabbing: boolean | { useHandPinchForGrab?: boolean; }

Grabbing (one/two‑hand, distance).

Default Value

false

locomotion?

optional locomotion: boolean | { useWorker?: boolean; }

Locomotion (teleport/slide/turn). Boolean or config.

Default Value

false

physics?

optional physics: boolean

Physics simulation (Havok).

Default Value

false

sceneUnderstanding?

optional sceneUnderstanding: boolean | { showWireFrame?: boolean; }

Scene Understanding (planes/meshes/anchors). Boolean or config.

Default Value

false

spatialUI?

optional spatialUI: boolean | { forwardHtmlEvents?: boolean; kits?: Record<string, unknown>[] | Record<string, unknown>; preferredColorScheme?: ColorScheme; }

Spatial UI systems (PanelUI/ScreenSpace/Follow). Boolean or config.

Default Value

true

---

level?

optional level: { url?: string; } | string

Defined in: packages/core/src/init/world-initializer.ts:81

Level to load after initialization. Accepts a GLXF URL string or an object with a url field.

---

render?

optional render: object

Defined in: packages/core/src/init/world-initializer.ts:87

Renderer & camera configuration.

defaultLighting?

optional defaultLighting: boolean

Generate a default gradient environment and background.

Default Value

true

far?

optional far: number

Far clipping plane.

Default Value

200

fov?

optional fov: number

Camera field of view in degrees.

Default Value

50

near?

optional near: number

Near clipping plane.

Default Value

0.1

stencil?

optional stencil: boolean

Enable stencil buffer.

Default Value

false

---

xr?

optional xr: XROptions & object

Defined in: packages/core/src/init/world-initializer.ts:84

XR session options and offer behavior.

Type Declaration

offer?

optional offer: "none" | "once" | "always"