StarterPlayer
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
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.
Resumo
Propriedades
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.
Propriedades
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
Amostras de código
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.
Amostras de código
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75
CameraMinZoomDistance
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.
Amostras de código
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75
CameraMode
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.
Amostras de código
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMode = Enum.CameraMode.LockFirstPerson
CharacterJumpHeight
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.
Amostras de código
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
DevComputerMovementMode
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.
Amostras de código
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.
Amostras de código
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
DevTouchMovementMode
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.
Amostras de código
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.
Amostras de código
local Players = game:GetService("Players")
local player = Players.LocalPlayer
while true do
player.DevEnableMouseLock = not player.DevEnableMouseLock
task.wait(5)
end
HealthDisplayDistance
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 .
Amostras de código
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0
LoadCharacterAppearance
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 .
Amostras de código
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CanLoadCharacterAppearance = false
LoadCharacterLayeredClothing
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 .
Amostras de código
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0
UserEmotesEnabled
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.