Develop

Guardian Blueprints

Updated: Apr 15, 2026
Reference guide for the Guardian Blueprints available through UOculusXRFunctionLibrary in the OculusXRHMD module of the Meta XR Plugin.
Legacy guidance: The Guardian Blueprint API is a legacy interface. Four of the seven functions listed below have been deprecated since UE 4.27 and are non-functional on the current OpenXR code path: Get Node Guardian Intersection, Get Point Guardian Intersection, Is Guardian Displayed, and Set Guardian Visibility.
For boundary visibility control, use the Boundary API documented at Boundaryless.
The three non-deprecated functions (Get Guardian Dimensions, Get Guardian Points, and Get Play Area Transform) remain available in the Meta XR Plugin.
  • Get Guardian Dimensions Returns the dimensions of the Outer Boundary or the Play Area, expressed in Unreal Engine units.
  • Get Guardian Points Returns the points, in Unreal Engine world space, that define the Outer Boundary or the Play Area.
  • Get Node Guardian Intersection (Deprecated) Returns the intersection result between a tracked device (HMD or Controller) and the Guardian boundary. Deprecated since UE 4.27; non-functional on the OpenXR code path.
  • Get Play Area Transform Returns the transform of the Play Area rectangle, defining its position, rotation, and scale to apply a unit cube to match it with the Play Area.
  • Get Point Guardian Intersection (Deprecated) Returns the intersection result between the Guardian boundary and a specified Unreal Engine coordinate. Deprecated since UE 4.27; non-functional on the OpenXR code path.
  • Is Guardian Displayed (Deprecated) Returns a boolean result that indicates whether the Outer Boundary Guardian is being displayed. Deprecated since UE 4.27; non-functional on the OpenXR code path.
  • Set Guardian Visibility (Deprecated) Specifies whether the runtime should render the Guardian. Deprecated since UE 4.27; non-functional on the OpenXR code path.