HomeGuides
Guides

Getting Players

These nodes are useful for getting an individual Player, a group of them, or all of them.

Networking.get LocalPlayer

VRCPlayerApi

📘

Please note that this function is a member of the Networking class, but it is being included here.

The local player is the Player that this Udon script is currently running on-- alternately, the local player is you. It's very important to know yourself!

GetPlayerCount

int
Gets the actual number of Players in the instance when it is called.

GetPlayers

VRCPlayerApi[]
This is how you get all the Players in your world so you can go through them in a For Loop and apply settings, make changes, look for a particular name, etc. To use it, you first need to create a VRCPlayerApi Array. Here is a unitypackage with a working example.

612

The bare minimum for a working call to GetPlayers. A better approach would be to construct VRCPlayerApi[] as a variable so you can reuse it.

GetPlayerById

int
Get a VRCPlayerApi object for the given player Id if it exists.

get playerId

int
Get the cached PlayerId, calls GetPlayerId if it hasn't been cached yet.

GetPlayerId

int
Gets the Player's Network Id from the source.

Player Tag System

This system is a quick-and-dirty way of assigning strings to players without creating your own variables and collections.

SetPlayerTag / GetPlayerTag

Set: string, string
Get: string
Sets a string variable that you can look up later. For example, you could set the "role" of a player in a cooking game to "chef" or "customer". Then you could GetPlayerTag for "role" and get back either "chef" or "customer".

ClearPlayerTags

VRCPlayerApi
Remove all tags that you've set on a Player.

GetPlayersWithTag

NEEDS A FIX
Not currently working as it returns a list. Will fix and update. You will be able to pass in an array of VRCPlayerApi objects and a tag and the method will fill the array with Players who have that tag set.

The following methods are deprecated - they do not work in SDK3 and will be removed in the future:

SetSilencedToTagged

SetSilencedToUntagged

ClearSilence