Skip to content

Type Alias: WorldOptions

WorldOptions = object

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

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:72

Asset manifest to preload before the first frame.


features?

optional features: object

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

Opt‑in feature systems.

grabbing?

optional grabbing: boolean

Grabbing (one/two‑hand, distance).

Default Value
ts
false

locomotion?

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

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

Default Value
ts
false

physics?

optional physics: boolean

Physics simulation (Havok).

Default Value
ts
false

sceneUnderstanding?

optional sceneUnderstanding: boolean

Scene Understanding (planes/meshes/anchors).

Default Value
ts
false

spatialUI?

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

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

Default Value
ts
true

level?

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

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

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:81

Renderer & camera configuration.

defaultLighting?

optional defaultLighting: boolean

Generate a default gradient environment and background.

Default Value
ts
true

far?

optional far: number

Far clipping plane.

Default Value
ts
200

fov?

optional fov: number

Camera field of view in degrees.

Default Value
ts
50

near?

optional near: number

Near clipping plane.

Default Value
ts
0.1

xr?

optional xr: XROptions & object

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

XR session options and offer behavior.

Type Declaration

offer?

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