Skip to main content

Player API

You can interact with Players in your world through the VRCPlayerApi. Each Player has a VRCPlayerApi Object, and your world fires the OnPlayerJoined / OnPlayerLeft events on any UdonBehaviours that listen for them when a player joins or leaves.

This page includes info on using some general nodes. Since there are so many things you can do with the VRCPlayerApi object, we've grouped some node info together on the following pages:

Generally Useful Nodes

IsValid

VRCPlayerApi, Boolean

Before you try to get or set anything on a Player, check whether IsValid returns true. If a player has left since you saved a reference to them, this will return False. For easier use on the graph, search for the generic "IsValid" method which works for any Object, since it gives you separate flows for True and False. index-59fc2c8-player-isvalid.png

EnablePickups

VRCPlayerApi, Boolean

Turn off the Player's ability to pickup and use VRCPickup objects in the world. This property is on by default, so you only need to use the method if you want to turn it off.

get displayName

VRCPlayerApi

Get the name displayed for the Player (can be different than Username, which is used to log into VRChat and not exposed publicly)

Get isLocal

in: VRCPlayerApi

out: Boolean

Tells you whether the given Player is the local one.

Get isMaster

in: VRCPlayerApi

out: Boolean

Tells you whether the given Player is the Master player. This is the player who either created the instance, or the one who inherited Master status when the last Master left.

GetPickupInHand

in: VRCPlayerApi, Hand (none, left, right)

out: VRCPickup

Gets the pickup a Player is holding in the specified hand. Only works for the Local Player. Returns null if no VRCPickup is found.

IsOwner

in: VRCPlayerApi, GameObject

out: Boolean

Tells you whether a Player is the Owner of a given GameObject, important for Sync.

IsUserInVR

in: VRCPlayerApi

out: Boolean

Tells you whether a Player is using a VR headset.

PlayHapticEventInHand

VRCPlayerApi, Hand, float, float, float

Vibrate the Player's Haptic controllers if they have them. The float inputs should be in the range 0-1. duration is the amount of time that they vibrate, amplitude is the strength with which they vibrate, and frequency is the speed at which they vibrate. The feeling can vary quite a bit between controllers.

UseAttachedStation

VRCPlayerApi

Makes the player get into the Station which is on the same GameObject as this UdonBehaviour.

SimulationTime

float

The simulation time of a player.

UseLegacyLocomotion

VRCPlayerApi

NOT RECOMMENDED - turns on legacy locomotion for this player.

Combat System

The following nodes are Under Review - not working, not recommended for use. We're evaluating their usefulness and they should be ignored for now:

  • CombatGetCurrentHitpoints
  • CombatGetDestructible
  • CombatSetCurrentHitpoints
  • CombatSetDamageGraphic
  • CombatSetMaxHitpoints
  • CombatSetRespawn
  • CombatSetup

Language

note

Switching Languages is not yet ready in the VRChat client, these methods will return example data until the full feature is launched. They will currently throw an exception when testing in ClientSim, as well.

GetCurrentLanguage

string

Gets the selected language of the local user.

GetAvailableLanguages

string[]

Gets all available languages a player can select.