VR Expansion Plugin Documentation

4.1.VR Base Character

VR Base Character Actor is a new character class that is heavily modified to work in VR. It automatically populates with two GripControllers, a ParentRelativeAttachment, a ReplicatedVRCamera and a VRBaseCharacterMovementComponent.

The Base Character exists so that the VRCharacter and SimpleVRCharacter classes can share implementations of features without copying code. It also allows generally for casting to BaseCharacter and/or re-parenting between VRCharacter and SimpleVRCharacter.

DO NOT Directly use VRBaseCharacter for your pawn! Use one of its subclasses

How do I use it?

  • Create a VRCharacter or SimpleVRCharacter, they will have all of the properties and abilities of the VRBaseCharacter.


FVRSeatedCharacterInfo SeatInformation

Contains the calibration settings and current state of the seated mode.


Event OnSeatedModeChanged
Triggered when seating mode has activated or de-activated

Event OnSeatThreshholdChanged
Triggered when the seated mode is active and the player either moves into / out of the threshold or the threshold scaler changes.

FVRSeatThresholdChangedSignature OnSeatThreshholdChanged_Bind
Same as above but bindable to so that other actors can act on it.

Event OnCustomMoveActionPerformed
Called just prior to ticking the movement when a moveaction is performed. Here to handle custom move actions.

Event OnBeginWallPushback
Called when pushback against a wall starts.

Event OnEndWallPushback
Called when pushback against a wall ends.

Event ReceiveNavigationMoveCompleted
Called when a navigation process ends.

Event OnClimbingStepup
Called when a climbing step up has been performed (if bUseClimbingStepUp is true)


Sets the seated mode to on/off. When sitting TargetLoc/Rot is the camera relative location/rotation, when standing TargetLoc/Rot is the location to teleport to / rotation to face.

bZeroToHead means the head should be the focal point, if false the seated mode runs from the feet instead and vertical movement is not taken into account.

Zeros the seated mode to the passed in new relative loc/rot.

Adds delta rotation to the VRCharacter using the camera as the pivot point.

Sets the actor rotation from the cameras location

Sets the actor rotation and location from the cameras location.

Same as setting capsule height but regenerates the world position.

Same as setting the capsule half height but regenerates the world position

Gets the position to teleport to when given a target location (will offset by HMD if VRCharacter, won’t if SimpleVRCharacter). This is off of 0 on the actor when normally teleport locations in engine are off of HalfHeight of the characters capsule. However all of my VR characters work off of the actors 0,0,0 location being the floor / foot location.

Gets the location of the “VR” character, since it is offset from the actors root location. This value includes the half capsule height offset that characters normally have.

Gets the forward vector for the VR characters facing

Suggest Edit