👩‍💻 Joueur

Les joueurs sont des entités qui représentent la personne derrière le clavier et la souris. Les joueurs apparaissent automatiquement lorsqu'ils se connectent au serveur.

👪Inheritance

This class shares methods and events from Base Entity.

🧑‍💻API Source

This page is auto-generated! The Functions, Properties and Events described here are defined in our GitHub's API Repository! Feel free to commit suggestions and changes to the source .json API files!

---

Autorité

🟥 Vous ne pouvez pas faire apparaître ou détruire des joueurs.

🎒 Examples

-- Spawns and possess a Character when a Player joins the server
Player.Subscribe("Spawn", function(player)
	local new_char = Character(Vector(), Rotator(), "nanos-world::SK_Male")
	player:Possess(new_char)
end)

-- Destroys the Character when the Player leaves the server
Player.Subscribe("Destroy", function(player)
	local character = player:GetControlledCharacter()
	if (character) then
		character:Destroy()
	end
end)

🗿 Static Functions

Inherited Entity Static Functions

Player inherits from Base Entity Class, sharing it's methods and functions:
Base Entityscripting-reference/classes/base-classes/entity

	Returns	Name	Description
	table of Base Entity	GetAll	Returns a table containing all Entities of the class this is called on
	Base Entity	GetByIndex	Returns a specific Entity of this class at an index
	integer	GetCount	Returns how many Entities of this class exist
	table of table	GetInheritedClasses	Gets a list of all directly inherited classes from this Class created with the Inheriting System
	iterator	GetPairs	Returns an iterator with all Entities of this class to be used with pairs()
	table or nil	GetParentClass	Gets the parent class if this Class was created with the Inheriting System
	table	Inherit	Inherits this class with the Inheriting System
	boolean	IsChildOf	Gets if this Class is child of another class if this Class was created with the Inheriting System
	function	Subscribe	Subscribes to an Event for all entities of this Class
	function	SubscribeRemote	Subscribes to a custom event called from server
		Unsubscribe	Unsubscribes all callbacks from this Event in this Class within this Package, or only the callback passed

This class doesn't have own static functions.

🦠 Functions

Inherited Entity Functions

Player inherits from Base Entity Class, sharing it's methods and functions:
Base Entityscripting-reference/classes/base-classes/entity

	Returns	Name	Description
		BroadcastRemoteEvent	Calls a custom remote event directly on this entity to all Players
		BroadcastRemoteInRadiusEvent	Appelle un événement distant personnalisé directement sur cette entité pour tous les Joueurs dans un rayon donné
		CallRemoteEvent	Calls a custom remote event directly on this entity to a specific Player
		CallRemoteEvent	Calls a custom remote event directly on this entity
		CallRemotePlayersEvent	Appelle un événement distant personnalisé directement sur cette entité pour une liste de Joueurs
		Destroy	Destroys this Entity
		FinishSpawn	Terminez le processus d'apparition et envoyez l'entité aux clients si elle a été créée avec defer_spawn
	table of string	GetAllValuesKeys	Gets a list of all values keys
	table	GetClass	Gets the class of this entity
	integer	GetID	Gets the universal network ID of this Entity (same on both client and server)
	any	GetValue	Gets a Value stored on this Entity at the given key
	boolean	HasAuthority	Gets if this Entity was spawned by the client side
	boolean	IsA	Recursively checks if this entity is inherited from a Class
	boolean	IsBeingDestroyed	Returns true if this Entity is being destroyed
	boolean	IsValid	Returns true if this Entity is valid (i.e. wasn't destroyed and points to a valid Entity)
		SetValue	Sets a Value in this Entity
	function	Subscribe	Subscribes to an Event on this specific entity
	function	SubscribeRemote	Subscribes to a custom event called from server on this specific entity
		Unsubscribe	Unsubscribes all callbacks from this Event in this Entity within this Package, or only the callback passed

	Returns	Name	Description
		AttachCameraTo	Attache la caméra du Joueur à un Acteur
		Ban	Bannit le joueur du serveur
		Connect	Redirige le joueur vers un autre serveur
	string	GetAccountIconURL	Renvoie une URL utilisable dans l'interface Web (WebUI) et les widgets pour afficher l'avatar Steam du joueur (64x64)
	string	GetAccountID	No description provided
	string	GetAccountName	No description provided
	float	GetCameraArmLength	No description provided
	Vector	GetCameraLocation	No description provided
	Rotator	GetCameraRotation	No description provided
	Base Pawn or nil	GetControlledCharacter	No description provided
	integer	GetDimension	Récupère la dimension du joueur
	string	GetIP	No description provided
	string	GetName	No description provided
	integer	GetPing	No description provided
	string	GetSteamID	No description provided
	table of integer	GetVOIPListeningChannels	Renvoie la liste des canaux VOIP écoutés par le joueur
	table of integer	GetVOIPSpeakingChannels	Renvoie la liste des canaux VOIP dans lesquels le joueur parle actuellement
	boolean	IsHost	No description provided
	boolean	IsLocalPlayer	No description provided
	boolean	IsVOIPMuted	Renvoie si la VOIP est coupée pour ce joueur
		Kick	Expulse le joueur du serveur
		Possess	Permet à un joueur de posséder et de contrôler un Pawn (Pion/Personnage)
		ResetCamera	Réinitialise la caméra à son état par défaut (arrête le mode spectateur et la détache)
		RotateCameraTo	Déplace de manière fluide la rotation de la caméra du joueur
		SetCameraArmLength	Sets the Player's Camera Arm Length (Spring Arm length)
		SetCameraFOV	Sets the Player's Camera FOV (if not possessing a Character)
		SetCameraLocation	Sets the Player's Camera Location (only works if not possessing any Character)
		SetCameraRotation	Sets the Player's Camera Rotation
		SetCameraSocketOffset	Sets the Player's Camera Socket Offset (Spring Arm Offset)
		SetCameraSpeedSettings	Sets the Player's Camera Speed Settings (if not possessing a Character)
		SetDimension	Définit la dimension du joueur
		SetManualCameraFade	Turns on camera fading at the given opacity
		SetName	Sets the player's name
		SetVOIPGlobalAllChannelsSetting	Sets the VOIP setting for all global channels
		SetVOIPGlobalChannelSetting	Sets the VOIP setting for a specific global channel
		SetVOIPGlobalHighPassFilter	Sets the global VOIP high-pass filter threshold frequency
		SetVOIPGlobalLowPassFilter	Sets the global VOIP low-pass filter threshold frequency
		SetVOIPGlobalVolume	Sets the global VOIP volume. It only affects the global channels
		SetVOIPLocalMaxDistance	Sets the local/proximity VOIP max distance. This also affects networking usage
		SetVOIPLocalSetting	Sets the VOIP setting for the local/proximity
		SetVOIPLocalVolume	Sets the local/proximity VOIP input/output volume. It only affects the local/proximity channel
		SetVOIPMuted	Mutes or unmutes VOIP for this player
		Spectate	Spectates other Player
		StartCameraFade	Does a camera fade to/from a solid color
		StopCameraFade	Stops camera fading.
		TranslateCameraTo	Smoothly moves the Player's Camera Location (only works if not possessing any Character)
		UnPossess	Release the Player from the Character

---

AttachCameraTo

Attache la caméra du Joueur à un Acteur

my_player:AttachCameraTo(actor, socket_offset?, blend_speed?)

Parameters

Type	Parameter	Default	Description
Base Actor	actor	Required parameter	No description provided
Vector	socket_offset?	Vector(0, 0, 0)	No description provided
float	blend_speed?	0.0	No description provided

---

Ban

Bannit le joueur du serveur

my_player:Ban(reason)

Parameters

Type	Parameter	Default	Description
string	reason	Required parameter	No description provided

---

Connect

Redirige le joueur vers un autre serveur

my_player:Connect(IP, password?)

Parameters

Type	Parameter	Default	Description
string	IP	Required parameter	No description provided
string	password?		Mot de passe du serveur

---

GetAccountIconURL

Renvoie une URL utilisable dans l'interface Web (WebUI) et les widgets pour afficher l'avatar Steam du joueur (64x64)

local account_icon_url = my_player:GetAccountIconURL()

Returns

Type	Description
string	account_icon_url

---

GetAccountID

local account_id = my_player:GetAccountID()

Returns

Type	Description
string	account_id

---

GetAccountName

local account_name = my_player:GetAccountName()

Returns

Type	Description
string	account_name

---

GetCameraArmLength

local length = my_player:GetCameraArmLength(return_base?)

Parameters

Type	Parameter	Default	Description
boolean	return_base?	false	Indique s'il faut renvoyer la valeur actuelle (false) ou de base (true). La valeur de base correspond à celle définie par SetCameraArmLength(). Utilisez la valeur de base si vous souhaitez obtenir la valeur d'origine définie par SetCameraArmLength() et non la valeur actuelle (interpolée).

Returns

Type	Description
float	length

See also SetCameraArmLength.

---

GetCameraLocation

local location = my_player:GetCameraLocation()

Returns

Type	Description
Vector	location

See also SetCameraLocation.

---

GetCameraRotation

local rotation = my_player:GetCameraRotation()

Returns

Type	Description
Rotator	rotation

See also SetCameraRotation.

---

GetControlledCharacter

local controlled_character = my_player:GetControlledCharacter()

Returns

Type	Description
Base Pawn or nil	controlled_character

---

GetDimension

Récupère la dimension du joueur

local dimension = my_player:GetDimension()

Returns

Type	Description
integer	dimension

See also SetDimension, DimensionChange.

---

GetIP

local ip = my_player:GetIP()

Returns

Type	Description
string	ip

---

GetName

local player_name = my_player:GetName()

Returns

Type	Description
string	player_name

See also SetName.

---

GetPing

local ping = my_player:GetPing()

Returns

Type	Description
integer	ping

---

GetSteamID

local steam_id = my_player:GetSteamID()

Returns

Type	Description
string	steam_id

---

GetVOIPListeningChannels

Renvoie la liste des canaux VOIP écoutés par le joueur

local ret = my_player:GetVOIPListeningChannels()

Returns

Type	Description
table of integer	liste des index de canaux

---

GetVOIPSpeakingChannels

Renvoie la liste des canaux VOIP dans lesquels le joueur parle actuellement

local ret = my_player:GetVOIPSpeakingChannels()

Returns

Type	Description
table of integer	liste des index de canaux

---

IsHost

local is_host = my_player:IsHost()

Returns

Type	Description
boolean	is_host

---

IsLocalPlayer

local is_local_player = my_player:IsLocalPlayer()

Returns

Type	Description
boolean	is_local_player

---

IsVOIPMuted

Renvoie si la VOIP est coupée pour ce joueur

local ret = my_player:IsVOIPMuted()

Returns

Type	Description
boolean	No description provided

See also SetVOIPMuted.

---

Kick

Expulse le joueur du serveur

my_player:Kick(reason)

Parameters

Type	Parameter	Default	Description
string	reason	Required parameter	No description provided

---

Possess

Permet à un joueur de posséder et de contrôler un Pawn (Pion/Personnage)

my_player:Possess(new_pawn, blend_time?, exp?)

Parameters

Type	Parameter	Default	Description
Base Pawn	new_pawn	Required parameter	No description provided
float	blend_time?	0	No description provided
float	exp?	0	No description provided

---

ResetCamera

Réinitialise la caméra à son état par défaut (arrête le mode spectateur et la détache)

my_player:ResetCamera()

---

RotateCameraTo

Déplace de manière fluide la rotation de la caméra du joueur

my_player:RotateCameraTo(rotation, time, exp?)

Parameters

Type	Parameter	Default	Description
Rotator	rotation	Required parameter	No description provided
float	time	Required parameter	No description provided
float	exp?	0	Exponential used to smooth interp, use 0 for linear movement

---

SetCameraArmLength

Sets the Player's Camera Arm Length (Spring Arm length)

my_player:SetCameraArmLength(length, force?)

Parameters

Type	Parameter	Default	Description
float	length	Required parameter	No description provided
boolean	force?	false	Whether to bypass interpolation and set the target to its value directly

See also GetCameraArmLength.

---

SetCameraFOV

Sets the Player's Camera FOV (if not possessing a Character)

my_player:SetCameraFOV(fov?)

Parameters

Type	Parameter	Default	Description
float	fov?	90	Value must be between 5 and 170. Pass empty to reset to default.

---

SetCameraLocation

Sets the Player's Camera Location (only works if not possessing any Character)

my_player:SetCameraLocation(location)

Parameters

Type	Parameter	Default	Description
Vector	location	Required parameter	No description provided

See also GetCameraLocation.

---

SetCameraRotation

Sets the Player's Camera Rotation

my_player:SetCameraRotation(rotation)

Parameters

Type	Parameter	Default	Description
Rotator	rotation	Required parameter	No description provided

See also GetCameraRotation.

---

SetCameraSocketOffset

Sets the Player's Camera Socket Offset (Spring Arm Offset)

my_player:SetCameraSocketOffset(socket_offset)

Parameters

Type	Parameter	Default	Description
Vector	socket_offset	Required parameter	No description provided

---

SetCameraSpeedSettings

Sets the Player's Camera Speed Settings (if not possessing a Character)

my_player:SetCameraSpeedSettings(max_speed?, acceleration?, deceleration?, turning_boost?)

Parameters

Type	Parameter	Default	Description
float	max_speed?	1200	Maximum velocity magnitude allowed
float	acceleration?	4000	Acceleration applied by input (rate of change of velocity)
float	deceleration?	4000	Deceleration applied when there is no input (rate of change of velocity)
float	turning_boost?	8	Setting affecting extra force applied when changing direction, making turns have less drift and become more responsive. Velocity magnitude is not allowed to increase, that only happens due to normal acceleration. It may decrease with large direction changes. Larger values apply extra force to reach the target direction more quickly, while a zero value disables any extra turn force.

---

SetDimension

Définit la dimension du joueur

my_player:SetDimension(dimension)

Parameters

Type	Parameter	Default	Description
integer	dimension	Required parameter	No description provided

See also GetDimension, DimensionChange.

---

SetManualCameraFade

Turns on camera fading at the given opacity. Does not auto-animate, allowing user to animate themselves. Call StopCameraFade to turn fading back off.

my_player:SetManualCameraFade(in_fade_amount, color, in_fade_audio)

Parameters

Type	Parameter	Default	Description
float	in_fade_amount	Required parameter	Range [0..1], where 0 is fully transparent and 1 is fully opaque solid color.
Color	color	Required parameter	No description provided
boolean	in_fade_audio	Required parameter	No description provided

---

SetName

Sets the player's name

my_player:SetName(player_name)

Parameters

Type	Parameter	Default	Description
string	player_name	Required parameter	No description provided

See also GetName.

---

SetVOIPGlobalAllChannelsSetting

Sets the VOIP setting for all global channels

my_player:SetVOIPGlobalAllChannelsSetting(setting)

Parameters

Type	Parameter	Default	Description
VOIPSetting	setting	Required parameter	No description provided

See also SetVOIPGlobalChannelSetting, GetVOIPListeningChannels, GetVOIPSpeakingChannels, VOIPGlobalChannelSettingChange.

---

SetVOIPGlobalChannelSetting

Sets the VOIP setting for a specific global channel

my_player:SetVOIPGlobalChannelSetting(channel, setting)

Parameters

Type	Parameter	Default	Description
integer	channel	Required parameter	0-63
VOIPSetting	setting	Required parameter	No description provided

See also SetVOIPGlobalAllChannelsSetting, GetVOIPListeningChannels, GetVOIPSpeakingChannels, VOIPGlobalChannelSettingChange.

---

SetVOIPGlobalHighPassFilter

Sets the global VOIP high-pass filter threshold frequency. Set it to 0 to disable it

my_player:SetVOIPGlobalHighPassFilter(threshold)

Parameters

Type	Parameter	Default	Description
integer	threshold	Required parameter	No description provided

See also SetVOIPGlobalLowPassFilter.

---

SetVOIPGlobalLowPassFilter

Sets the global VOIP low-pass filter threshold frequency. Set it to 0 to disable it

my_player:SetVOIPGlobalLowPassFilter(threshold)

Parameters

Type	Parameter	Default	Description
integer	threshold	Required parameter	No description provided

See also SetVOIPGlobalHighPassFilter.

---

SetVOIPGlobalVolume

Sets the global VOIP volume. It only affects the global channels

my_player:SetVOIPGlobalVolume(volume)

Parameters

Type	Parameter	Default	Description
float	volume	Required parameter	No description provided

---

SetVOIPLocalMaxDistance

Sets the local/proximity VOIP max distance. This also affects networking usage

my_player:SetVOIPLocalMaxDistance(max_distance)

Parameters

Type	Parameter	Default	Description
integer	max_distance	Required parameter	Falloff Distance. Default is 3600

See also SetVOIPLocalSetting, SetVOIPLocalVolume.

---

SetVOIPLocalSetting

Sets the VOIP setting for the local/proximity

my_player:SetVOIPLocalSetting(setting)

Parameters

Type	Parameter	Default	Description
VOIPSetting	setting	Required parameter	No description provided

See also SetVOIPLocalMaxDistance, SetVOIPLocalVolume, VOIPLocalSettingChange.

---

SetVOIPLocalVolume

Sets the local/proximity VOIP input/output volume. It only affects the local/proximity channel

my_player:SetVOIPLocalVolume(volume)

Parameters

Type	Parameter	Default	Description
float	volume	Required parameter	No description provided

See also SetVOIPLocalSetting, SetVOIPLocalMaxDistance, VOIPLocalSettingChange.

---

SetVOIPMuted

Mutes or unmutes VOIP for this player

my_player:SetVOIPMuted(is_muted)

Parameters

Type	Parameter	Default	Description
boolean	is_muted	Required parameter	No description provided

See also IsVOIPMuted.

---

Spectate

Spectates other Player

my_player:Spectate(player, blend_speed?)

Parameters

Type	Parameter	Default	Description
Player	player	Required parameter	No description provided
float	blend_speed?	0	No description provided

---

StartCameraFade

Does a camera fade to/from a solid color. Animates automatically

my_player:StartCameraFade(from_alpha, to_alpha, duration, to_color, should_fade_audio?, hold_when_finished?)

Parameters

Type	Parameter	Default	Description
float	from_alpha	Required parameter	Alpha at which to begin the fade. Range [0..1], where 0 is fully transparent and 1 is fully opaque solid color.
float	to_alpha	Required parameter	Alpha at which to finish the fade.
float	duration	Required parameter	How long the fade should take, in seconds.
Color	to_color	Required parameter	Color to fade to/from.
boolean	should_fade_audio?		True to fade audio volume along with the alpha of the solid color.
boolean	hold_when_finished?		True for fade to hold at the ToAlpha until explicitly stopped (e.g. with StopCameraFade)

---

StopCameraFade

Stops camera fading.

my_player:StopCameraFade()

---

TranslateCameraTo

Smoothly moves the Player's Camera Location (only works if not possessing any Character)

my_player:TranslateCameraTo(location, time, exp?)

Parameters

Type	Parameter	Default	Description
Vector	location	Required parameter	No description provided
float	time	Required parameter	No description provided
float	exp?	0	Exponential used to smooth interp, use 0 for linear movement

---

UnPossess

Release the Player from the Character

my_player:UnPossess()

🚀 Events

Inherited Entity Events

Player inherits from Base Entity Class, sharing it's events:
Base Entityscripting-reference/classes/base-classes/entity

	Name	Description
	ClassRegister	Triggered when a new Class is registered with the Inheriting System
	Destroy	Triggered when an Entity is destroyed
	Spawn	Triggered when an Entity is spawned/created
	ValueChange	Triggered when an Entity has a value changed with :SetValue()

	Name	Description
	DimensionChange	Triggered when a Player changes it's dimension
	Possess	Triggered when Player starts controlling a Pawn (Character)
	Ready	Triggered when Player is ready (the client fully joined, loaded the map and all entities and is ready to play)
	UnPossess	A Pawn (Character) was unpossessed from the Player
	VOIP	Déclenché lorsqu'un joueur commence ou arrête d'utiliser la VOIP
	VOIPGlobalChannelSettingChange	Déclenché lorsque le paramètre d'un canal VOIP global change pour ce joueur
	VOIPLocalSettingChange	Déclenché lorsque le paramètre de la VOIP locale change pour ce joueur

---

DimensionChange

Triggered when a Player changes it's dimension

Player.Subscribe("DimensionChange", function(self, old_dimension, new_dimension)
	-- DimensionChange was called
end)

Arguments

Type	Argument	Description
Player	self	No description provided
integer	old_dimension	No description provided
integer	new_dimension	No description provided

See also SetDimension, GetDimension.

---

Possess

Triggered when Player starts controlling a Pawn (Character)

Player.Subscribe("Possess", function(self, pawn)
	-- Possess was called
end)

Arguments

Type	Argument	Description
Player	self	No description provided
Base Pawn	pawn	No description provided

See also GetControlledCharacter.

---

Ready

Triggered when Player is ready (the client fully joined, loaded the map and all entities and is ready to play)

Player.Subscribe("Ready", function(self)
	-- Ready was called
end)

Arguments

Type	Argument	Description
Player	self	No description provided

---

UnPossess

A Pawn (Character) was unpossessed from the Player

Player.Subscribe("UnPossess", function(self, pawn)
	-- UnPossess was called
end)

Arguments

Type	Argument	Description
Player	self	No description provided
Base Pawn	pawn	No description provided

See also GetControlledCharacter.

---

VOIP

Déclenché lorsqu'un joueur commence ou arrête d'utiliser la VOIP

Si is_talking est true, renvoyer false pour bloquer ce flux vocal (bloqué pour tous sur le serveur, uniquement en local sur le client)

Player.Subscribe("VOIP", function(self, is_talking)
	-- VOIP was called
	return true
end)

Arguments

Type	Argument	Description
Player	self	No description provided
boolean	is_talking	No description provided

---

VOIPGlobalChannelSettingChange

Déclenché lorsque le paramètre d'un canal VOIP global change pour ce joueur

Player.Subscribe("VOIPGlobalChannelSettingChange", function(self, channel, old_setting, new_setting)
	-- VOIPGlobalChannelSettingChange was called
end)

Arguments

Type	Argument	Description
Player	self	No description provided
integer	channel	No description provided
VOIPSetting	old_setting	No description provided
VOIPSetting	new_setting	No description provided

See also SetVOIPGlobalChannelSetting, SetVOIPGlobalAllChannelsSetting.

---

VOIPLocalSettingChange

Déclenché lorsque le paramètre de la VOIP locale change pour ce joueur

Player.Subscribe("VOIPLocalSettingChange", function(self, old_setting, new_setting)
	-- VOIPLocalSettingChange was called
end)

Arguments

Type	Argument	Description
Player	self	No description provided
VOIPSetting	old_setting	No description provided
VOIPSetting	new_setting	No description provided

See also SetVOIPLocalSetting.