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 de configurerles valeurs par défaut des propriétés dans l'objet Player .Lorsqu'un joueur entre sur le serveur, chaque propriété de l'objet joueur est définie 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 au personnage de chaque joueur à chaque fois qu'ils régénération, apparition.
  • Une instance Humanoid nommée StarterHumanoid qui sera utilisée comme humanoid par défaut pour le personnage de chaque joueur.
  • Une instance Model nommée StarterCharacter qui sera utilisée comme modèle de caractère pour tous les joueurs.

Résumé

Propriétés

Propriétés

AllowCustomAnimations

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

Cette propriété décrit les niveaux d'autorisation du jeu actuel en matière d'avatar personnalisé Animations à partir du site Web.

En tant que tel, cette valeur ne peut pas être modifiée à l'intérieur du jeu.Il ne peut être modifié que en modifiant les niveaux d'autorisation du jeu dans la page des paramètres du jeu sur le site Web.

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

AutoJumpEnabled

Lecture parallèle

Cette propriété détermine si le personnage sautera automatiquement lorsqu'il heurtera un obstacle sur un appareil mobile.

Cette propriété est copiée de la StarterPlayer à une Player lorsqu'ils rejoignent le jeu.Après cela.la valeur de cette propriété est copiée à la propriété Humanoid.AutoJumpEnabled de la caractéristique du personnage Humanoid au moment du régénération, apparition.En d'autres termes, il est possible de définir le comportement de saut automatique sur une base par caractère, par joueur et par jeu en utilisant ces trois propriétés.

É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

Cette propriété définit la distance maximale en studs que 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.CameraMaxZoomDistance pour chaque joueur qui rejoint le jeu.Si cette valeur est définie sur une valeur inférieure à StarterPlayer.CameraMinZoomDistance, elle sera augmentée à 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

Cette propriété définit la distance minimale en studs à 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 sur une valeur supérieure à 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 jusqu'au bout.À moins qu'il n'y ait une interface visuelle présente avec la propriété GuiButton.Modal définie sur true , la souris sera verrouillée et la caméra de l'utilisateur se tournera lorsque la souris se déplace.

3e personne

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

  • Vous pouvez faire un clic droit et faire glisser pour faire pivoter votre caméra, ou utiliser les flèches des touches en bas à droite de l'écran.
  • Lorsque vous déplacez votre souris, votre caméra ne change pas (à moins que vous ne déplaciez la souris jusqu'à la fin de l'écran).
  • Lorsque vous appuyez sur l'une des touches fléchées, le caractère de l'utilisateur se dirigera dans la direction de la cléfléchée correspondante.
  • Vous pouvez zoomer et dézoomer 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

Cette propriété détermine la valeur de départ de Humanoid.JumpHeight pour un joueur de Player.Character . La valeur de cette propriété est réinitialisée à 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 elle ne serait pas pertinente autrement.

Puisque cette propriété n'est pertinente que pour les personnages générés à l'avenir, la changer ne changera pas les personnages de joueur existants.Les modifications de cette propriété n'auront lieu que lorsqu'un joueur réapparaîtra.

CharacterJumpPower

Lecture parallèle

Cette propriété détermine la valeur de départ de Humanoid.JumpPower pour un joueur de Player.Character.La valeur de cette propriété est définie par défaut à 50 et lorsqu'elle est appliquée à la Humanoid du joueur, 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 elle ne serait pas pertinente autrement.

Puisque cette propriété n'est pertinente que pour les personnages générés à l'avenir, la changer ne changera pas les personnages de joueur existants.Les modifications de cette propriété n'auront lieu que lorsqu'un joueur réapparaîtra.

CharacterMaxSlopeAngle

Lecture parallèle

Cette propriété détermine la valeur de départ de Humanoid.MaxSlopeAngle pour un joueur de Player.Character.Il se définit par défaut sur 89°, de sorte que les humanoïdes peuvent escalader pratiquement n'importe quelle pente qu'ils souhaitent par défaut.Lorsqu'il est appliqué à la Humanoid, il sera contraint entre 0 et 89.

Puisque cette propriété n'est pertinente que pour les personnages générés à l'avenir, la changer ne changera pas les personnages de joueur existants.Les modifications de cette propriété n'auront lieu 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 de Player.Character .Le basculer changera la propriété visible dans la fenêtre des propriétés : CharacterJumpHeight (faux) ou StarterPlayer.CharacterJumpPower (vrai).Par défaut à vrai.

Puisque cette propriété n'est pertinente que pour les personnages générés à l'avenir, la changer ne changera pas les personnages de joueur existants.Les modifications de cette propriété n'auront lieu que lorsqu'un joueur réapparaîtra.

CharacterWalkSpeed

Lecture parallèle

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

Puisque cette propriété n'est pertinente que pour les personnages générés à l'avenir, la changer ne changera pas les personnages de joueur existants.Les modifications de cette propriété n'auront lieu que lorsqu'un joueur réapparaîtra.

ClassicDeath

Non navigable
Lecture parallèle

DevCameraOcclusionMode

Lecture parallèle

Définit la manière dont 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 peut pas être modifié pour les joueurs individuels.

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

DevComputerCameraMovementMode

Lecture parallèle

Cette propriété permet au développeur de remplacer le mode de caméra du joueur si le joueur est sur un ordinateur.

C'est la propriété par défaut pour les joueurs qui rejoignent le jeu. Elle peut être modifiée pour les joueurs individuels en configurant le Player.DevComputerCameraMode.

Si la valeur est définie sur UserChoice, le mode de déplacement de la caméra du joueur sera déterminé par ce que le joueur a défini dans les paramètres du jeu.Sinon, le mode sera défini en fonction de cette propriété.

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

Cette propriété n'a aucun effet sur les joueurs non 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

Cette propriété permet au développeur de remplacer le mode de déplacement du joueur si le joueur est sur un ordinateur.

C'est la propriété par défaut pour les joueurs qui rejoignent le jeu. Elle peut être modifiée pour les joueurs individuels en configurant le Player.DevComputerMovementMode.

Si la valeur est définie sur UserChoice, le mode de déplacement du joueur sera déterminé par ce que le joueur a défini 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 mouvement disponibles. Permettons au développeur d'écraser le mode de mouvement du joueur si le joueur est sur un ordinateur.

Cette propriété n'a aucun effet sur les joueurs non 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

Cette propriété permet au développeur de remplacer le mode de caméra du joueur s'il est sur un appareil tactile.

C'est la propriété par défaut pour les joueurs qui rejoignent le jeu. Elle peut être modifiée pour les joueurs individuels en configurant le Player.DevTouchCameraMode.

Si la valeur est définie sur UserChoice, le mode de déplacement de la caméra du joueur sera déterminé par ce que le joueur a défini dans les paramètres du jeu.Sinon, le mode sera défini en fonction de cette 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

Cette propriété permet au développeur de remplacer le mode de déplacement du joueur si le joueur est sur un appareil tactile.

C'est la propriété par défaut pour les joueurs qui rejoignent le jeu. Elle peut être modifiée pour les joueurs individuels en configurant le Player.DevTouchMovementMode.

Si la valeur est définie sur UserChoice, le mode de déplacement du joueur sera déterminé par ce que le joueur a défini 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 mouvement disponibles. Permettons au développeur d'écraser le mode de mouvement 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 tactile activé.

É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

Cette propriété détermine si un joueur peut basculer la verrouillage de la souris par défaut.

Mouselock verrouillera le curseur du joueur au centre de l'écran.Déplacer la souris fera pivoter le Camera et le Player se déplacera par rapport à la rotation actuelle de la caméra.

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

Notez que les API liées au verrouillage de la touche de changement de page sont en train d'être 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

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

Pour modifier la distance d'affichage pour 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

Cette propriété détermine si l'apparence du personnage d'un joueur doit être chargée ou non.

Définir ceci à false provoque le fait que le joueur n'ait pas de vêtements (y compris des chapeaux), de couleurs du corps, de packages de corps ou de tout autre élément lié à l'apparence de l'avatar du joueur.Par défaut, cette propriété est définie à true .

Définir ceci à true provoque le chargement de l'apparence correspondant à l'apparence du joueur Player.CharacterAppearanceId.

Si Player:LoadCharacterWithHumanoidDescription() est utilisé, il peut être avantageux de définir StarterPlayer.LoadCharacterAppearance sur false car l'avatar du joueur n'est pas nécessaire car toutes les ID d'actifs à équiper sur le personnage proviendront du passe en 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 porteront des accessoires de vêtements en couches sur eux (bien que Workspace.MeshPartHeadsAndAccessories doivent également ê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 la valeur est définie à 0, les noms sont cachés.Cette propriété est définie par défaut à 100 studs.

Pour modifier la distance d'affichage pour 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

RagdollDeath

Non navigable
Lecture parallèle

UserEmotesEnabled

Lecture parallèle

Cette propriété détermine si les emotes appartenant à l'utilisateur sont chargées lors du chargement des avatars.Définir cette propriété sur false désactive le chargement.Les développeurs peuvent définir la propriété dans Studio directement ou via le menu Paramètres de jeu.

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

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

Méthodes

Évènements