Develop

Get Guardian Points

Updated: Apr 15, 2026

This Blueprint returns an array of FVector points defining the outer boundary or the play area.

Overview

This Blueprint retrieves an array of FVector values, where each entry in the array represents either:

An outer boundary point for the Guardian area.

One of the four points defining the play area (a rectangle within the outer boundary).

By default, these points are returned in world space (not tracking space), aligned with the other objects in your virtual world. Set Use Pawn Space to true to return points in pawn space instead.

This Blueprint is only meaningful when positional tracking is available, such as when the headset provides 6DOF (six degrees of freedom) support. It works on both Meta Quest standalone and PC-VR configurations.

The C++ equivalent of this Blueprint is UOculusXRFunctionLibrary::GetGuardianPoints, declared in OculusXRFunctionLibrary.h under the Blueprint category OculusLibrary|Guardian.

Blueprint

Arguments

Boundary Type: An EOculusXRBoundaryType enum value representing the type of boundary that is requested. You may set this value to:

EOculusXRBoundaryType::Boundary_Outer (“Outer Boundary”): The exact bounds of the Guardian area.

EOculusXRBoundaryType::Boundary_PlayArea (“Play Area”): A rectangle within the outer boundary.

Use Pawn Space (bool, default: false): Determines whether to return points in pawn space (true) or world space (false).

Output

If Play Area is selected: An array of FVector values containing four points that define the play area, a rectangle within the outer boundary, expressed in world or pawn space coordinates.

If Outer Boundary is selected: An array of FVector values containing all the points that define the outer boundary, expressed in world or pawn space coordinates.

Note: On the OpenXR backend, only Boundary_PlayArea is supported. Passing Boundary_Outer returns an empty array. The Use Pawn Space parameter is also not used on the OpenXR backend.