NetworkPlayer

Immutable record that associates a NetworkUser (identity) with a NetworkClient (Netcode connection). Provides a unified view of a connected player's identity, client ID, and player object.

Definition

Namespace: Paragon.Core.Network Assembly: Paragon.dll

public record NetworkPlayer

Remarks

NetworkPlayer bridges the gap between the authentication/identity layer (NetworkUser — user ID and display name) and the Netcode transport layer (NetworkClient — client ID and player object). It is used by the NetworkSession to track connected players.

As a C# record, it provides:

• Value equality based on field values

• Immutability — fields are readonly and set only via the constructor

• Built-in ToString() — returns "User: [UserID] UserName, Client: ClientID"

Quick Lookup

Goal	How
Get user identity	player.User or player.UserID / player.UserName
Get Netcode client ID	player.ClientID
Get the player's NetworkObject	player.PlayerObject
Get the underlying NetworkClient	player.Client

Properties

User

The NetworkUser record representing the player's authenticated identity.

public NetworkUser User { get; }

Client

The Netcode NetworkClient representing the player's connection.

public NetworkClient Client { get; }

UserID

The player's unique user identifier. Shortcut to User.ID.

public string UserID { get; }

UserName

The player's display name. Shortcut to User.Name.

public string UserName { get; }

ClientID

The player's Netcode client ID. Shortcut to Client.ClientId.

public ulong ClientID { get; }

PlayerObject

The NetworkObject associated with this player's connection (the player's owned network object).

public NetworkObject PlayerObject { get; }

Methods

Constructor

public NetworkPlayer(NetworkUser user, NetworkClient client)

Parameter	Type	Description
user	NetworkUser	The authenticated user identity
client	NetworkClient	The Netcode client connection

ToString

Returns a formatted string with user and client info.

public override string ToString()

Returns: "User: [UserID] UserName, Client: ClientID"

Examples

Creating a NetworkPlayer

var user = new NetworkUser(userId, displayName);
var client = NetworkManager.API.ConnectedClients[clientId];
var player = new NetworkPlayer(user, client);

Debug.Log(player); // "User: [abc123] PlayerOne, Client: 1"

Iterating Session Players

foreach (NetworkPlayer player in session.Players)
{
    Debug.Log($"{player.UserName} (Client {player.ClientID})");

    // Access the player's network object
    NetworkObject playerObj = player.PlayerObject;
}

See Also

• ConnectionData — serialized user identity sent during connection

• NetworkManager — the network system entry point