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 que los valores predeterminados de las propiedades en el objeto Player se establecer. Cuando un jugador ingresa al servidor, cada propiedad de los valores del jugador se establece en el valor actual de la propiedad correspondiente en StarterPlayer .
Además, puede agregar cuatro objetos a este servicio:
- Una instancia de StarterPlayerScripts con scripts que se ejecutan una vez para cada jugador.
- Una instancia de StarterCharacterScripts con scripts para agregar a cada personaje de cada jugador cada vez que regeneración.
- Una instancia de Humanoid llamada StarterHumanoid que se usará como el humanoid predeterminado para cada personaje de los jugadores.
- Una instancia de 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 avatar personalizadas del sitio web.
Establece si el personaje saltará automáticamente cuando golpee un obstáculo en un dispositivo móvil.
La distancia máxima que la cámara predeterminada del jugador se puede acercar en studs.
La distancia mínima en pies de la cámara predeterminada del jugador se permite acercar.
Cambia el modo de la cámara predeterminada a primera o tercera persona.
Determina el valor de inicio de Humanoid.JumpHeight para Player.Character .
Determina el valor de inicio de Humanoid.JumpPower para Player.Character .
Determina el valor de inicio de Humanoid.MaxSlopeAngle para Player.Character .
Determina el estado inicial de Humanoid.UseJumpPower para Player.Character .
Determina el valor de inicio de Humanoid.WalkSpeed para Player.Character .
Establece cómo las manijas de cámara predeterminadas manejan los objetos entre la cámara y el jugador.
Permitimos a los desarrolladores sobrescribir el modo de cámara predeterminado para cada jugador si el jugador está en una computadora.
Vamos a que los desarrolladores sobrescriban el modo de movimiento del jugador si el jugador está en una computadora.
Permitir que los desarrolladores sobrescriban el modo de movimiento de cámara predeterminado para cada jugador si el jugador está en un dispositivo móvil.
Vamos a los desarrolladores a sobrescribir 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 en 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 debe cargarse la apariencia del personaje de un jugador.
Indica si los personajes que se generan en una experiencia tendrán accesorios de ropa dobles en ellos.
Establece la distancia en la que este jugador verá otros nombres de Humanoid . Si se establece en 0, se ocultan los nombres.
Determina si los emotes de propiedad del usuario se cargan al cargar avatares.
Propiedades
AllowCustomAnimations
La propiedad AllowCustomAnimations describe los niveles de permiso del juego actual con respecto a los avatares personalizados Animations del 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 se destina para su uso en el juego.
AutoJumpEnabled
La propiedad AutoJumpEnabled establece si el personaje saltará automáticamente cuando golpea 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 Humanoid.AutoJumpEnabled propiedad del personaje's 1>Class.Humanoid1> en el regeneración. En otras pal
Muestras de código
This code sample is meant for a TextButton. It allows the player to toggle the auto-jumping behavior while on a mobile device.
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()AvatarJointUpgrade
CameraMaxZoomDistance
La propiedad CameraMaxZoomDistance establece la distancia máxima en pies 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 une 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
La propiedad CameraMinZoonDistance establece la distancia mínima en pies 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 une 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 está acercada todo el camino. A menos que haya un GUI visible con la propiedad GuiButton.Modal establecida a true, el mouse se mantendrá bloqueado y la cámara del usuario se alineará con el mouse.
Tercera Persona
En el modo de tercera persona (por defecto), el personaje se puede ver en la cámara. Mientras que en el modo de tercera persona en Roblox:
- Puede hacer clic con el botón derecho y arrastrar para girar su 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 ratón hacia el final de la pantalla).
- Cuando presione cualquiera de las teclas de flecha, el personaje del usuario se enfrentará en la dirección de claveflecha correspondiente.
- Puedes acercar 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
CharacterJumpHeight determina el valor de inicio de Humanoid.JumpHeight para un jugador de Character . El valor de esta propiedad predeterminado es 7.2 studs.
Esta propiedad solo se muestra en la ventana Propiedades si StarterPlayer.CharacterUseJumpPower está configurado como false , ya que no sería relevante de otra manera.
Dado que esta propiedad solo es relevante para los personajes que se generan en el futuro, cambiarla no cambiará ningún personaje existente. Los cambios en esta propiedad solo tendrán efecto cuando un jugador reaparezca.
CharacterJumpPower
CharacterJumpPower determina el valor de inicio de Humanoid.JumpPower para un jugador. El valor de esta propiedad se predetermina en 50 y cuando se aplica a Character se limita entre 0 y 1000.
Esta propiedad solo se muestra en la ventana Propiedades si StarterPlayer.CharacterUseJumpPower está configurado como true , ya que no sería relevante de otra manera.
Dado que esta propiedad solo es relevante para los personajes que se generan en el futuro, cambiarla no cambiará ningún personaje existente. Los cambios en esta propiedad solo tendrán efecto cuando un jugador reaparezca.
CharacterMaxSlopeAngle
CharacterMaxSlopeAngle determina el valor de inicio de Humanoid.MaxSlopeAngle para un jugador. Por defecto, está predeterminado en 89°, por lo que los humanoides pueden escalar casi cualquier curva que quieran por defecto. Cuando se aplica a Character del jugador, se
Dado que esta propiedad solo es relevante para los personajes que se generan en el futuro, cambiarla no cambiará ningún personaje existente. Los cambios en esta propiedad solo tendrán efecto cuando un jugador reaparezca.
CharacterUseJumpPower
CharacterUseJumpPower determina el valor de inicio de Humanoid.UseJumpPower para un jugador. Al alternarlo, cambiará la propiedad visible en la ventana de propiedades: Character (falso) o
Dado que esta propiedad solo es relevante para los personajes que se generan en el futuro, cambiarla no cambiará ningún personaje existente. Los cambios en esta propiedad solo tendrán efecto cuando un jugador reaparezca.
CharacterWalkSpeed
CharacterWalkSpeed determina el valor de inicio de Humanoid.WalkSpeed para un jugador de Character . Esta propiedad se predetermina en 16.
Dado que esta propiedad solo es relevante para los personajes que se generan en el futuro, cambiarla no cambiará ningún personaje existente. Los cambios en esta propiedad solo tendrán efecto cuando un jugador reaparezca.
DevCameraOcclusionMode
Define cómo los scripts de cámara predeterminados manejan objetos entre la cámara y el sujeto de la cámara. Se aplica a todos los jugadores a medida que se unen a la experiencia y no se pueden cambiar para los jugadores individuales.
El valor predeterminado es Zoom (0). Consulte Enum.DevCameraOcclusionMode para obtener una lista de los modos disponibles.
DevComputerCameraMovementMode
La propiedad DevComputerCameraMovementMode le permite al desarrollador sobrescribir 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 los jugadores individuales por configuración el Player.DevComputerCameraMode .
Si se establece en UserChoice el modo de movimiento de la cámara del jugador será determinado por el modo de movimiento de la cámara del jugador en la configuración del juego. De lo contrario, el modo se establecerá en función de esta propiedad.
Vea Enum.DevComputerCameraMovementMode para obtener información sobre los diferentes modos de cámara disponibles.
Esta propiedad no afecta a los 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
La propiedad DevComputerMovementMove le permite al desarrollador sobrescribir 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 los jugadores individuales por configuración el Player.DevComputerMovementMode .
Si se establece en UserChoice el modo de movimiento del jugador será determinado por lo que el jugador haya establecido en la configuración 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. Dejemos que los desarrolladores sobrescriban el modo de movimiento del jugador si el jugador está en un ordenador.
Esta propiedad no afecta a los 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
La propiedad DevTouchCameraMovementMode le permite al desarrollador sobrescribir 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 los jugadores individuales por configuración el Player.DevTouchCameraMode .
Si se establece en UserChoice el modo de movimiento de la cámara del jugador será determinado por lo que el jugador haya establecido en la configuración del juego. De lo contrario, el modo se establecerá en función de esta propiedad.
Vea Enum.DevTouchCameraMovementMode para obtener información sobre 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
La propiedad DevTouchMovementMode le permite al desarrollador sobrescribir 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 los jugadores individuales por configuración el Player.DevTouchMovementMode .
Si se establece en UserChoice el modo de movimiento del jugador será determinado por lo que el jugador haya establecido en la configuración 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. Dejemos que los desarrolladores sobrescriban el modo de movimiento del jugador si el jugador está en un dispositivo táctil.
Esta propiedad no afecta a los jugadores que no estén en un dispositivo habilitado para tocar.
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
La propiedad EnableMouseLockOption 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á relativo a la rotación actual de la cámara.
Esta propiedad establece el valor de Player.DevEnableMouseLock .
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.
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
La propiedad HealthDisplayDistance 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 está predeterminada en 100 studs.
Para cambiar la distancia de visualización para un jugador una vez que se unan al juego, puede establecer la propiedad Player.HealthDisplayDistance
Si se muestra una barra de salud de Humanoid, 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
La propiedad LoadCharacterAppearance establece si debe o noarse la apariencia de un personaje de un jugador.
Establecer esto en false resulta en que el jugador no tenga ropa (incluida la sombrerería), colores del cuerpo, paquetes del 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 el jugador cargando la apariencia que coincida con el jugador's Player.CharacterAppearanceId .
Si Player:LoadCharacterWithHumanoidDescription() se usa, puede ser ventajoso establecer StarterPlayer.LoadCharacterAppearance como falso como el avatar del jugador no es requerido como todos los ID de los activos para equipar en el personaje vendrá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 se generan en una experiencia tendrán accesorios de ropa a capas en ellos (aunque Workspace.MeshPartHeadsAndAccessories también se debe habilitar en el Workspace).
LuaCharacterController
NameDisplayDistance
Establece la distancia en la que este jugador verá otros nombres de Humanoid . Si se establece en 0, se ocultan los nombres.
El valor de propiedad NameDisplayDistance StarterPlayer establece la distancia en studs en los que este jugador verá otros nombres Humanoid . Si se establece en 0, los nombres están ocultos. Esta propiedad se establece por defecto en 100 studs.
Para cambiar la distancia de visualización para un jugador una vez que se unan al juego, puede establecer la propiedad Player.NameDisplayDistance
Si se muestra un nombre de Humanoid, 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 = 0UserEmotesEnabled
Esta propiedad determina si los emotes de propiedad del usuario se cargan 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 la carga de emotes esté deshabilitada, la interfaz de emotes seguirá funcionando siempre que los desarrolladores elijan usar la función de emotes agregando emotes dentro de su juego.
También see Emotes de Avatar, un artículo que detalla cómo controlar, personalizar y jugar emotes de avatar.