StarterPlayer

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

Não criável
Serviço

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

Propriedades

AllowCustomAnimations

Oculto
Segurança do script Roblox
Ler Parallel

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

Ler Parallel

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

Auto-Jump Toggle

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

Não replicado
Não scriptável
Não navegável
Ler Parallel

CameraMaxZoomDistance

Ler Parallel

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

Setting Camera Zoom Distance

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75

CameraMinZoomDistance

Ler Parallel

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

Setting Camera Zoom Distance

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75

CameraMode

Ler Parallel

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

Playing in First Person

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

CharacterJumpHeight

Ler Parallel

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

Ler Parallel

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

Ler Parallel

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

Ler Parallel

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

Ler Parallel

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

Ler Parallel

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

Ler Parallel

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

Setting a Player's Camera Movement Mode (Desktop)

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

Ler Parallel

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

Setting a Player's Movement Mode (Desktop)

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

Ler Parallel

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

Setting a Player's Camera Movement Mode (Touch)

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

Ler Parallel

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

Setting a Player's Movement Mode (Touch)

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

Não scriptável
Ler Parallel

EnableMouseLockOption

Ler Parallel

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

Enabling a Player's Mouse Lock

local Players = game:GetService("Players")
local player = Players.LocalPlayer
while true do
player.DevEnableMouseLock = not player.DevEnableMouseLock
task.wait(5)
end

HealthDisplayDistance

Ler Parallel

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

Hiding Player Health and Names

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

LoadCharacterAppearance

Ler Parallel

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

Disabling a Player's Appearance

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

LoadCharacterLayeredClothing

Não replicado
Não scriptável
Ler Parallel

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

Não navegável
Ler Parallel

NameDisplayDistance

Ler Parallel

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

Hiding Player Health and Names

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

UserEmotesEnabled

Ler Parallel

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.

Métodos

Eventos