API

Interface XrControllerModelOptions

interface XrControllerModelOptions {
    meshFactory?: XrControllerMeshFactory;
    profiles?: boolean | XrMotionControllerProfileOptions;
}
Index

Custom per-controller mesh builder. Defaults to a generic handle box tinted by handedness. Also used as the placeholder while a profiles model loads.

Load real per-hand GLB motion-controller models from the WebXR Input Profiles registry (Babylon.js CONTROLLER_MODEL_LOADING) and animate buttons / trigger / thumbstick from live gamepad state. true uses the default jsDelivr CDN; pass an object to override the base URL. The handle box shows as a placeholder until a source's model resolves. Adds a network dependency + the glTF loader to the bundle (dynamic-imported on demand), so it stays fully opt-in.