VRChat API

API

Classes

• Utilities
• VRCStation
• Networking
• TrackingData
• UdonBehaviour
• VRCPlayerApi
• UdonInputEventArgs
• VRCUrl
• VRCUrlInputField
• VRCMirrorReflection
• VRCObjectPool
• VRCObjectSync

Enums

• EventTiming
• Mobility
• NetworkEventTarget
• SpawnOrientation
• TrackingDataType
• VRCInputMethod
• HandType
• UdonInputEventType
• VideoError
• AutoHoldMode
• PickupOrientation
• PickupHand

Supported Features

• Synced Variables

---

Classes

Utilities

class VRC.SDKBase.Utilities

Methods

Returns	Name	Summary
bool	IsValid(object obj)	Returns true is the specified object is valid and not a null reference, otherwise false. This is typically used to check VRCPlayerApi objects after a player has left the instance, or GameObject objects that have been destroyed.

VRCStation

class VRC.SDKBase.VRCStation

Properties

Type	Name	Summary
Mobility	PlayerMobility	Determines if the player be able to move. Default value is VRCStation.Mobility.Immobilize.
bool	canUseStationFromStation	Determines if the user can switch stations when sitting in a station. Default value is true.
RuntimeAnimatorController	animatorController	Used to override normal seating animations with a custom one.
bool	disableStationExit	If the user cannot exit the station by usual means, use triggers to unseat the user
bool	seated	Is this a station that the user should be sitting in? Default value is true. See here for more information.
Transform	stationEnterPlayerLocation	Transform used to define where the user should be transported to when seated
Transform	stationExitPlayerLocation	Transform used to define where the user should be transported to when they are unseated

Methods

Returns	Name	Summary
void	UseStation(VRCPlayerApi player)	Uses the station
void	ExitStation(VRCPlayerApi player)	Exits the station

Networking

class VRC.SDKBase.Networking

Properties

Type	Name	Summary
bool	isMaster	Returns if the local player is the instance master
VRCPlayerApi	LocalPlayer	Returns the current player

Methods

Returns	Name	Summary
bool	IsOwner(VRCPlayerApi player, GameObject obj)	Returns if the given player is the owner over the object
bool	IsOwner(GameObject obj)	Returns if the local player is the owner of the object
VRCPlayerApi	GetOwner(GameObject obj)	Returns the over of the given object
void	SetOwner(VRCPlayerApi player, GameObject obj)	Sets the provided player as the owner of the object
bool	IsObjectReady(GameObject obj)	Returns if the object is ready
void	Destroy(GameObject obj)	Destroys the given object
string	GetUniqueName(GameObject obj)
DateTime	GetNetworkDateTime()
double	GetServerTimeInSeconds()	Returns the current server time in seconds.
int	GetServerTimeInMilliseconds()	Returns the current server time in milliseconds.
double	CalculateServerDeltaTime(double timeInSeconds, double previousTimeInSeconds)	Calculates the difference between two server time stamps as returned by GetServerTimeInSeconds().

TrackingData

struct VRC.SDKBase.VRCPlayerApi.TrackingData

Properties

Type	Name	Summary
Vector3	position	The position of the player's tracking point
Quaternion	rotation	The rotation of the player's tracking point

UdonBehaviour

class VRC.Udon.UdonBehaviour

A UdonBehaviour can be fetched with GetComponent.
Currently does not support GetComponent<T>()

UdonBehaviour behaviour = (UdonBehaviour)GetComponent(typeof(UdonBehaviour));

Methods

Returns	Name	Summary
void	SendCustomEvent(string eventName)	Runs a public method on the behaviour
void	SendCustomNetworkEvent(NetworkEventTarget target, string eventName)	Runs a public method over the network
void	SendCustomEventDelayed(string eventName, float delaySeconds, EventTiming eventTiming)	Runs a public method on the behaviour with a time delay
void	SendCustomEventDelayed(string eventName, int delayFrames, EventTiming eventTiming)	Runs a public method on the behaviour with a frame delay
object	GetProgramVariable(string symbolName)	Get a variable from the behaviour
void	SetProgramVariable(string symbolName, object value)	Sets a variable on the behaviour
Type	GetProgramVariableType(string symbolName)	Retrieves the type of the specified variable from the behaviour.
void	RequestSerialization()	Triggers the serialization and transmission of any synced variable data to remote clients. This is typically used when a behaviour is set to manual syncing mode.

VRCPlayerApi

class VRC.SDKBase.VRCPlayerApi

Properties

Type	Name	Summary
bool	isLocal	Returns if the given player is the local or remote
string	displayName	Returns the players display name
bool	isMaster	Returns if the player is the instance Master
int	playerId	Returns the players instance id

Methods

Returns	Name	Summary
bool	IsPlayerGrounded()	Returns if the player is on the ground or not
int	GetPlayerId(VRCPlayerApi player)	Returns the players instance id
VRCPlayerApi	GetPlayerById(int playerId)	Returns the player with the given id
int	GetPlayerCount()	Returns the player count for the instance
VRCPlayerApi[]	GetPlayers(VRCPlayerApi[] players)	Populates and returns an array with the current players in the instance. The array parameter must be preallocated with at least VRCPlayerApi.GetPlayerCount elements. See example
bool	IsOwner(GameObject obj)	Shows if the player is the owner of a gameObject with a UdonBehaviour on it
TrackingData	GetTrackingData(TrackingDataType tt)	Returns the tracking data for the specified type
Vector3	GetBonePosition(HumanBodyBones bone)	Return position data for the given bone
Quaternion	GetBoneRotation(HumanBodyBones bone)	Return rotation data for the given bone
void	TeleportTo(Vector3 teleportPos, Quaternion teleportRot)	Teleports the player to the position with rotation
void	TeleportTo(Vector3 teleportPos, Quaternion teleportRot, SpawnOrientation teleportOrientation)	Teleports the player to the position, rotation, and the spawn orientation
void	TeleportTo(Vector3 teleportPos, Quaternion teleportRot, SpawnOrientation teleportOrientation, bool lerpOnRemote)	Teleports the player to the position, rotation, the spawn orientation, and if you want to lerp on remote
void	EnablePickup(bool enable)	Set if the player can use pickups or not (Need Testing)
void	SetPlayerTag(string tagName, string tagValue)	Assigns a value to the tag for the player. Returns null if the tag has not been assigned.
string	GetPlayerTag(string tagName)	Returns the value of the given tag for the player. Assign a value of null to clear the tag.
void	ClearPlayerTags()	Clears the tags on the given player
void	SetRunSpeed(float speed)	Sets the player run speed
void	SetWalkSpeed(float speed)	Sets the players walk speed
void	SetJumpImpulse(float impulse)	Sets players jump impulse
void	SetGravityStrength(float strength)	Sets the players gravity
void	SetStrafeSpeed(float speed)	Sets the player's strafe speed. The default strafe speed is 2.0f.
float	GetRunSpeed()	Returns the current run speed value
float	GetWalkSpeed()	Returns the current walk speed value
float	GetJumpImpulse()	Returns the current jump impulse value
float	GetGravityStrength()	Returns the current gravity value
float	GetStrafeSpeed()	Returns the player's current strafe speed.
bool	IsUserInVR()	Returns if the current user is in VR
void	UseLegacyLocomotion()	Sets the locomotion to the old system
void	Immobilize(bool immobile)	Prevents user from moving
void	UseAttachedStation()	Sits the players down on the station (Requires VRC_Station on the same gameObject)
void	SetVelocity(Vector3 velocity)	Sets the players velocity
Vector3	GetVelocity()	Returns the player velocity
Vector3	GetPosition()	Returns the player position
Quaternion	GetRotation()	Returns the player rotation
void	SetVoiceGain(float gain)	Add boost to the Player's voice in decibels, range 0-24
void	SetVoiceDistanceNear(float near)	The near radius, in meters, where volume begins to fall off. It is strongly recommended to leave the Near value at zero for realism and effective spatialization for user voices. In Meters, Range 0 - 1,000,000
void	SetVoiceDistanceFar(float far)	This sets the end of the range for hearing the user's voice. Default is 25 meters. You can lower this to make another player's voice not travel as far, all the way to 0 to effectively 'mute' the player. In Meters, Range is 0 - 1,000,000
void	SetVoiceVolumetricRadius(float radius)	A player's voice is normally simulated to be a point source, however changing this value allows the source to appear to come from a larger area. Keep this at zero unless you know what you're doing. In Meters, Range is 0 -1,000. Default 0
void	SetVoiceLowpass(bool enabled)	When a voice is some distance off, it is passed through a low-pass filter to help with understanding noisy worlds. You can disable this if you want to skip this filter. For example, if you intend for a player to use their voice channel to play a high-quality DJ mix, turning this filter off is advisable.
void	SetAvatarAudioGain(float gain)	Set the Maximum Gain allowed on Avatar Audio. Default is 10. In Decibels, Range 0-10
void	SetAvatarAudioNearRadius(float distance)	This sets the maximum start of the range for hearing the avatar's audio. Default is 40 meters. You can lower this to make another player's avatar not travel as far, all the way to 0 to effectively 'mute' the player. Note that this is compared to the audio source's minDistance, and the smaller value is used.
void	SetAvatarAudioFarRadius(float distance)	This sets the maximum end of the range for hearing the avatar's audio. Default is 40 meters. You can lower this to make another player's avatar not travel as far, all the way to 0 to effectively 'mute' the player. Note that this is compared to the audio source's maxDistance, and the smaller value is used.
void	SetAvatarAudioVolumetricRadius(float radius)	An avatar's audio source is normally simulated to be a point source, however changing this value allows the source to appear to come from a larger area. This should be used carefully, and is mainly for distant audio sources that need to sound "large" as you move past them. Default is 40
void	SetAvatarAudioForceSpatial(bool force)	If this is on, then Spatialization is enabled for avatar audio sources, and the spatialBlend is set to 1. Enabling this prevents avatars from using 2D audio.
void	SetAvatarAudioCustomCurve(bool allow)	This sets whether avatar audio sources can use a pre-configured custom curve.

InputManager

class VRC.SDKBase.InputManager

Methods

Returns	Name	Summary
bool	IsUsingHandController()	Returns whether or not the user is using a hand controller.
VRCInputMethod	GetLastUsedInputMethod()	Returns the last input method used, or VRCInputMethod.Count if no input method was found.
void	EnableObjectHighlight(GameObject obj, bool enable)	Enables or disables object highlighting for the specified object.
void	EnableObjectHighlight(Renderer r, bool enable)	Enables or disables object highlighting for the specified renderer.

UdonInputEventArgs

struct VRC.Udon.Common.UdonInputEventArgs

Provides contextual data for an input event.

Properties

Type	Name	Summary
UdonInputEventType	eventType	The type of input event that was fired.
bool	boolValue	The value of the input method when an InputJump, InputUse, InputGrab or InputDrop event is fired.
float	floatValue	The value of the input method when an InputMoveHorizontal, InputMoveVertical, InputLookHorizontal or InputLookVertical event is fired.
HandType	handType	The hand that the input event occurred on. For desktop users, the keyboard is the left hand and the mouse is the right hand.

VRCUrl

class VRC.SDKBase.VRCUrl

VRCUrl objects currently cannot be constructed at runtime in Udon and are typically constructed at editor time via editor scripts, or retrieved from a VRCUrlInputField.

Constructor

Name	Summary
VRCUrl(string url)	Constructor that takes a URL as input.

Properties

Type	Name	Summary
VRCUrl	Empty	An empty URL.

Methods

Returns	Name	Summary
string	Get()	Retrieves the current value of the URL.

VRCUrlInputField

class VRC.SDK3.Components.VRCUrlInputField

A UI component for end users to input a custom URL and output to Udon programs as a VRCUrl.

Methods

Returns	Name	Summary
VRCUrl	GetUrl()	Retrieves the current value of the input field.
void	SetUrl(VRCUrl url)	Sets the URL displayed in the input field.

VRCMirrorReflection

class VRC.SDK3.Components.VRCMirrorReflection

class VRC.SDKBase.VRC_MirrorReflection

A component that manages a mirror surface on an object.

Properties

Type	Name	Summary
bool	m_DisablePixelLights	Disables real-time pixel shaded point and spot lighting. Pixel shaded lights will fall-back to vertex lighting when this is enabled.
bool	TurnOffMirrorOcclusion	Disables occlusion culling on the mirror. Enable this if you see objects flickering in the mirror.
LayerMask	m_ReflectLayers	Only objects on the selected layers will be rendered in the mirror. Objects on the Water layer are never rendered in mirrors.

VRCObjectPool

class VRC.SDK3.Components.VRCObjectPool

VRC Object Pool provides a lightweight method of managing an array of game objects. The pool will manage and synchronize the active state of each object it holds.

Objects are made active by the pool via the TryToSpawn node, which will return the object that was made active, or a null object if none are available. Objects may be returned to the pool by the pool's owner, and automatically disabled, via the Return node.

When objects are enabled by the pool the OnSpawn event is fired, which an udon behaviour on the object may listen for.

Late joiners will have the objects automatically made active or inactive where appropriate.

Properties

Type	Name	Summary
GameObject[]	Pool	The objects being managed by this object pool.

Methods

Returns	Name	Summary
GameObject	TryToSpawn()	Returns an unused object from the object pool where available, otherwise returns null.
void	Return(GameObject obj)	Places the specified object back into the pool, freeing it up for future reuse.

VRCObjectSync

class VRC.SDK3.Components.VRCObjectSync

This component will automatically sync the Transform (position, rotation scale) and Rigidbody (physics) of the object you put it on.

Properties

Type	Name	Summary
bool	AllowCollisionOwnershipTransfer	Should ownership of object transfer if it collides with an object owned by another player.

Methods

Returns	Name	Summary
void	SetKinematic(bool value)	Changes the kinematic state, usually handled by the Rigidbody of the object but controlled here for sync purposes. When the kinematic state is on, this Rigidbody ignores forces, collisions and joints.
void	SetGravity(bool value)	Changes the gravity state, usually handled by the Rigidbody of the object but controlled here for sync purposes.
void	FlagDiscontinuity()	Trigger this when you want to teleport the object - the changes you make this frame will be applied without smoothing.
void	TeleportTo(Transform targetLocation)	Moves the object to the specified location.
void	Respawn()	Moves the object back to its original spawn location.

Enums

EventTiming

enum VRC.Udon.Common.Enums.EventTiming

Name	Summary
Update	Updates the current delay of the event

Mobility

enum VRC.SDKBase.VRCStation.Mobility

Name	Summary
Mobile	Allow users to move when seated in station
Immobilize	Prevents user from moving
ImmobilizeForVehicle	Same as Immobilized but optimized for moving stations

NetworkEventTarget

enum VRC.Udon.Common.Interfaces.NetworkEventTarget

Name	Summary
All	All players in the instance
Owner	Owner of the game object

SpawnOrientation

enum VRC.SDKBase.VRC_SceneDescriptor.SpawnOrientation

Name	Summary
Default	Use the VRChat default spawn behaviour (currently the same as AlignPlayerWithSpawnPoint)
AlignPlayerWithSpawnPoint	Aligns player with the rotation of the spawn transform
AlignRoomWithSpawnPoint	Aligns players room scale to be centered on spawn point

TrackingDataType

enum VRC.SDKBase.VRCPlayerApi.TrackingDataType

Name	Summary
Head	The player's head tracking data
LeftHand	The player's left hand tracking data
RightHand	The player's right hand tracking data

VRCInputMethod

enum VRC.SDKBase.VRCInputMethod

Name	Value	Summary
Keyboard	0	Keyboard input method
Mouse	1	Mouse input method
Controller	2	Controller input method
Gaze	3	Gaze input method
Vive	5	Vive input method
Oculus	6	Oculus input method
Count	7	Maximum number of input methods available.

HandType

enum VRC.Udon.Common.HandType

Name	Summary
RIGHT	Right hand
LEFT	Left hand

UdonInputEventType

enum VRC.Udon.Common.UdonInputEventType

Name	Summary
BUTTON	Button event
AXIS	Axis event

VideoError

enum VRC.SDK3.Components.Video.VideoError

Name	Summary
Unknown	Unknown error
InvalidURL	Invalid URL
AccessDenied	Access Denied
PlayerError	Player Error
RateLimited	Rate Limited

AutoHoldMode

enum VRC.SDKBase.VRC_Pickup.AutoHoldMode

Name	Summary
AutoDetect	Automatically detect which behaviour to apply.
Yes	After the grab button is released the pickup remains in the hand until the drop button is pressed and released.
No	After the grab button is released the pickup is let go.

PickupOrientation

enum VRC.SDKBase.VRC_Pickup.PickupOrientation

Name	Summary
Any	Any orientation
Grip	Grip orientation
Gun	Gun orientation

PickupHand

enum VRC.SDKBase.VRC_Pickup.PickupHand

Name	Summary
None	No hand
Left	Left hand
Right	Right hand

Supported Features

Synced Variables

These are the variables that are listed as available for syncing across the network. Note that partial support exists for byte, sbyte, short, ushort, and ulong, but are currently bugged and may not give you the results you expect.

		Variables
Color	Color32	Quaternion	Vector2	Vector3
Vector4	bool	char	double	float
int	long	string	uint	VRCUrl