Player

La edad de la cuenta es una propiedad de Player que describe cuánto tiempo ha estado registrado una cuenta de jugador en días. Se establece con la función Player:SetAccountAge(), que no se puede acceder a ella por scripts.

Esta propiedad es útil para mostrar condicionalmente el contenido de los jugadores de Roblox, como tutoriales.

local Players = game:GetService("Players")

local MAX_AGE_NEW_PLAYER = 7 -- one week
local MIN_AGE_VETERAN = 365 -- one year

-- This function marks a part with text using a BillboardGui
local function mark(part, text)
	local bbgui = Instance.new("BillboardGui")
	bbgui.AlwaysOnTop = true
	bbgui.StudsOffsetWorldSpace = Vector3.new(0, 2, 0)
	bbgui.Size = UDim2.new(0, 200, 0, 50)
	local textLabel = Instance.new("TextLabel")
	textLabel.Size = UDim2.new(1, 0, 1, 0) -- Fill parent
	textLabel.Text = text
	textLabel.TextColor3 = Color3.new(1, 1, 1)
	textLabel.TextStrokeTransparency = 0
	textLabel.BackgroundTransparency = 1
	textLabel.Parent = bbgui
	-- Add to part
	bbgui.Parent = part
	bbgui.Adornee = part
end

local function onPlayerSpawned(player, character)
	local head = character:WaitForChild("Head")
	if player.AccountAge >= MIN_AGE_VETERAN then
		mark(head, "Veteran Player")
	elseif player.AccountAge <= MAX_AGE_NEW_PLAYER then
		mark(head, "New Player")
	else
		mark(head, "Regular Player")
	end
end

local function onPlayerAdded(player)
	-- Listen for this player spawning
	if player.Character then
		onPlayerSpawned(player, player.Character)
	end
	player.CharacterAdded:Connect(function()
		onPlayerSpawned(player, player.Character)
	end)
end

Players.PlayerAdded:Connect(onPlayerAdded)

La propiedad AutoJumpEnabled determina si el Player.Character de un Class.Player usando un dispositivo móvil saltará automáticamente cuando chocan con un obstáculo. Esto puede hacer que los niveles sean más navegables mientras están en un dispositivo móvil.

Cuando el jugador se une al juego, el valor StarterPlayer.AutoJumpEnabled determina el estado inicial de esta propiedad. Luego, esta propiedad determina el valor de la propiedad Humanoid.AutoJumpEnabled de la propiedad Player.Character en el regeneración. En otras palabras, es posible establecer el comport

local Players = game:GetService("Players")

local player = Players.LocalPlayer
local button = script.Parent

local function update()
	-- Update button text
	if player.AutoJumpEnabled then
		button.Text = "Auto-Jump is ON"
	else
		button.Text = "Auto-Jump is OFF"
	end
	-- Reflect the property in the player's character, if they have one
	if player.Character then
		local human = player.Character:FindFirstChild("Humanoid")
		if human then
			human.AutoJumpEnabled = player.AutoJumpEnabled
		end
	end
end

local function onActivated()
	-- Toggle auto-jump
	player.AutoJumpEnabled = not player.AutoJumpEnabled
	-- Update everything else
	update()
end

button.Activated:Connect(onActivated)
update()

La propiedad CameraMaxZoomDistance Player establece la distancia máxima en studs de la cámara puede estar del personaje con las cámaras predeterminadas.

En otras palabras, controla la distancia máxima que la cámara del jugador está autorizada a acercar.

El valor predeterminado de esta propiedad se establece por StarterPlayer.CameraMaxZoomDistance . Si este valor se establece para un valor inferior a Player.CameraMinZoomDistance , se aumentará a CameraMinZoomDistance.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75

La propiedad CameraMinZoonDistance Player establece la distancia mínima en studs de la cámara que puede estar del personaje con las cámaras predeterminadas.

En otras palabras, controla la distancia mínima que la cámara del jugador está autorizada a acercar.

El valor predeterminado de esta propiedad se establece por StarterPlayer.CameraMinZoomDistance . Si este valor se establece para un valor superior a Player.CameraMaxZoomDistance se reducirá a CameraMaxZoomDistance.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75

La propiedad Modo de cámara establece el modo de cámara del jugador, por defecto a la tercera persona.

Tercera Persona

En el modo de tercera persona por defecto ( Enum.CameraMode.Classic ) se puede ver el personaje en la cámara. Mientras que en este modo, el comportamiento predeterminado es:

• Los jugadores pueden hacer clic con el botón derecho y arrastrar (ratón), tocar y arrastrar (móvil), usar el joystick secundario (controlador para juego), o presionar las flechas izquierda/derecha (teclado) para girar la cámara alrededor de su personaje.
• Cuando un jugador mueve su personaje, se enfrenta en la dirección de movimiento correspondiente.
• Los jugadores pueden acercar y alejar de forma gratuita, incluso a la primera persona en full zoom en.

Primera Persona

En el modo de primera persona ( Enum.CameraMode.LockFirstPerson ) la cámara del jugador está acercada todo el tiempo. A menos que haya una GUI visible con la propiedad GuiButton.Modal establecida a true , mover el ratón, tocar-arrastrar en el móvil o usar el joystick secundario en un gamepad girará la cámara alrededor del personaje.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CameraMode = Enum.CameraMode.LockFirstPerson

La propiedad CanLoadCharacterAppearance Player determina si la apariencia del personaje se carga cuando el jugador se genera. El valor predeterminado de esta propiedad es establecido por StarterPlayer.LoadPlayerAppearance .

Si true , el personaje cargará la apariencia del jugador que coincida con el jugador's Player.CharacterAppearanceId .

Si falso , el jugador aparecerá con un aspecto predeterminado - un modelo de personaje gris sin sombreros, camisas, pantalones, etc.

Intentar establecer la propiedad después de que el personaje se haya generado no cambiará el personaje, debe llamar a Player:LoadCharacter() para cargar la nueva aspecto, look.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CanLoadCharacterAppearance = false

La propiedad jugador contiene una referencia a un Model que contiene un Humanoid , partes del cuerpo, scripts y otros objetos requeridos para simular

Inicialmente esta propiedad es nil y se establece cuando el personaje del jugador se genera por primera vez. Usa el evento Player.CharacterAdded para detectar cuando se carga correctamente el personaje del jugador, y el evento Player.CharacterRemoving para detectar cuando el personaje está a punto de desaparecer. Evita usar 1>

Nota que LocalScripts que se clonan de StarterGui o StarterPack

local Players = game:GetService("Players")
local player = Players.LocalPlayer

local character = player.Character
if not character or character.Parent == nil then
	character = player.CharacterAdded:Wait()
end

Esta propiedad determina el ID de usuario de la cuenta cuyo personaje aparece en el juego para el personaje de un jugador. Por defecto, esta propiedad es el Player.Character, que usa el avatar del jugador como se creó en el sitio web de Roblox.

Cambiar esta propiedad a el ID de usuario de otra cuenta hará que el jugador aparezca con la apariencia de esa cuenta (sombreros, camisas, pantalones, etc).

Los juegos también pueden alternar si la apariencia del personaje de un jugador se carga en el juego al cambiar la propiedad StarterPlayer.LoadCharacterAppearance .

local Players = game:GetService("Players")

local disguiseCommand = "/disguise "

local function onPlayerChatted(player, message)
	if message:sub(1, disguiseCommand:len()):lower() == disguiseCommand:lower() then
		local input = message:sub(disguiseCommand:len() + 1)
		local id = tonumber(input)
		if not id then -- Number failed to parse, maybe they typed a username instead
			pcall(function() -- This call can fail sometimes!
				id = Players:GetUserIdFromNameAsync(input) -- Fetch ID from name
			end)
		end
		if id then
			-- Set character appearance then respawn
			player.CharacterAppearanceId = id
			player:LoadCharacter()
		else
			-- We couldn't get an ID from their input
		end
	end
end

local function onPlayerAdded(player)
	player.Chatted:Connect(function(...)
		onPlayerChatted(player, ...)
	end)
end

Players.PlayerAdded:Connect(onPlayerAdded)

Define cómo los scripts de cámara predeterminados manejan los objetos entre la cámara y el sujeto de la cámara. Establecido por StarterPlayer.DevCameraOcclusionMode y no se puede cambiar para los jugadores individuales.

El valor predeterminado es Zoom (0). Consulte Enum.DevCameraOcclusionMode para obtener una lista de los modos disponibles.

La propiedad DevComputerCameraMode determina la manera en que un jugador mueve su cámara cuando usa un dispositivo con un mouse y teclado. Vea Enum.DevComputerCameraMovementMode para una descripción de cada modo de control de cámara disponible. Esta propiedad no se puede configurar usando un LocalScript (debe establecerse en el servidor usando un Script).

El valor predeterminado de esta propiedad se determina por StarterPlayer.DevComputerCameraMovementMode .

La palabra "Computer" en este nombre de propiedad se refiere a dispositivos no- TouchEnabled , no- GamepadEnabled .

Cuando se establece a Selección de usuario , un jugador puede elegir entre cualquier modo de control (excepto Scriptable ) en la configuración del juego de Roblox. En general, es una buena idea permitir que los jugadores elijan su modo de control para maximizar la accesibilidad.

Es posible crear un esquema de control personalizado al establecer esta propiedad en Scriptable .

Esta propiedad no afecta a los jugadores que usan un dispositivo de toque habilitado. Vea Player.DevTouchCameraMode en su lugar.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Set the player's camera movement mode on computers to classic
player.DevComputerCameraMode = Enum.DevComputerCameraMovementMode.Classic

La propiedad DevComputerMovementMode determina la manera en que un jugador mueve su personaje cuando usa un dispositivo con un mouse y teclado. Vea Enum.DevComputerMovementMode para una descripción de cada modo de movimiento disponible. Esta propiedad no se puede configurar usando un LocalScript (debe establecerse en el servidor usando un Script).

El valor predeterminado de esta propiedad se determina por StarterPlayer.DevComputerMovementMode .

La palabra «Computer» en este nombre de propiedad se refiere a los dispositivos no TouchEnabled .

Cuando se establece a Selección de usuario , un jugador puede elegir entre cualquier modo de control (excepto Scriptable ) en la configuración del juego de Roblox. En general, es una buena idea permitir que los jugadores elijan su modo de control para maximizar la accesibilidad.

Es posible crear un esquema de control personalizado al establecer esta propiedad en Scriptable .

Esta propiedad no afecta a los jugadores que usan un dispositivo habilitado para tocar. Vea Player.DevTouchMovementMode en su lugar.

local Players = game:GetService("Players")

game.Players.PlayerAdded:Connect(function(player)
  -- Set the player's movement mode on mobile devices to a dynamic thumbstick
  player.DevComputerMovementMode = Enum.DevComputerMovementMode.DynamicThumbstick
end)

Esta propiedad determina si un jugador puede alternar el bloqueo de Mouse con la presión de Shift . Un jugador puede desactivar el interruptor de bloqueo del mouse en las configuraciones del juego de Roblox. Por defecto, esta propiedad está configurada como el valor de StarterPlayer.EnableMouseLockOption . Esto se

Cuando el bloqueo del mouse está habilitado, el cursor del jugador está bloqueado en el centro de la pantalla. Mover el mouse girará la cámara alrededor del jugador character , y el personaje se alineará con la dirección de la cámara camera . También desplaza la vista de la cámara justo sobre el hombro derecho del personaje.

Nota que las API relacionadas con el bloqueo de shift están en el proceso de ser desusar, en desuso (noun), por lo que se recomienda usar UserInputService.MouseBehavior en lugar de bloquear el ratón.

local Players = game:GetService("Players")

local function toggleMouseLock(player)
	player.DevEnableMouseLock = not player.DevEnableMouseLock
	if player.DevEnableMouseLock then
		print("Mouse lock is available")
	else
		print("Mouse lock is not available")
	end
end

local function onPlayerChatted(player, message, _recipient)
	if message == "mouselock" then
		toggleMouseLock(player)
	end
end

local function onPlayerAdded(player)
	player.Chatted:Connect(function(...)
		onPlayerChatted(player, ...)
	end)
end

Players.PlayerAdded:Connect(onPlayerAdded)

La propiedad DevTouchCameraMode determina la manera en que un jugador mueve su cámara cuando utiliza un dispositivo TouchEnabled . Consulte Enum.DevTouchCameraMovementMode para una descripción de cada modo de control de cámara disponible. Esta propiedad no se puede configurar utilizando un LocalScript (debe estable

El valor predeterminado de esta propiedad se determina por StarterPlayer.DevTouchCameraMovementMode .

Cuando se establece a Selección de usuario , un jugador puede elegir entre cualquier modo de control (excepto Scriptable ) en la configuración del juego de Roblox. En general, es una buena idea permitir que los jugadores elijan su modo de control para maximizar la accesibilidad.

Es posible crear un esquema de control personalizado al establecer esta propiedad en Scriptable .

Esta propiedad no afecta a los jugadores que no están usando un dispositivo habilitado para tocar. Vea Player.DevComputerCameraMovementMode en su lugar.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

-- Set the player's camera movement mode on mobile devices to classic
player.DevTouchCameraMovementMode = Enum.DevTouchCameraMovementMode.Classic

La propiedad DevTouchMovementMode determina la manera en que un jugador mueve su personaje cuando utiliza un dispositivo TouchEnabled. Vea Enum.DevTouchMovementMode para una descripción de cada modo de control de movimiento disponible. Esta propiedad no se puede configurar con un LocalScript (debe establecerse en el

El valor predeterminado de esta propiedad se determina por StarterPlayer.DevTouchMovementMode .

Cuando se establece a Selección de usuario , un jugador puede elegir entre cualquier modo de control (excepto Scriptable ) en la configuración del juego de Roblox. En general, es una buena idea permitir que los jugadores elijan su modo de control para maximizar la accesibilidad.

Es posible crear un esquema de control personalizado al establecer esta propiedad en Scriptable .

Esta propiedad no afecta a los jugadores que no estén usando un dispositivo habilitado para tocar. Vea Player.DevComputerMovementMode en su lugar.

local Players = game:GetService("Players")

game.Players.PlayerAdded:Connect(function(player)
    -- Set the player's movement mode on mobile devices to a dynamic thumbstick
    player.DevTouchMovementMode = Enum.DevTouchMovementMode.DynamicThumbstick
end)

El DisplayName es una propiedad de Player que contiene el nombre de la pantalla del usuario autenticado asociado con el objeto Player. A diferencia de los nombres de usuario, los nombres de pantalla son nombres no únicos que muestran los jugadores a otros. Si el usuario de Roblox no ha elegido uno, la propiedad leerá el mismo que la propiedad 2>Name

Nota:

• Dado que los nombres de los mostradores no son únicos, es posible que dos jugadores en una sola instancia tengan nombres idénticos. Si necesita un identificador globalmente único para un jugador, use Player.UserId (que es estático) o Player.Name (que es el nombre de usuario actual) en su lugar.
• Los personajes generados con Player.LoadCharacter o por el motor de Roblox tendrán su propiedad de Humanoid.DisplayName asignada a la propiedad de Player.DisplayName.
• Los nombres de los párametros pueden tener caracteres no deseados en la cadena. Consulte UTF-8 para obtener más información sobre cómo trabajar con cadenas con caracteres no deseados.

El FollowUserId es una propiedad de Player que contiene el Player.UserId del usuario que un jugador siguió en el juego. Si el jugador no siguió a nadie en el juego, esta propiedad será 0. Esta propiedad es útil para alertar a los jugadores que han sido seguidos por otro jugador en el juego.

Puedes obtener el nombre del jugador seguido usando este ID de usuario y la función Players:GetNameFromUserIdAsync().

local Players = game:GetService("Players")

local player = Players.LocalPlayer

local function onPlayerAdded(newPlayer)
	if newPlayer.FollowUserId == player.UserId then
		local hint = Instance.new("Hint")
		hint.Parent = player:WaitForChild("PlayerGui")
		hint.Text = "You were followed to this game by " .. newPlayer.Name .. "!"
		task.delay(3, function()
			if hint then
				hint:Destroy()
			end
		end)
	end
end

Players.PlayerAdded:Connect(onPlayerAdded)

La propiedad GameplayPaused indica si el jugador está actualmente en un estado de pausa en un lugar con StreamingEnabled activado. Se configura en el cliente, pero se replica al servidor. Para determinar el estado de pausa, puede utilizar esta propiedad.

Véase también:

• Workspace.StreamingEnabled que controla si se habilita o no la transmisión de contenido
• Workspace.StreamingIntegrityMode y Enum.StreamingIntegrityMode para más información sobre la interrupción del juego.

La propiedad de la insignia verificada Player indica si el jugador tiene una Emblema de verificación.

La propiedad HealthDisplayDistance Player establece la distancia en studs en los que este jugador verá otras barras de salud Humanoid . Si se establece a 0, las barras de salud no se mostrarán. Esta propiedad está predeterminada para establecer StarterPlayer.HealthDisplayDistance por defecto.

Si la barra de salud de un Humanoid es visible, puede establecer el tipo de visualización usando Humanoid.DisplayDistanceType .

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0

La propiedad LocaleId Player muestra el ID de la ubicación que el jugador local ha establecido para su cuenta Roblox. Contiene una cadena con el código de dos letras (por ejemplo, "en-us") para la ubicación.

Esto se puede usar para determinar el geógrafo demográfico de la base de jugadores de tu juego, y también es el idioma que se usará para la localización automática (ver GuiBase2d.AutoLocalize ) del contenido en la experiencia. Esta propiedad permite acceder al idioma del jugador desde el servidor.

También se ve LocalizationService.RobloxLocaleId, el ID de la ubicación usado para localizar el contenido interno. Este será un valor diferente cuando Roblox aún no soporte interna y localmente el idioma del jugador.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

print(player.LocaleId)

Esta propiedad solo se puede leer para determinar la membresía (no se puede establecer para otro introducirde membresía). Contiene un Enum.MembershipType枚 del introducirde membresía de la cuenta.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

if player.MembershipType == Enum.MembershipType.Premium then
	-- Take some action specifically for Premium members
end

La propiedad NameDisplayDistance StarterPlayer establece la distancia en studs en los que este jugador verá otros nombres Humanoid . Si la propiedad se establece a 0, los nombres están ocultos. Esta propiedad se establece por defecto a StarterPlayer.NameDisplayDistance por defecto.

Si la barra de salud de un Humanoid es visible, puede establecer el tipo de visualización usando Humanoid.DisplayDistanceType .

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0

La propiedad Neutral determina si el jugador está en un equipo específico.

• Cuando true , el jugador no está en un equipo específico. Esto también significa que la propiedad Player.Team será nulo y el color de la propiedad Player.TeamColor será blanco.
• Cuando falso , el jugador está en un equipo específico. La propiedad Player.Team corresponddrá a la Team que el jugador está en, así como la propiedad 1> Class.Player.TeamColor1> .

local Players = game:GetService("Players")

local player = Players.LocalPlayer

if player.Neutral then
	print("Player is neutral!")
else
	print("Player is not neutral!")
end

La propiedad ReplicationFocus Player establece la parte para enfocar la replicación alrededor de un jugador. Los diferentes sistemas de Roblox que se comunican a través de la red (como la física, la transmisión en vivo, etc) se replican a diferentes tasas dependiendo de la cercanía de los objetos al enfoque de replicación.

Cuando esta propiedad es nulo, se restablece a su comportamiento por defecto que es tratar el personaje del jugador local como el enfoque de replicación.

Esta propiedad solo se debe establecer en el servidor con un Script, no un LocalScript. Nota que esta propiedad no cambia o actualiza la propiedad de red de partes.

local Players = game:GetService("Players")

local PLAYER_NAME = "polarpanda16"

local player = Players:WaitForChild(PLAYER_NAME)

local part = Instance.new("Part")
part.Parent = workspace
part.Name = "ReplicationFocusPart"
part.Anchored = true
player.ReplicationFocus = part

Si se establece, el jugador reaparecerá en el SpawnLocation dado. Esta propiedad solo se puede establecer a través de Lua y debe contener una referencia a un SpawnLocation válido, que debe cumplir los siguientes criterios:

• Hijo de Workspace
• SpawnLocation.TeamColor está configurado como Player.TeamColor o SpawnLocation.Neutral

Si RespawnLocation no se ha establecido en un SpawnLocation válido, entonces la lógica de generación predeterminada se aplicará. Para obtener más información, consulte la página de SpawnLocation .

Alternativas a RespawnLocation

• Un Player se generará desde SpawnLocations que pertenecen a su equipo. En algunos casos, puede ser más sencillo cambiar el Player.Team del jugador en su lugar.
• Im implementa tu propia lógica de spawn personalizada usando PVInstance:PivotTo() para mover manualmente el Player.Character .

local Players = game:GetService("Players")

local function addSpawn(spawnLocation)
	-- listen for the spawn being touched
	spawnLocation.Touched:Connect(function(hit)
		local character = hit:FindFirstAncestorOfClass("Model")
		if character then
			local player = Players:GetPlayerFromCharacter(character)
			if player and player.RespawnLocation ~= spawnLocation then
				local humanoid = character:FindFirstChildOfClass("Humanoid")
				-- make sure the character isn't dead
				if humanoid and humanoid:GetState() ~= Enum.HumanoidStateType.Dead then
					print("spawn set")
					player.RespawnLocation = spawnLocation
				end
			end
		end
	end)
end

local firstSpawn

-- look through the workspace for spawns
for _, descendant in pairs(workspace:GetDescendants()) do
	if descendant:IsA("SpawnLocation") then
		if descendant.Name == "FirstSpawn" then
			firstSpawn = descendant
		end
		addSpawn(descendant)
	end
end

local function playerAdded(player)
	player.RespawnLocation = firstSpawn
end

-- listen for new players
Players.PlayerAdded:Connect(playerAdded)

-- go through existing players
for _, player in pairs(Players:GetPlayers()) do
	playerAdded(player)
end

La propiedad Equipo es una referencia a un objeto Team dentro del servicio Class.Teams

local Players = game:GetService("Players")
local Teams = game:GetService("Teams")

local teamPlaying = Teams.Playing
local teamSpectators = Teams.Spectating

local playCommand = "/play"

local function play(player)
	player.Team = teamPlaying
	player.TeamColor = teamPlaying.TeamColor
	-- Respawn the player (moves them to spawn location)
	player:LoadCharacter()
end

local function onPlayerDied(player, _character)
	-- When someone dies, put them on the spectator team
	player.Team = teamSpectators
end

local function onPlayerSpawned(player, character)
	local human = character:WaitForChild("Humanoid")
	human.Died:Connect(function()
		onPlayerDied(player, character)
	end)
end

local function onPlayerChatted(player, message)
	if message:sub(1, playCommand:len()):lower() == playCommand then
		play(player)
	end
end

local function onPlayerAdded(player)
	if player.Character then
		onPlayerSpawned(player, player.Character)
	end
	player.CharacterAdded:Connect(function()
		onPlayerSpawned(player, player.Character)
	end)
	player.Chatted:Connect(function(message, _recipient)
		onPlayerChatted(player, message)
	end)
end

for _, player in pairs(Players:GetPlayers()) do
	onPlayerAdded(player)
end
Players.PlayerAdded:Connect(onPlayerAdded)

local Players = game:GetService("Players")
local Teams = game:GetService("Teams")

-- Command to choose a team (note the trailing space)
local joinCommand = "/jointeam "

local function findTeamByName(name)
	-- First, check for the exact name of a team
	if Teams:FindFirstChild(name) then
		return Teams[name]
	end
	-- Let's check for case-insensitive partial matches, like "red" for "Red Robins"
	for _, team in pairs(Teams:GetChildren()) do
		if team.Name:sub(1, name:len()):lower() == name:lower() then
			return team
		end
	end
	-- If we get to this point, no team matched the one we were looking for :(
end

local function onPlayerChatted(player, message, _recipient)
	-- Note: string.sub(message, ...) is the same as message:sub(...)
	if message:sub(1, joinCommand:len()):lower() == joinCommand:lower() then
		-- Matched "/JOINTEAM xyz" to our join command prefix "/jointeam "
		local teamName = message:sub(joinCommand:len() + 1) -- Cut out the "xyz" from "/jointeam xyz"
		local team = findTeamByName(teamName)
		if team then
			-- Set the team!
			player.Team = team
			player.Neutral = false
		else
			-- Tell the player that team could not be found :(
			player.Team = nil
			player.Neutral = true
		end
	end
end

local function onPlayerAdded(player)
	player.Chatted:Connect(function(...)
		onPlayerChatted(player, ...)
	end)
end

Players.PlayerAdded:Connect(onPlayerAdded)

La propiedad TeamColor determina con qué equipo se asocia un jugador según el Class.Team.TeamColor de ese equipo. Al cambiar esta propiedad, cambiará Class.Player.Team según el equipo que tenga el mismo Datatype.BrickColor para su Class.Team.TeamColor . Si no hay un objeto de equipo que tenga el color de equipo asociado, el jugador no se asociará con un equipo.

A menudo es una mejor idea establecer Player.Team a los respectivos Team en lugar de usar esta propiedad. Establecer esta propiedad a menudo conduce a la repetición del mismo valor de color de ladrillo para un cierto equipo en muchos scripts; esto es algo que desea evitar cuando se adhiere al principio "No se repita a sí mismo" (DRY).

local Players = game:GetService("Players")
local Teams = game:GetService("Teams")

local teamPlaying = Teams.Playing
local teamSpectators = Teams.Spectating

local playCommand = "/play"

local function play(player)
	player.Team = teamPlaying
	player.TeamColor = teamPlaying.TeamColor
	-- Respawn the player (moves them to spawn location)
	player:LoadCharacter()
end

local function onPlayerDied(player, _character)
	-- When someone dies, put them on the spectator team
	player.Team = teamSpectators
end

local function onPlayerSpawned(player, character)
	local human = character:WaitForChild("Humanoid")
	human.Died:Connect(function()
		onPlayerDied(player, character)
	end)
end

local function onPlayerChatted(player, message)
	if message:sub(1, playCommand:len()):lower() == playCommand then
		play(player)
	end
end

local function onPlayerAdded(player)
	if player.Character then
		onPlayerSpawned(player, player.Character)
	end
	player.CharacterAdded:Connect(function()
		onPlayerSpawned(player, player.Character)
	end)
	player.Chatted:Connect(function(message, _recipient)
		onPlayerChatted(player, message)
	end)
end

for _, player in pairs(Players:GetPlayers()) do
	onPlayerAdded(player)
end
Players.PlayerAdded:Connect(onPlayerAdded)

El Id de Usuario es una propiedad de Player que contiene un número integro que únicamente y consistentemente identifica cada cuenta de usuario en Roblox. A diferencia del Instance.Name de un jugador, que puede cambiar según el nombre de usuario del usuario, este valor nunca cambiará por la misma cuenta.

Esta propiedad es esencial al guardar/cargar datos del jugador usando GlobalDataStores . Usa la clave de almacenamiento de datos del jugador para que cada jugador tenga una clave única.

local Players = game:GetService("Players")

local function onPlayerAdded(player)
	print(player.UserId)
end

Players.PlayerAdded:Connect(onPlayerAdded)

local Players = game:GetService("Players")

local player = Players:GetPlayerByUserId(1)

if player then
	print("Player with userId 1 is in this server! Their name is: " .. player.Name)
else
	print("Player with userId 1 is not in this server!")
end

local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")

local OWNER_ID = 212423 -- can use game.CreatorId for published places
local BADGE_ID = 1

local ownerInGame = false

local function playerAdded(newPlayer)
	if newPlayer.UserId == OWNER_ID then
		-- if new player is the owner, set ownerInGame to true and give everyone the badge
		ownerInGame = true
		for _, player in pairs(Players:GetPlayers()) do
			-- don't award the owner
			if player ~= newPlayer then
				BadgeService:AwardBadge(player.UserId, BADGE_ID)
			end
		end
	elseif ownerInGame then
		-- if the owner is in the game, award the badge
		BadgeService:AwardBadge(newPlayer.UserId, BADGE_ID)
	end
end

local function playerRemoving(oldPlayer)
	if oldPlayer.UserId == OWNER_ID then
		ownerInGame = false
	end
end

Players.PlayerAdded:Connect(playerAdded)
Players.PlayerRemoving:Connect(playerRemoving)

local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")

local goldDataStore = DataStoreService:GetDataStore("Gold")

local STARTING_GOLD = 100

local function onPlayerAdded(player)
	local playerKey = "Player_" .. player.UserId

	local leaderstats = Instance.new("IntValue")
	leaderstats.Name = "leaderstats"

	local gold = Instance.new("IntValue")
	gold.Name = "Gold"
	gold.Parent = leaderstats

	local success, result = pcall(function()
		return goldDataStore:GetAsync(playerKey) or STARTING_GOLD
	end)
	if success then
		gold.Value = result
	else
		-- Failed to retrieve data
		warn(result)
	end

	leaderstats.Parent = player
end

Players.PlayerAdded:Connect(onPlayerAdded)

La función ClearCharacterAppearance elimina todos los Accessory, Shirt, Pants, 1> Class.CharacterMesh1> y <

No elimina t-shirts , head meshes, o caras.

Devolução

local Players = game:GetService("Players")

local player = Players.LocalPlayer

local character = player.Character or player.CharacterAdded:Wait()

local function onChildRemoved(child)
	print(child.ClassName, "removed from character")
end

character.ChildRemoved:Connect(onChildRemoved)

player:ClearCharacterAppearance()
--> BodyColors removed from character
--> ShirtGraphic removed from character
--> Shirt removed from character
--> Pants removed from character
--> CharacterMesh removed from character
--> Hat removed from character
--> Shirt removed from character

La función DistanceFromCharacter Player devuelve la distancia entre la cabeza del personaje y el punto de datos Datatype.Vector3. Devuelve 0 si el jugador no tiene Vector3 .

Esto es útil para determinar la distancia entre un jugador y otro objeto o ubicación en el juego.

Si desea determinar la distancia entre dos instancias o posiciones no jugador, puede usar lo siguiendo:

local distance = (position1 - position2).magnitude

Parâmetros

Devolução

local Players = game:GetService("Players")

for _, player in pairs(Players:GetPlayers()) do
	print(player:DistanceFromCharacter(Vector3.new(0, 0, 0)))
end

Regresa un diccionario que contiene información que describe cómo el Jugador se une a la experiencia. El diccionario contiene cualquiera de los siguientes campos:

<tbody>
  <tr>
    <th>Juego de fuentes</th>
    <td>número</td>
    <td>El Class.DataModel.GameId de la experiencia que el <code>Jugador</code> teletransportó. Solo presente si el jugador se teletransporta a la experiencia actual y si un servidor llama a la función de teletransporte.</td>
  </tr>

  <tr>
    <th>Identificador de lugar de origen</th>
    <td>número</td>
    <td>El Class.DataModel.PlaceId del lugar donde se teletransportó el <code>Jugador</code>. Solo presente si el jugador se teletransporta al lugar actual y un servidor llama a la función de teletransporte.</td>
  </tr>

  <tr>
    <th>JugadorReferido</th>
    <td>número</td>
    <td>El <code>Class.Player.UserId</code> del jugador que invitó al jugador actual a la experiencia. Usa estos datos para identificar el referente y el modo de pago de la lógica de recompensa.</td>
  </tr>

  <tr>
    <th>Miembros</th>
    <td>matriz/lista</td>
    <td>Un arreglo que contiene los Class.Player.UserId números de los usuarios teletransportados junto con el jugador . Solo presente si el jugador se teletransportó como parte de un grupo.</td>
  </tr>

  <tr>
    <th>Teletransportar datos</th>
    <td>变iante</td>
    <td>Refleja el <code>teleportData</code> especificado en el teletransportaciónoriginal. Útil para compartir información entre los servidores al que se teletransporta el jugador. Solo presente si se especificó el <code>teleportData</code> y un servidor llama a la función de teletransporte.</td>
  </tr>

  <tr>
    <th>Lanzamiento de datos</th>
    <td>cadena</td>
    <td>Una cadena de texto plano o JSON que contiene datos de lanzamiento especificados en una URL <a href="../../../production/promotion/deeplinking.md">de enlace profundo</a> o <code>Class.ExperienceInviteOptions.LaunchData</code> .</td>
  </tr>
</tbody>

Obtener JoinData y TeleportData

Si un servidor inicia el teletransportacióndel jugador, el diccionario que este método devuelve incluye los datos de teletransporte del jugador. El método Player:GetJoinData() solo se puede usar para obtener los datos del teletransporte en el servidor. Para obtener los datos en el cliente, usa TeleportService:GetLocalPlayerTeleportData().

A diferencia de TeleportService:GetLocalPlayerTeleportData() , Player:GetJoinData() sólo proporciona datos de teletransporte que cumplen con los siguientes criterios de seguridad:

• Está garantizado de que se haya enviado por un servidor de Roblox en los últimos 48 horas.
• Está garantizado de que se ha enviado con este Player .
• El SourcePlaceId y SourceGameId son garantizados para ser el lugar y el universo de donde se enviaron los datos. Esto significa que puedes verificar que los datos se enviaron desde un lugar aprobado.

A medida que estos datos se transmiten por el cliente, aún puede ser abusado por un explotador. Los datos sensibles, como la moneda del jugador, deben enviarse a través de una solución segura como Almacenes de memoria.

Devolução

local DataStoreService = game:GetService("DataStoreService")
local Players = game:GetService("Players")

local analyticsStore = DataStoreService:GetDataStore("Analytics")

local ALLOWED_SOURCES = {
	"twitter";
	"youtube";
	"discord";
}

local function onPlayerAdded(player)
	local source = player:GetJoinData().LaunchData
	-- check if the provided source is valid
	if source and table.find(ALLOWED_SOURCES, source) then
		-- update the data store to track the source popularity
		local success, result = pcall(analyticsStore.IncrementAsync, analyticsStore, source)

		if success then
	  	  print(player.Name, "joined from", source, "- total:", result)
		else
	  	  warn("Failed to record join source: " .. result)
		end
	end
end

Players.PlayerAdded:Connect(onPlayerAdded)

local Players = game:GetService("Players")

local player = Players.LocalPlayer

local DIRECT_JOIN_URL = "https://www.roblox.com/games/start?placeId=%d&launchData=%s"

local textBox = script.Parent

local function generateReferralURL(player)
	return DIRECT_JOIN_URL:format(
		game.PlaceId,
		player.UserId
	)
end

local function highlightAll()
	if -- avoid recursive property updates
		textBox:IsFocused()
		and not (
	  	  textBox.SelectionStart == 1
	  	  and textBox.CursorPosition == #textBox.Text + 1
		)
	then
		textBox.SelectionStart = 1
		textBox.CursorPosition = #textBox.Text + 1
	end
end

textBox.Focused:Connect(highlightAll)
textBox:GetPropertyChangedSignal("SelectionStart"):Connect(highlightAll)
textBox:GetPropertyChangedSignal("CursorPosition"):Connect(highlightAll)

textBox.TextEditable = false
textBox.ClearTextOnFocus = false

textBox.Text = generateReferralURL(player)

local HttpService = game:GetService("HttpService")

local DATA_CHARACTER_LIMIT = 200

local function encodeTableAsLaunchData(data)
	-- convert the table to a string
	local jsonEncodedData = HttpService:JSONEncode(data)

	if #jsonEncodedData <= DATA_CHARACTER_LIMIT then
		-- escape potentially invalid characters, such as spaces
		local urlEncodedData = HttpService:UrlEncode(jsonEncodedData)
		return true, urlEncodedData
	else
		-- report character limit error
		return false, ("Encoded table exceeds %d character limit"):format(DATA_CHARACTER_LIMIT)
	end
end

local sampleData = {
	joinMessage = "Hello!";
	urlCreationDate = os.time();
	magicNumbers = {
		534;
		1337;
		746733573;
	};
}

local success, encodedData = encodeTableAsLaunchData(sampleData)

if success then
	print(encodedData)
else
	warn("failed to encode launch data: " .. encodedData)
end

local HttpService = game:GetService("HttpService")
local Players = game:GetService("Players")

local function onPlayerAdded(player)
  	local launchData = player:GetJoinData().LaunchData
  	if launchData then
  		-- attempt to decode the data
  		local success, result = pcall(HttpService.JSONDecode, HttpService, launchData)
  		if success then
  			print(player.Name, "joined with data:", result)
  		else
  			-- this is probably due to the user messing with the URL
  			warn("Failed to parse launch data:" .. result)
  		end
  	end
end

Players.PlayerAdded:Connect(onPlayerAdded)

local Players = game:GetService("Players")

local approvedPlaceIds = { 1 } -- insert approved PlaceIds here

local function isPlaceIdApproved(placeId)
	for _, id in pairs(approvedPlaceIds) do
		if id == placeId then
			return true
		end
	end
	return false
end

local function onPlayerAdded(player)
	local joinData = player:GetJoinData()

	-- verify this data was sent by an approved place
	if isPlaceIdApproved(joinData.SourcePlaceId) then
		local teleportData = joinData.TeleportData
		if teleportData then
			local currentLevel = teleportData.currentLevel
			print(player.Name .. " is on level " .. currentLevel)
		end
	end
end

Players.PlayerAdded:Connect(onPlayerAdded)

La función GetMouse Player devuelve el Mouse que el cliente está usando. La instancia del mouse del jugador se puede usar para rastrear la entrada del mouse del usuario, incluidos los clics de los botones izquierdo y derecho del ratón y la ubicación y el movimiento.

El servicio UserInputService proporciona funciones y eventos adicionales para rastrear la entrada del usuario, especialmente para los dispositivos que no usan un ratón.

Nota:

• Este artículo debe usarse en un Class.LocalScript para funcionar como esperado conectado.
• Después de una actualización en julio de 2014, el icono del ratónahora se puede establecer con este método.

Devolução

local Players = game:GetService("Players")

local player = Players.LocalPlayer

local mouse = player:GetMouse()

local function onButton1Down()
	print("Button 1 is down")
end

mouse.Button1Down:Connect(onButton1Down)

GetNetworkPing devuelve la latencia de red aislada del Player en segundos. "Ping" es una medida del tiempo que se necesita para enviar los datos desde el cliente al servidor, luego de regreso. No implica la deserialización o el procesamiento de datos.

Para el lado del cliente LocalScripts, esta función solo se puede llamar en el Players.LocalPlayer . Esta función es útil para identificar y debugger problemas que ocurren en escenarios de alta latencia. También es útil para ocultar la latencia, como ajustar la velocidad de lanzamiento de las animaciones para proyectiles.

Devolução

La función HasAppearanceLoaded Player devuelve si la apariencia del jugador Player.Character ha sido cargada o no.

La apariencia de un jugador incluye artículos como el Shirt del jugador, Pants y Accessories .

Esto es útil para determinar si la apariencia de un jugador se ha cargado después de unirse al juego, lo cual se puede rastrear utilizando el evento Players.PlayerAdded .

Devolução

local Players = game:GetService("Players")

local function onPlayerAdded(player)
	local loaded = player:HasAppearanceLoaded()
	print(loaded)

	while not loaded do
		loaded = player:HasAppearanceLoaded()
		print(loaded)
		task.wait()
	end
end

Players.PlayerAdded:Connect(onPlayerAdded)

Restablece un valor deBooleano que indica el estado de verificación de ese jugador. Cuando es cierto, el jugador está verificado. La verificación incluye, pero no está limitada a, la verificación de número de teléfono no VOIP o la verificación de identificación del gobierno.

Al implementar IsVerified , ejercita precaución para asegurarte de que la implementación no bloquee inadvertidamente a todos los usuarios no verificados.

Nota que el método solo se puede llamar en el servidor de backend. Al llamarlo desde el cliente, se devolverá un error. Además, este método siempre devolverá false en Studio.

Devolução

local Players = game:GetService("Players")

local function onPlayerAdded(player)
  print(player:IsVerified())
end

for _, player in pairs(Players:GetPlayers()) do
  onPlayerAdded(player)
end
Players.PlayerAdded:Connect(onPlayerAdded)

El método Kick() permite que una experiencia desconecte con gracia un cliente y opcionalmente proporcione un mensaje al usuario desconectado. Esto es útil para moderar a los usuarios abusivos. Solo debe permitir a los usuarios específicos que confíen en usted para que se ejecute este método en otros usuarios.

Llamar a este método en un Player sin argumentos desconecta al usuario del servidor y proporciona un mensaje de aviso predeterminado. Llamar a este método en un Player junto con una cadena como primer argumento reemplaza el mensaje predeterminado con la cadena proporcionada.

Al usar este método desde un LocalScript, solo el cliente del usuario local puede ser expulsado.

Parâmetros

Devolução

La función Move Player hace que el personaje del jugador camine en la dirección dada hasta que se detenga, o se interrumpa el jugador (usando sus controles).

Esto es útil cuando se scripting NPC Humanoids que se mueve alrededor de un mapa - pero no está controlado por la entrada de un jugador real.

Nota que el segundo argumento de la función indica si el proporcionado Vector3 debe mover al jugador relativo a los coordenadas mundiales ( falso ) o el jugador's Camera ( 1> verdadero1> ).

Parâmetros

Devolução

local Players = game:GetService("Players")
local localPlayer = Players.LocalPlayer

-- Wait for the player's character and humanoid, which must exist before calling :Move()
local character = localPlayer.Character or localPlayer.CharacterAdded:Wait()
character:WaitForChild("Humanoid")

-- The player will move until they are 50 studs away from the camera's position at the time of running
localPlayer:Move(Vector3.new(0, 0, -50), true)

La función SetAccountAge establece la Player.AccountAge del jugador en días.

Se usa para establecer la propiedad Player que describe cuánto tiempo ha estado registrado una cuenta de jugador en días.

Esto no establece la edad del jugador en la cuenta, sino la edad de la cuenta en sí misma en relación con cuando se creó por primera vez.

Parâmetros

Devolução

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player:SetAccountAge(100)

local Players = game:GetService("Players")

local MAX_AGE_NEW_PLAYER = 7 -- one week
local MIN_AGE_VETERAN = 365 -- one year

-- This function marks a part with text using a BillboardGui
local function mark(part, text)
	local bbgui = Instance.new("BillboardGui")
	bbgui.AlwaysOnTop = true
	bbgui.StudsOffsetWorldSpace = Vector3.new(0, 2, 0)
	bbgui.Size = UDim2.new(0, 200, 0, 50)
	local textLabel = Instance.new("TextLabel")
	textLabel.Size = UDim2.new(1, 0, 1, 0) -- Fill parent
	textLabel.Text = text
	textLabel.TextColor3 = Color3.new(1, 1, 1)
	textLabel.TextStrokeTransparency = 0
	textLabel.BackgroundTransparency = 1
	textLabel.Parent = bbgui
	-- Add to part
	bbgui.Parent = part
	bbgui.Adornee = part
end

local function onPlayerSpawned(player, character)
	local head = character:WaitForChild("Head")
	if player.AccountAge >= MIN_AGE_VETERAN then
		mark(head, "Veteran Player")
	elseif player.AccountAge <= MAX_AGE_NEW_PLAYER then
		mark(head, "New Player")
	else
		mark(head, "Regular Player")
	end
end

local function onPlayerAdded(player)
	-- Listen for this player spawning
	if player.Character then
		onPlayerSpawned(player, player.Character)
	end
	player.CharacterAdded:Connect(function()
		onPlayerSpawned(player, player.Character)
	end)
end

Players.PlayerAdded:Connect(onPlayerAdded)

Este método establece si el jugador ve el chat filtrado por TextService:FilterStringAsync() en lugar de chats normales.

local Players = game:GetService("Players")

local player = Players.LocalPlayer
player:SetSuperSafeChat(true)

Independientemente de si un jugador tiene habilitado el filtrado de chat, todo el chat debería filtrarse por TextService cuando se transmita a otros jugadores o en la pantalla del jugador. TextService:FilterStringAsync()返回一个 TextFilterResult objeto que se puede filtrar según el propósito del mensaje.

Parâmetros

Devolução

Esta función devuelve un diccionario de amigos en línea, limitado por el valor maxFriends. La función usa una caché de 30 segundos.

En el matriz/listadevuelto, algunos campos solo están presentes para ciertos tipos de ubicación. Por ejemplo, PlaceId no estará presente cuando LocationType esté 0 (sitio web móvil).

<tbody>
  <tr>
    <td><b>VisitorId</b></td>
    <td>número</td>
    <td>El <code>Class.Player.UserId</code> del amistad.</td>
  </tr>

  <tr>
    <td><b>Nombre de usuario</b></td>
    <td>cadena</td>
    <td>El nombre de usuario del amistad.</td>
  </tr>

  <tr>
    <td><b>Nombre de visualización</b></td>
    <td>cadena</td>
    <td>El <code>Nombre de Clase.Player.DisplayName</code> del amistad.</td>
  </tr>

  <tr>
    <td><b>Último en línea</b></td>
    <td>cadena</td>
    <td>Cuando el amigo estuvo en conectadopor última vez.</td>
  </tr>

  <tr>
    <td><b>Está en línea</b></td>
    <td>booleano</td>
    <td>Si el amigo está en conectado.</td>
  </tr>

  <tr>
    <td><b>Última ubicación</b></td>
    <td>cadena</td>
    <td>El nombre de la ubicación actual del amistad.</td>
  </tr>

  <tr>
    <td><b>LugarId</b></td>
    <td>número</td>
    <td>El ID del lugar de la última ubicación del amistad.</td>
  </tr>

  <tr>
    <td><b>Juego de ID</b></td>
    <td>cadena</td>
    <td>El <code>Modelo de datos/Id de trabajo del amigo</code> de la última ubicación del amigo.</td>
  </tr>

  <tr>
    <td><b>Tipo de ubicación</b></td>
    <td>número</td>

    <td>
      El tipo de ubicación del último lugar del amistad:

      <table>
          
      </table>
    </td>
  </tr>
</tbody>