StarterPlayer

Afficher les obsolètes

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

Création impossible
Service

Un service qui permet aux valeurs par défaut dans l'objet Player d'être configurer. Lorsqu'un joueur entre dans le serveur, chaque propriété du joueur est réglée sur la valeur actuelle de la propriété correspondante dans StarterPlayer.

En outre, vous pouvez ajouter quatre objets à ce service :

  • Une instance StarterPlayerScripts avec des scripts qui s'exécutent une fois pour chaque joueur.
  • Une instance StarterCharacterScripts avec des scripts à ajouter à chaque personnage du joueur à chaque fois qu'ils régénération, apparition.
  • Une instance Humanoid nommée StarterHumanoid qui sera utilisée comme le humanoid par défaut pour chaque personnage de chaque joueur.
  • Une instance Model nommée StarterCharacter qui sera utilisée comme modèle de personnage pour tous les joueurs.

Résumé

Propriétés

Propriétés

AllowCustomAnimations

Caché
Sécurité des scripts Roblox
Lecture parallèle

La propriété AllowCustomAnimations décrit les niveaux d'autorisation du jeu actuel en matière d'avatar personnalisé Animations sur le site Web.

En tant que telle, cette valeur ne peut pas être modifiée à partir du jeu. Il ne peut être modifié que en changeant les niveaux d'autorisation du jeu dans la page de paramètre du jeu sur le site Web.

Cette propriété n'est pas destinée à être utilisée dans le jeu.

AutoJumpEnabled

Lecture parallèle

La propriété AutoJumpEnabled détermine si le personnage saute automatiquement lorsqu'il frappe un obstacle sur un appareil mobile.

Cette propriété est copiée du StarterPlayer à un Player lorsqu'ils rejoignent le jeu. Suivant cela, la valeur de cette propriété est copiée à Humanoid.AutoJumpEnabled propriété du personnage's 1>Class.Humanoid1> au moment

Échantillons de code

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

Non répliqué
Non scriptable
Non navigable
Lecture parallèle

CameraMaxZoomDistance

Lecture parallèle

La propriété CameraMaxZoomDistance détermine la distance maximale en studs que la caméra peut avoir du personnage avec les caméras par défaut.

Cette propriété définit la valeur par défaut de Player.CameraMaxZoomDistance pour chaque joueur qui rejoint le jeu. Si cette valeur est réglée sur un nombre inférieur à StarterPlayer.CameraMinZoomDistance, il sera augmenté à CameraMinZoomDistance.

Échantillons de code

Setting Camera Zoom Distance

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

CameraMinZoomDistance

Lecture parallèle

La propriété CameraMinZoonDistance définit la distance minimum dans laquelle la caméra peut être du personnage avec les caméras par défaut.

Cette propriété définit la valeur par défaut de Player.CameraMinZoomDistance pour chaque joueur qui rejoint le jeu. Si cette valeur est définie à un niveau supérieur à StarterPlayer.CameraMaxZoomDistance, elle sera réduite à CameraMaxZoomDistance.

Échantillons de code

Setting Camera Zoom Distance

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

CameraMode

Lecture parallèle

Définit la valeur par défaut pour Player.CameraMode pour chaque joueur dans le jeu. La caméra a deux modes :

Première personne

En mode première personne, la caméra du joueur est zoomée tout le long de la façon. À moins qu'il n'y ait une GUI visible avec la propriété GuiButton.Modal définie sur true, la souris sera verrouillée et la caméra de l'utilisateur tournera avec la souris.

Troisième personne

En mode troisième personne (par défaut), le personnage peut être vu dans la caméra. Alors qu'en mode troisième personne sur Roblox :

  • Vous pouvez faire un clic droit et faire glisser pour tourner votre caméra, ou utiliser les flèches en bas du coin droit de l'écran.
  • Lorsque vous déplacez votre souris, votre caméra ne change pas (à moins que vous ne déplaciez la souris jusqu'au bout de l'écran).
  • Lorsque vous appuyez sur l'une des flèches, le personnage de l'utilisateur se dirigera dans la direction correspondante de la flèche clé.
  • Vous pouvez zoomer vers l'intérieur et vers l'extérieur librement.

Échantillons de code

Playing in First Person

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

CharacterJumpHeight

Lecture parallèle

CharacterJumpHeight détermine la valeur de départ de Humanoid.JumpHeight pour un joueur의 Character . La valeur de cette propriété par défaut est 7,2 studs.

Cette propriété n'est visible que dans la fenêtre propriétés si StarterPlayer.CharacterUseJumpPower est réglé sur false, car ce ne serait pas pertinent sinon.

Puisque cette propriété n'est pertinente que pour les personnages qui apparaissent à l'avenir, le changer n'affectera pas les personnages de joueur existants. Les modifications de cette propriété n'auront effet que lorsqu'un joueur réapparaîtra.

CharacterJumpPower

Lecture parallèle

CharacterJumpPower détermine la valeur de départ de Humanoid.JumpPower pour un joueur의 Character . La valeur de cette propriété par défaut est 50 et lorsqu'elle est appliquée au joueur의 0> Class.Humanoid0> elle sera comprise entre 0 et 1000.

Cette propriété n'est visible que dans la fenêtre propriétés si StarterPlayer.CharacterUseJumpPower est réglé sur true, car ce ne serait pas pertinent sinon.

Puisque cette propriété n'est pertinente que pour les personnages qui apparaissent à l'avenir, le changer n'affectera pas les personnages de joueur existants. Les modifications de cette propriété n'auront effet que lorsqu'un joueur réapparaîtra.

CharacterMaxSlopeAngle

Lecture parallèle

CharacterMaxSlopeAngle détermine la valeur de départ de Humanoid.MaxSlopeAngle pour un joueur의 Class.Player.Character|Character. Il s'agit d'un humanoid qui peut escalader n'importe quelle pente qu'il veuille par défaut. Lorsqu'il est appliqué à Class.Humanoid du joueur, il sera limité entre

Puisque cette propriété n'est pertinente que pour les personnages qui apparaissent à l'avenir, le changer n'affectera pas les personnages de joueur existants. Les modifications de cette propriété n'auront effet que lorsqu'un joueur réapparaîtra.

CharacterUseJumpPower

Lecture parallèle

CharacterUseJumpPower détermine la valeur de départ de Humanoid.UseJumpPower pour un joueur의 Character . Activer/désactiver pour changer la visibilité de la propriété dans la fenêtre des propriétés : 0> Class.St

Puisque cette propriété n'est pertinente que pour les personnages qui apparaissent à l'avenir, le changer n'affectera pas les personnages de joueur existants. Les modifications de cette propriété n'auront effet que lorsqu'un joueur réapparaîtra.

CharacterWalkSpeed

Lecture parallèle

CharacterWalkSpeed détermine la valeur de départ de Humanoid.WalkSpeed pour un joueur의 Character . Cette propriété par défaut est 16.

Puisque cette propriété n'est pertinente que pour les personnages qui apparaissent à l'avenir, le changer n'affectera pas les personnages de joueur existants. Les modifications de cette propriété n'auront effet que lorsqu'un joueur réapparaîtra.

DevCameraOcclusionMode

Lecture parallèle

Définit comment les scripts de caméra par défaut gèrent les objets entre la caméra et le sujet de la caméra. S'applique à tous les joueurs lorsqu'ils rejoignent l'expérience et ne peuvent pas être modifiés pour les joueurs individuels.

La valeur par défaut est Zoom (0). Voir Enum.DevCameraOcclusionMode pour une liste de modes disponibles.

DevComputerCameraMovementMode

Lecture parallèle

La propriété DevComputerCameraMovementMode permet au développeur d'écraser le mode de caméra du joueur si le joueur est sur un ordinateur.

Ceci est la propriété par défaut pour les joueurs qui rejoignent le jeu. Il peut être modifié pour les joueurs individuels en changeant les Player.DevComputerCameraMode .

Si set to UserChoice then the joueur's camera movement mode will be determined by whatever the player set in the game settings. Otherwise, the mode will be set based on this propriété.

Voir Enum.DevComputerCameraMovementMode pour les différents modes de caméra disponibles.

Cette propriété n'a aucun effet sur les joueurs qui ne sont pas sur un ordinateur.

Échantillons de code

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

Lecture parallèle

La propriété DevComputerMovementMove du développeur permet au développeur d'écraser le mode de déplacement du joueur si le joueur est sur un ordinateur.

Ceci est la propriété par défaut pour les joueurs qui rejoignent le jeu. Il peut être modifié pour les joueurs individuels en changeant les Player.DevComputerMovementMode.

Si vous avez défini UserChoice comme valeur, le mode de déplacement du joueur sera déterminé par le joueur lui-même dans les paramètres du jeu. Sinon, le mode sera défini en fonction de cette propriété.

Voir Enum.DevComputerMovementMode pour les différents modes de déplacement disponibles. Permettons aux développeurs d'écraser le mode de déplacement du joueur si le joueur est sur un ordinateur.

Cette propriété n'a aucun effet sur les joueurs qui ne sont pas sur un ordinateur.

Échantillons de code

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

Lecture parallèle

La propriété DevTouchCameraMovementMode du développeur permet au développeur d'écraser le mode de caméra du joueur si le joueur est sur un appareil tactile.

Ceci est la propriété par défaut pour les joueurs qui rejoignent le jeu. Il peut être modifié pour les joueurs individuels en changeant les Player.DevTouchCameraMode .

Si set to UserChoice then the joueur's camera movement mode will be determined by whatever the player set in the game settings. Otherwise, the mode will be set based on this propriété.

Voir Enum.DevTouchCameraMovementMode pour les différents modes de caméra disponibles.

Cette propriété n'a aucun effet sur les joueurs qui ne sont pas sur un appareil mobile.

Échantillons de code

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

Lecture parallèle

La propriété DevTouchMovementMode du développeur permet au développeur d'écraser le mode de déplacement du joueur si le joueur est sur un appareil tactile.

Ceci est la propriété par défaut pour les joueurs qui rejoignent le jeu. Il peut être modifié pour les joueurs individuels en changeant les Player.DevTouchMovementMode .

Si vous avez défini UserChoice comme valeur, le mode de déplacement du joueur sera déterminé par le joueur lui-même dans les paramètres du jeu. Sinon, le mode sera défini en fonction de cette propriété.

Voir Enum.DevTouchMovementMode pour les différents modes de déplacement disponibles. Permettons aux développeurs d'écraser le mode de déplacement du joueur si le joueur est sur un appareil tactile.

Cette propriété n'a aucun effet sur les joueurs qui ne sont pas sur un appareil activé par le toucher.

Échantillons de code

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

Non scriptable
Lecture parallèle

EnableMouseLockOption

Lecture parallèle

La propriété EnableMouseLockOption détermine si un joueur peut activer la verrouillage du mouse par défaut.

Mouselock verrouillera le curseur du joueur au centre de l'écran. En déplaçant la souris, vous ferez pivoter la Camera et la Player et la déplacerez par rapport à la rotation actuelle de la caméra.

Cette propriété définit la valeur de Player.DevEnableMouseLock .

Notez que les API de verrouillage de changement de vitesse sont en cours de marquer comme obsolète, il est donc recommandé d'utiliser UserInputService.MouseBehavior à la place pour verrouiller la souris.

Échantillons de code

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

Lecture parallèle

La propriété HealthDisplayDistance détermine la distance en studs à laquelle ce joueur verra d'autres barres de santé Humanoid. Si elle est réglée sur 0, les barres de santé ne seront pas affichées. Cette propriété est réglée par défaut sur 100 studs.

Pour modifier la distance d'affichage d'un joueur une fois qu'il rejoint le jeu, vous pouvez définir la propriété Player.HealthDisplayDistance.

Si une barre de santé Humanoid est visible, vous pouvez définir le type d'affichage en utilisant Humanoid.DisplayDistanceType.

Échantillons de code

Hiding Player Health and Names

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

LoadCharacterAppearance

Lecture parallèle

La propriété LoadCharacterAppearance détermine si oui ou non la apparence d'un joueurdoit être chargée.

Enregistrer ce paramètre sur false donne lieu à ce que le joueur n'ait pas de vêtements (y compris les chapeaux), les couleurs du corps, les packs du corps ou toute autre chose liée à l'apparence de l'avatar du joueur. Par défaut, cette propriété est réglée sur true.

En définissant ceci sur true, le joueur chargera la forme correspondant à la classe du joueur Player.CharacterAppearanceId.

Si Player:LoadCharacterWithHumanoidDescription() est utilisé, il peut être avantageux de définir StarterPlayer.LoadCharacterAppearance comme faux, car l'avatar du joueur n'est pas requis comme tous les ID de ressources à équiper sur le personnage viendront du passe dans HumanoidDescription.

Échantillons de code

Disabling a Player's Appearance

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

LoadCharacterLayeredClothing

Non répliqué
Non scriptable
Lecture parallèle

Indique si les personnages qui apparaissent dans une expérience auront des accessoires de vêtements imbriqués sur eux (Bien que Workspace.MeshPartHeadsAndAccessories également nécessitent d'être activés dans le Workspace ).

LuaCharacterController

Non navigable
Lecture parallèle

NameDisplayDistance

Lecture parallèle

Définit la distance à laquelle ce joueur verra d'autres noms Humanoid. Si elle est réglée sur 0, les noms sont cachés.

La valeur NomAfficherDistance StarterPlayer détermine la distance en studs à laquelle ce joueur verra d'autres noms Humanoid. Si la valeur est réglée sur 0, les noms sont cachés. Cette valeur est réglée par défaut sur 100 studs.

Pour modifier la distance d'affichage d'un joueur une fois qu'il rejoint le jeu, vous pouvez définir la propriété Player.NameDisplayDistance.

Si un nom Humanoid est visible, vous pouvez définir le type d'affichage en utilisant Humanoid.DisplayDistanceType.

Échantillons de code

Hiding Player Health and Names

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

UserEmotesEnabled

Lecture parallèle

Cette propriété détermine si les emotes appartenant à l'utilisateur sont chargés lors du chargement des avatars. En définissant cette propriété sur false, le chargement est désactivé. Les développeurs peuvent configurer la propriété dans Studio directement ou via le menu Game Settings.

Lorsque le chargement des emotes est désactivé, l'interface des emotes fonctionnera toujours tant que les développeurs choisiront d'utiliser la fonctionnalité emotes en ajoutant des emotes dans leur jeu.

Voir aussi Emotes d'avatar, un article détaillant comment contrôler, personnaliser et jouer aux emotes d'avatar.

Méthodes

Évènements