StarterPlayer
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
Un servicio que permite establecer los valores predeterminados de las propiedades en el objeto Player .Cuando un jugador ingresa al servidor, cada propiedad del objeto del jugador se establece al valor actual de la propiedad correspondiente en StarterPlayer .
Además, puedes agregar cuatro objetos a este servicio:
- Una instancia StarterPlayerScripts con scripts que se ejecutan una vez por cada jugador.
- Una instancia StarterCharacterScripts con scripts para agregar al personaje de cada jugador cada vez que regeneración.
- Una instancia Humanoid llamada StarterHumanoid que se usará como el humanoide predeterminado para el personaje de cada jugador.
- Una instancia Model llamada StarterCharacter que se usará como modelo de personaje para todos los jugadores.
Resumen
Propiedades
Describe los niveles de permiso del juego actual con respecto a las animaciones de avatares personalizados desde el sitio web.
Establece si el personaje saltará automáticamente al golpear un obstáculo en un dispositivo móvil.
La distancia máxima que la cámara predeterminada del jugador se permite alejar en tachuelas.
Se permite que la distancia mínima en studs la cámara predeterminada del jugador se acercar.
Cambia el modo de la cámara predeterminada a primera o tercera persona.
Determina el valor inicial de Humanoid.JumpHeight para Player.Character .
Determina el valor inicial de Humanoid.JumpPower para Player.Character .
Determina el valor inicial de Humanoid.MaxSlopeAngle para Player.Character .
Determina el estado inicial de Humanoid.UseJumpPower para Player.Character.
Determina el valor inicial de Humanoid.WalkSpeed para Player.Character .
Establece cómo maneja la cámara predeterminada los objetos entre la cámara y el jugador.
Permite al desarrollador reemplazar el modo de cámara predeterminado para cada jugador si el jugador está en un ordenador.
Permite al desarrollador reemplazar el modo de movimiento del jugador si el jugador está en un ordenador.
Permite al desarrollador reemplazar el modo de movimiento de la cámara predeterminada para cada jugador si el jugador está en un dispositivo móvil.
Permite al desarrollador reemplazar el modo de movimiento del jugador si el jugador está en un dispositivo táctil.
Determina si un jugador puede alternar el bloqueo del mouse por defecto.
Establece la distancia a la que este jugador verá otras barras de salud Humanoid. Si se establece en 0, las barras de salud no se mostrarán.
Si debe o no cargarse la apariencia del personaje de un jugador.
Indica si los personajes que aparecen en una experiencia tendrán accesorios de ropa en capas equipados sobre ellos.
Establece la distancia en la que este jugador verá otros nombres Humanoid .
Determina si se cargan los emoticonos de propiedad del usuario al cargar avatares.
Propiedades
AllowCustomAnimations
Esta propiedad describe los niveles de permiso del juego actual con respecto al avatar personalizado desde el sitio web.
Como tal, este valor no se puede cambiar desde dentro del juego.Solo se puede cambiar cambiando los niveles de permiso del juego dentro de la página de configuración del juego en el sitio web.
Esta propiedad no está destinada a su uso en el juego.
AutoJumpEnabled
Esta propiedad establece si el personaje saltará automáticamente al golpear un obstáculo en un dispositivo móvil.
Esta propiedad se copia de la StarterPlayer a una Player cuando se unen al juego.Después de eso.el valor de esta propiedad se copia a la propiedad Humanoid.AutoJumpEnabled de la propiedad del personaje Humanoid en el momento del regeneración.En otras palabras, es posible establecer el comportamiento de salto automático en una base por caracteres, por jugadores y por juegos usando estas tres propiedades.
Muestras de código
Este ejemplo de código está destinado a un TextButton. Permite al jugador alternar el comportamiento de salto automático mientras está en un dispositivo móvil.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local button = script.Parent
local function update()
-- Texto del botón de actualización
if player.AutoJumpEnabled then
button.Text = "Auto-Jump is ON"
else
button.Text = "Auto-Jump is OFF"
end
-- Reflejar la propiedad en el personaje del jugador, si tiene uno
if player.Character then
local human = player.Character:FindFirstChild("Humanoid")
if human then
human.AutoJumpEnabled = player.AutoJumpEnabled
end
end
end
local function onActivated()
-- Alternar salto automático
player.AutoJumpEnabled = not player.AutoJumpEnabled
-- Actualizar todo lo demás
update()
end
button.Activated:Connect(onActivated)
update()AvatarJointUpgrade
CameraMaxZoomDistance
Esta propiedad establece la distancia máxima en tachuelas que la cámara puede estar del personaje con las cámaras predeterminadas.
Esta propiedad establece el valor predeterminado de Player.CameraMaxZoomDistance para cada jugador que se una al juego.Si este valor se establece en un valor inferior a StarterPlayer.CameraMinZoomDistance se aumentará a CameraMinZoomDistance.
Muestras de código
The example demonstrates how to set a player's camera minimum and maximum zoom distance.
In this example, we set the Player.CameraMinZoomDistance and Player.CameraMaxZoomDistance to set the min and max distance in studs a player's camera can be from their character.
Note that since the example attempts to set the CameraMinZoomDistance to be greater than the CameraMaxZoomDistance, the CameraMinZoomDistance value will be decreased and set to the value of the max zoom distance.
To change the default min and max zoom distance values for a player when they first enter the game, you can change the StarterClass.Player.CameraMinZoomDistance and StarterClass.Player.CameraMaxZoomDistance properties.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75CameraMinZoomDistance
Esta propiedad establece la distancia mínima en tachuelas que la cámara puede estar del personaje con las cámaras predeterminadas.
Esta propiedad establece el valor predeterminado de Player.CameraMinZoomDistance para cada jugador que se una al juego.Si este valor se establece en un valor superior a StarterPlayer.CameraMaxZoomDistance se reducirá a CameraMaxZoomDistance.
Muestras de código
The example demonstrates how to set a player's camera minimum and maximum zoom distance.
In this example, we set the Player.CameraMinZoomDistance and Player.CameraMaxZoomDistance to set the min and max distance in studs a player's camera can be from their character.
Note that since the example attempts to set the CameraMinZoomDistance to be greater than the CameraMaxZoomDistance, the CameraMinZoomDistance value will be decreased and set to the value of the max zoom distance.
To change the default min and max zoom distance values for a player when they first enter the game, you can change the StarterClass.Player.CameraMinZoomDistance and StarterClass.Player.CameraMaxZoomDistance properties.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75CameraMode
Establece el valor predeterminado para Player.CameraMode para cada jugador en el juego. La cámara tiene dos modos:
Primera persona
En el modo de primera persona, la cámara del jugador se acerca todo el camino.A menos que haya una interfaz gráfica visible presente con la propiedad GuiButton.Modal configurada en true, el mouse se bloqueará y la cámara del usuario se volverá cuando el mouse se mueva.
Tercera persona
En el modo de tercera persona (predeterminado), el personaje se puede ver en la cámara. Mientras que en el modo de tercera persona en Roblox:
- Puedes hacer clic derecho y arrastrar para girar tu cámara, o usar las teclas de flecha en la esquina inferior derecha de la pantalla.
- Cuando mueves el ratón, tu cámara no cambia (a menos que muevas el mouse al final de la pantalla).
- Cuando presiones cualquiera de las teclas de flecha, el personaje del usuario se enfrentará en la dirección de la clavede flecha correspondiente.
- Puedes acercarte y alejarte libremente.
Muestras de código
This example demonstrates how to change the character's CameraMode to first person using the LockFirstPerson value of the Enum.CameraMode enum.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMode = Enum.CameraMode.LockFirstPersonCharacterJumpHeight
Esta propiedad determina el valor inicial de Humanoid.JumpHeight para un jugador de Player.Character. El valor de esta propiedad se establece por defecto en 7.2 tachuelas.
Esta propiedad solo es visible en la ventana de propiedades si StarterPlayer.CharacterUseJumpPower está configurada como false, ya que de lo contrario no sería relevante.
Dado que esta propiedad solo es relevante para los personajes que se generan en el futuro, cambiarla no cambiará ningún personaje de jugador existente.Los cambios en esta propiedad solo tendrán efecto cuando un jugador reaparezca.
CharacterJumpPower
Esta propiedad determina el valor inicial de Humanoid.JumpPower para un jugador de Player.Character .El valor de esta propiedad se establece por defecto en 50 y cuando se aplica al Humanoid del jugador, se limitará entre 0 y 1000.
Esta propiedad solo es visible en la ventana de propiedades si StarterPlayer.CharacterUseJumpPower está configurada como true, ya que de lo contrario no sería relevante.
Dado que esta propiedad solo es relevante para los personajes que se generan en el futuro, cambiarla no cambiará ningún personaje de jugador existente.Los cambios en esta propiedad solo tendrán efecto cuando un jugador reaparezca.
CharacterMaxSlopeAngle
Esta propiedad determina el valor inicial de Humanoid.MaxSlopeAngle para un jugador de Player.Character .Por defecto es de 89°, por lo que los humanoides pueden escalar prácticamente cualquier pendiente que deseen de forma predeterminada.Cuando se aplica al Humanoid del jugador, se limitará entre 0 y 89.
Dado que esta propiedad solo es relevante para los personajes que se generan en el futuro, cambiarla no cambiará ningún personaje de jugador existente.Los cambios en esta propiedad solo tendrán efecto cuando un jugador reaparezca.
CharacterUseJumpPower
CharacterUseJumpPower determina el valor inicial de Humanoid.UseJumpPower para un jugador de Player.Character .Alternarlo cambiará qué propiedad es visible en la ventana de propiedades: CharacterJumpHeight (falso) o StarterPlayer.CharacterJumpPower (verdadero).Se prefiere a verdadero.
Dado que esta propiedad solo es relevante para los personajes que se generan en el futuro, cambiarla no cambiará ningún personaje de jugador existente.Los cambios en esta propiedad solo tendrán efecto cuando un jugador reaparezca.
CharacterWalkSpeed
Esta propiedad determina el valor inicial de Humanoid.WalkSpeed para un jugador de Player.Character. Esta propiedad se predetermina a 16.
Dado que esta propiedad solo es relevante para los personajes que se generan en el futuro, cambiarla no cambiará ningún personaje de jugador existente.Los cambios en esta propiedad solo tendrán efecto cuando un jugador reaparezca.
ClassicDeath
DevCameraOcclusionMode
Define cómo los scripts de cámara predeterminados manejan los objetos entre la cámara y el sujeto de la cámara.Se aplica a todos los jugadores al unirse a la experiencia y no se puede cambiar para jugadores individuales.
El valor predeterminado es Zoom (0). Vea Enum.DevCameraOcclusionMode para una lista de modos disponibles.
DevComputerCameraMovementMode
Esta propiedad permite al desarrollador reemplazar el modo de cámara del jugador si el jugador está en un ordenador.
Esta es la propiedad predeterminada para los jugadores que se unen al juego. Se puede cambiar para jugadores individuales configurando el Player.DevComputerCameraMode .
Si se establece en UserChoice, el modo de movimiento de la cámara del jugador se determinará por lo que el jugador haya establecido en las configuraciones del juego.De lo contrario, el modo se establecerá en función de esta propiedad.
Vea Enum.DevComputerCameraMovementMode para los diferentes modos de cámara disponibles.
Esta propiedad no tiene ningún efecto en jugadores que no estén en una computadora.
Muestras de código
The example demonstrates how to set a player's camera movement mode for players on a computer.
In this example, we set the camera movement mode to Classic via the Enum.DevComputerCameraMovementMode enum. This means that the camera of players on touch enabled devices will track the player but will not automatically rotate if the player walks left or right.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Set the player's camera movement mode on computers to classic
player.DevComputerCameraMode = Enum.DevComputerCameraMovementMode.ClassicDevComputerMovementMode
Esta propiedad permite al desarrollador reemplazar el modo de movimiento del jugador si el jugador está en un ordenador.
Esta es la propiedad predeterminada para los jugadores que se unen al juego. Se puede cambiar para jugadores individuales configurando el Player.DevComputerMovementMode .
Si se establece en UserChoice, el modo de movimiento del jugador se determinará por lo que el jugador haya establecido en las configuraciones del juego.De lo contrario, el modo se establecerá en función de esta propiedad.
Vea Enum.DevComputerMovementMode para los diferentes modos de movimiento disponibles. Permita que el desarrollador reemplace el modo de movimiento del jugador si el jugador está en un equipo.
Esta propiedad no tiene ningún efecto en jugadores que no estén en una computadora.
Muestras de código
Demonstrates how to set the movement mode for players on computers using the Player.DevComputerMovementMode property.
local Players = game:GetService("Players")
local function onPlayerAdded(player: Player)
-- Set the player's movement mode on desktop devices to click-to-move
-- Once set, the player can right click in the game world and the character will move there.
player.DevComputerMovementMode = Enum.DevComputerMovementMode.ClickToMove
end
Players.PlayerAdded:Connect(onPlayerAdded)DevTouchCameraMovementMode
Esta propiedad permite al desarrollador reemplazar el modo de cámara del jugador si el jugador está en un dispositivo táctil.
Esta es la propiedad predeterminada para los jugadores que se unen al juego. Se puede cambiar para jugadores individuales configurando el Player.DevTouchCameraMode .
Si se establece en UserChoice, el modo de movimiento de la cámara del jugador se determinará por lo que el jugador haya establecido en las configuraciones del juego.De lo contrario, el modo se establecerá en función de esta propiedad.
Vea Enum.DevTouchCameraMovementMode para los diferentes modos de cámara disponibles.
Esta propiedad no afecta a los jugadores que no estén en un dispositivo móvil.
Muestras de código
The example demonstrates how to set a player's camera movement mode.
In this example, we set the camera movement mode to Classic via the Enum.DevTouchCameraMovementMode enum. This means that the camera of players on touch enabled devices will track the player but will not automatically rotate if the player walks left or right.
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.ClassicDevTouchMovementMode
Esta propiedad permite al desarrollador reemplazar el modo de movimiento del jugador si el jugador está en un dispositivo táctil.
Esta es la propiedad predeterminada para los jugadores que se unen al juego. Se puede cambiar para jugadores individuales configurando el Player.DevTouchMovementMode .
Si se establece en UserChoice, el modo de movimiento del jugador se determinará por lo que el jugador haya establecido en las configuraciones del juego.De lo contrario, el modo se establecerá en función de esta propiedad.
Vea Enum.DevTouchMovementMode para los diferentes modos de movimiento disponibles. Permita que el desarrollador reemplace el modo de movimiento del jugador si el jugador está en un dispositivo táctil.
Esta propiedad no tiene ningún efecto en los jugadores que no estén en un dispositivo habilitado para el tacto.
Muestras de código
The example demonstrates how to set the movement mode for players on touch enabled devices.
In this example, we set the movement mode to Thumbstick via the Enum.DevTouchMovementMode enum. This means that players on touch enabled devices are able to move via a virtual thumbstick on their screen.
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)EnableDynamicHeads
EnableMouseLockOption
Esta propiedad determina si un jugador puede alternar el bloqueo del mouse por defecto.
Mouselock bloqueará el cursor del jugador en el centro de la pantalla.Mover el mouse girará el Camera y Player se moverá en relación con la rotación actual de la cámara.
Esta propiedad establece el valor de Player.DevEnableMouseLock .
Tenga en cuenta que las API relacionadas con el bloqueo de cambio están en proceso de ser desusar, en desuso (noun), por lo que se recomienda usar UserInputService.MouseBehavior en lugar de bloquear el ratón.
Muestras de código
The example demonstrates how to enable and disabled whether a player can lock their mouse.
In this example, we set the use a while true loop to toggle the state of the DevEnabledMouseLock property between true and false every 5 seconds. While this example has little practical use, it demos how to change the property via a LocalScript.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
while true do
player.DevEnableMouseLock = not player.DevEnableMouseLock
task.wait(5)
endHealthDisplayDistance
Esta propiedad establece la distancia en studs en la que este jugador verá otras barras de salud Humanoid.Si se establece en 0, las barras de salud no se mostrarán.Esta propiedad se establece en 100 studs por defecto.
Para cambiar la distancia de visualización para un jugador una vez que se unan al juego, puedes establecer la propiedad Player.HealthDisplayDistance.
Si una barra de salud Humanoid visible, puedes establecer el tipo de visualización usando Humanoid.DisplayDistanceType.
Muestras de código
This example demonstrates how to hide other Humanoid's (Player and NPC) health bars and names.
This is done by setting the player's Player.HealthDisplayDistance and Player.NameDisplayDistance properties to 0.
If you would like to display health bars and names, you set the properties to a value greater than 0. For instance, setting the properties to 100 means that the player will see other player's health and names up to 100 studs away.
To modify the default values for players, you can change the values of the StarterClass.Player.HealthDisplayDistance and StarterClass.Player.NameDisplayDistance properties.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0LoadCharacterAppearance
Esta propiedad establece si debe o no cargarse la apariencia del personaje de un jugador.
Establecer esto en false resulta en que el jugador no tenga ropa (incluidos sombreros), colores del cuerpo, paquetes de cuerpo o cualquier otra cosa relacionada con la apariencia del avatar del jugador.Por defecto, esta propiedad se establece en true .
Establecer esto en true resulta en que el jugador cargue la apariencia correspondiente al jugador Player.CharacterAppearanceId.
Si se usa Player:LoadCharacterWithHumanoidDescription(), puede ser ventajoso establecer StarterPlayer.LoadCharacterAppearance en falso ya que el avatar del jugador no es necesario como todos los ID de activos para equipar en el personaje provendrán del pasado en HumanoidDescription.
Muestras de código
This example demonstrates how to disable loading a player's character appearance. Instead, the player loads as a grey model without any hats, shirts, pants, etc.
This is useful for games using custom clothing and accessories.
Note that if the character has already spawned, this change will not take affect until the player respawns or the Player:LoadCharacter() function is called.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CanLoadCharacterAppearance = falseLoadCharacterLayeredClothing
Indica si los personajes que aparecen en una experiencia tendrán accesorios de ropa en capas equipados en ellos (aunque también necesitan estar habilitados en el ).
LuaCharacterController
NameDisplayDistance
Establece la distancia en la que este jugador verá otros nombres Humanoid .Si se establece en 0, los nombres se ocultan.Esta propiedad se establece en 100 tachuelas por defecto.
Para cambiar la distancia de visualización para un jugador una vez que se unan al juego, puedes establecer la propiedad Player.NameDisplayDistance.
Si un nombre Humanoid visible, puedes establecer el tipo de visualización usando Humanoid.DisplayDistanceType.
Muestras de código
This example demonstrates how to hide other Humanoid's (Player and NPC) health bars and names.
This is done by setting the player's Player.HealthDisplayDistance and Player.NameDisplayDistance properties to 0.
If you would like to display health bars and names, you set the properties to a value greater than 0. For instance, setting the properties to 100 means that the player will see other player's health and names up to 100 studs away.
To modify the default values for players, you can change the values of the StarterClass.Player.HealthDisplayDistance and StarterClass.Player.NameDisplayDistance properties.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0RagdollDeath
UserEmotesEnabled
Esta propiedad determina si se cargan los emoticonos de propiedad del usuario al cargar avatares.Establecer esta propiedad en falso desactiva la carga.Los desarrolladores pueden establecer la propiedad en Studio directamente o a través del menú Configuración del juego.
Cuando se desactiva la carga de emotes, la interfaz de usuario de emotes seguirá funcionando mientras los desarrolladores elijan usar la función de emotes agregando emotes dentro de su juego.
Vea también Emotes de avatar, un artículo que detalla cómo controlar, personalizar y jugar emotes de avatar.