StarterPlayer
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
Ein Dienst, der die Standardeinstellungen der Eigenschaften im Player -Objekt vorgibt, um sie festlegen. Wenn ein Spieler den Server betritt, wird jede Eigenschaft der Spieler-Objekt auf den aktuellen Wert der entsprechenden Eigenschaft in StarterPlayer festgelegt.
Darüber hinaus können Sie vier Objekte zu diesem Service hinzufügen:
- Eine StarterPlayerScripts Instanz mit Skripten, die einmal für jeden Spieler:inausgeführt werden.
- Eine StarterCharacterScripts Instanz mit Skripten, die jedem Spieler:inzu jedem Spawn hinzugefügt werden.
- Eine Humanoid Instanz namens StarterHumanoid, die als Standard-Humanoid für jeden Spieler:inverwendet wird.
- Eine Model Instanz mit dem Namen StarterCharacter, die als Charaktermodell für alle Spieler verwendet wird.
Zusammenfassung
Eigenschaften
Beschreibt die Berechtigungsebenen des aktuellen Spiels für benutzerdefinierte Avatar-Animationen aus der Website.
Setzt, ob der Charakter automatisch springt, wenn er ein Hindernis auf einem mobilen Gerät trifft.
Die maximale Entfernung, die die Standardkamera des Spieler:inin Klötzen skalieren darf.
Die minimale Entfernung in Studs, in der die Standardkamera des Spieler:invergrößernkann, wird erlaubt.
Ändert den Standardmodus der Kamera auf "Erster" oder "Dritter".
Bestimmt den Startwert von Humanoid.JumpHeight für Player.Character .
Bestimmt den Startwert von Humanoid.JumpPower für Player.Character .
Bestimmt den Startwert von Humanoid.MaxSlopeAngle für Player.Character .
Bestimmt den Startzustand von Humanoid.UseJumpPower für Player.Character .
Bestimmt den Startwert von Humanoid.WalkSpeed für Player.Character .
Setzt, wie die Standardkamera Objekte zwischen der Kamera und dem Spieler:inbehandelt.
Lassen Sie die Entwickler den Standard-Kamera-Modus für jeden Spieler überschreiben, wenn der Spieler auf einem Computer ist.
Lassen Sie den Entwickler den Bewegungsmodus des Spieler:inüberschreiben, wenn der Spieler auf einem Computer ist.
Lassen Sie die Entwickler den Standard-Kameramodus für jeden Spieler überschreiben, wenn der Spieler auf einem mobilen Gerät ist.
Lassen Sie den Entwickler den Bewegungsmodus des Spieler:inüberschreiben, wenn der Spieler auf einem Touch-Gerät ist.
Bestimmt, ob ein Spieler die Mouselock standardmäßig umschalten kann.
Setzt die Entfernung, bei der dieser Spieler andere Humanoid Gesundheitsleisten sieht. Wenn auf 0 gesetzt, werden die Gesundheitsleisten nicht angezeigt.
Ob der Charakter eines Spieler:inangezeigt wird oder nicht.
Zeigt an, ob die Charaktere, die in einem Erlebnis spawnen, mehrere Schichten Kleidung tragen.
Setzt die Entfernung, bei der dieser Spieler andere Humanoid-Namen sieht. Wenn auf 0 gesetzt, werden die Namen ausgeblendet.
Bestimmt, ob benutzerbesessene Emotes geladen werden, wenn Avatare geladen werden.
Eigenschaften
AllowCustomAnimations
Die AllowCustomAnimations-Eigenschaft beschreibt die Berechtigungsebene des aktuellen Spiels in Bezug auf den benutzerdefinierten Avatar Animations von der Website.
Daher kann dieser Wert nicht innerhalb des Spiels geändert werden. Es kann nur durch Änderung der Berechtigungsebene des Spiels innerhalb der Einstellungsseite des Spiels auf der Website geändert werden.
Diese Eigenschaft ist nicht für den Gebrauch im Spiel gedacht.
AutoJumpEnabled
Die AutoJumpEnabled Eigenschaft legt fest, ob der Charakter automatisch springt, wenn er ein Hindernis auf einem mobilen Gerät trifft.
Dieses Eigenschaft wird vom StarterPlayer zu einem Player kopiert, wenn sie dem Spiel beitreten. Danach wird der Wert dieser Eigenschaft in die Humanoid.AutoJumpEnabled Eigenschaft des Charakters auf dem Spawn gesetzt. Mit anderen Worten, es ist möglich, das Auto
Code-Beispiele
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
Die CameraMaxZoomDistance Eigenschaft setzt die maximale Entfernung in Studs, von der die Kamera vom Charakter mit den Standardkameras entfernt sein kann.
Diese Eigenschaft setzt den Standardwert von Player.CameraMaxZoomDistance für jeden Spieler, der dem Spiel beitritt. Wenn dieser Wert unter StarterPlayer.CameraMinZoomDistance festgelegt ist, wird er auf CameraMinZoomDistance erhöht.
Code-Beispiele
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
Die CameraMinZoonDistance Eigenschaft setzt die minimale Entfernung in Studs, von der die Kamera vom Charakter mit den Standardkameras sein kann.
Dieses Eigenschaften setzt den Standardwert von Player.CameraMinZoomDistance für jeden Spieler, der dem Spiel beitritt. Wenn dieser Wert auf einen höheren Wert als StarterPlayer.CameraMaxZoomDistance eingestellt ist, wird er mit CameraMaxZoomDistance verringert.
Code-Beispiele
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
Setzt den Standardwert für Player.CameraMode für jeden Spieler im Spiel. Die Kamera hat zwei Modi:
Erste Person
Im First-Person-Modus, die Kamera des Spieler:inwird vollständig in Zoom geschaltet. Es sei denn, es gibt eine sichtbare GUI mit der GuiButton.Modal Eigenschaft gesetzt auf true, wird die Maus gesperrt und die Kamera des Benutzers wird in Richtung der Maus verschieben.
Dritte Person
Im dritten Person-Modus (Standard), der Charakter kann in der Kamera gesehen werden. Während im dritten Person-Modus auf Roblox:
- Du kannst mit der rechten Maustaste und dem Ziehen um deine Kamera zu drehen, oder mit den Pfeiltasten unten rechts verwenden.
- Wenn Sie Ihre Maus bewegen, ändert sich Ihre Kamera nicht (außer Sie bewegen die Maus zum Ende des Bildschirms).
- Wenn Sie eine der Pfeiltasten drücken, wird der Charakter des Benutzers in die entsprechende Richtung des Schlüsselentsprechen.
- Du kannst ein- und ausblenden.
Code-Beispiele
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 bestimmt den Startwert von Humanoid.JumpHeight für den Charakter eines Spieler:inCharacter. Der Wert dieser Eigenschaft wird standardmäßig auf 7,2 Studio eingestellt.
Dieses Eigenschaft ist nur in dem Eigenschaften-Fenster sichtbar, wenn StarterPlayer.CharacterUseJumpPower auf false eingestellt ist, da es sonst nicht relevant wäre.
Da dieses Eigenschaft nur für Charaktere, die in der Zukunft gespawnt werden, relevant ist, ändert es keine bestehenden Spielercharaktere. Änderungen an dieser Eigenschaft wirken nur, wenn ein Spieler respawns.
CharacterJumpPower
CharacterJumpPower bestimmt den Startwert von Humanoid.JumpPower für den Spieler:in's Character . Der Wert dieser Eigenschaft wird standardmäßig auf 50 gesetzt und wenn auf den Spieler:in's 0> Class.Humanoid0> angewendet, wird er zwischen 0 und 1000 eingeschränkt.
Dieses Eigenschaft ist nur in dem Eigenschaften-Fenster sichtbar, wenn StarterPlayer.CharacterUseJumpPower auf true eingestellt ist, da es sonst nicht relevant wäre.
Da dieses Eigenschaft nur für Charaktere, die in der Zukunft gespawnt werden, relevant ist, ändert es keine bestehenden Spielercharaktere. Änderungen an dieser Eigenschaft wirken nur, wenn ein Spieler respawns.
CharacterMaxSlopeAngle
CharacterMaxSlopeAngle ermittelt den Ausgangswert von Humanoid.MaxSlopeAngle für einen Spieler:inCharacter. Es wird standardmäßig auf 89° eingestellt, sodass Menschenoiden fast jeden Steigungsweg, den sie standardmäßig wollen, erklettern können. Wenn auf das Spieler:in
Da dieses Eigenschaft nur für Charaktere, die in der Zukunft gespawnt werden, relevant ist, ändert es keine bestehenden Spielercharaktere. Änderungen an dieser Eigenschaft wirken nur, wenn ein Spieler respawns.
CharacterUseJumpPower
CharacterUseJumpPower bestimmt den Startwert von Humanoid.UseJumpPower für den Character eines Spieler:in. Wenn Sie es umstellen, ändert sich die sichtbare Eigenschaft in dem Eigenschaften-Fenster:
Da dieses Eigenschaft nur für Charaktere, die in der Zukunft gespawnt werden, relevant ist, ändert es keine bestehenden Spielercharaktere. Änderungen an dieser Eigenschaft wirken nur, wenn ein Spieler respawns.
CharacterWalkSpeed
CharacterWalkSpeed bestimmt den Startwert von Humanoid.WalkSpeed für einen Spieler:inCharacter . Diese Eigenschaft wird standardmäßig auf 16 gesetzt.
Da dieses Eigenschaft nur für Charaktere, die in der Zukunft gespawnt werden, relevant ist, ändert es keine bestehenden Spielercharaktere. Änderungen an dieser Eigenschaft wirken nur, wenn ein Spieler respawns.
DevCameraOcclusionMode
Definiert, wie die Standardkamera-Skripte Objekte zwischen der Kamera und dem Kamera-Subjekt behandeln. Gilt für alle Spieler, die sich der Erfahrung anschließen und kann nicht für einzelne Spieler geändert werden.
Der Standardwert ist Zoom (0). Siehe Enum.DevCameraOcclusionMode für eine Liste der verfügbaren Modi.
DevComputerCameraMovementMode
Die DevComputerCameraMovementMode-Eigenschaft ermöglicht es dem Entwickler, den Kameramodus des Spieler:inauf einem Computer zu überschreiben, wenn der Spieler auf einem Computer ist.
Dies ist die Standard属性 für Spieler, die dem Spiel beitreten. Es kann für einzelne Spieler durch die Einstellungen des Player.DevComputerCameraMode geändert werden.
Wenn auf UserChoice eingestellt, wird der Kameramodus des Spieler:indann von den Spielereinstellungen bestimmt, was sonst der Modus basierend auf dieser Eigenschaftenist.
Siehe Enum.DevComputerCameraMovementMode für die verschiedenen Kameramodi, die verfügbar sind.
Diese Eigenschaft hat keinen Einfluss auf Spieler, die kein Computer sind.
Code-Beispiele
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
Die DevComputerMovementMove-Eigenschaft ermöglicht es dem Entwickler, den Bewegungsmodus des Spieler:inauf einem Computer zu überschreiben, wenn der Spieler auf einem Computer ist.
Dies ist die Standard属性 für Spieler, die dem Spiel beitreten. Es kann für einzelne Spieler durch die Einstellungen des Player.DevComputerMovementMode geändert werden.
Wenn auf UserChoice eingestellt, wird der Bewegungsmodus des Spieler:invon der Spielereinstellung bestimmt, die der Spieler in der Spielanpassung festgelegt hat. Andernfalls wird der Modus basierend auf dieser Eigenschaftenfestgelegt.
Siehe Enum.DevComputerMovementMode für die verschiedenen Bewegungsmodi, die verfügbar sind. Lassen Sie die Entwickler den Bewegungsmodus des Spieler:inüberschreiben, wenn der Spieler auf einem Computer ist.
Diese Eigenschaft hat keinen Einfluss auf Spieler, die kein Computer sind.
Code-Beispiele
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
Die DevTouchCameraMovementMode-Eigenschaft ermöglicht es dem Entwickler, den Kameramodus des Spieler:inzu überschreiben, wenn der Spieler auf einem Touch-Gerät ist.
Dies ist die Standard属性 für Spieler, die dem Spiel beitreten. Es kann für einzelne Spieler durch die Einstellungen des Player.DevTouchCameraMode geändert werden.
Wenn auf UserChoice eingestellt, wird der Kameramodus des Spieler:invon den Spielereinstellungen bestimmt, die der Spieler in der Spielanleitung festgelegt hat. Andernfalls wird der Modus basierend auf dieser Eigenschaftenfestgelegt.
Siehe Enum.DevTouchCameraMovementMode für die verschiedenen Kameramodi, die verfügbar sind.
Diese Eigenschaft hat keinen Einfluss auf Spieler, die nicht auf einem mobilen Gerät sind.
Code-Beispiele
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
Die DevTouchMovementMode-Eigenschaft ermöglicht es dem Entwickler, den Bewegungsmodus des Spieler:inzu überschreiben, wenn der Spieler auf einem Touch-Gerät ist.
Dies ist die Standard属性 für Spieler, die dem Spiel beitreten. Es kann für einzelne Spieler durch die Einstellungen des Player.DevTouchMovementMode geändert werden.
Wenn auf UserChoice eingestellt, wird der Bewegungsmodus des Spieler:indurch das Setzen der Spieleinstellungen des Spielers bestimmt. Andernfalls wird der Modus basierend auf dieser Eigenschaftenfestgelegt.
Siehe Enum.DevTouchMovementMode für die verschiedenen Bewegungsmodi, die verfügbar sind. Lassen Sie die Entwickler den Bewegungsmodus des Spieler:inüberschreiben, wenn der Spieler auf einem Touch-Gerät ist.
Diese Eigenschaft hat keinen Einfluss auf Spieler, die nicht auf einem touch-fähigen Gerät sind.
Code-Beispiele
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
Die EnableMouseLockOption Eigenschaft bestimmt, ob ein Spieler die Maus-Sperre standardmäßig aktivieren kann.
Mouselock wird den Cursor des Spieler:inauf die Mitte des Bildschirms zentrieren. Wenn Sie die Maus bewegen, drehen sich die Camera und Player um die aktuelle Rotation der Kamera.
Dieses Eigenschaften setzt den Wert von Player.DevEnableMouseLock .
Beachten Sie, dass geschaltet-lock-bezogene APIs im Prozess der als veraltet kennzeichnen / nicht mehr unterstützensind, so empfehlen wir, UserInputService.MouseBehavior anstelle, um die Maus zu sperren.
Code-Beispiele
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
Die HealthDisplayDistance Eigenschaft legt die Entfernung in Studs fest, bei der dieser Spieler andere Humanoid Gesundheitsleisten sieht. Wenn auf 0 gesetzt, werden die Gesundheitsleisten nicht angezeigt. Diese Eigenschaft wird standardmäßig auf 100 Studs eingestellt.
Um die Anzeigungsreichweite für einen Spieler zu ändern, sobald sie dem Spiel beitreten, kannst du die Player.HealthDisplayDistance Eigenschafteneinstellen.
Wenn eine Humanoid Gesundheitsleiste sichtbar ist, können Sie den Anzeigetyp mit Humanoid.DisplayDistanceType einstellen.
Code-Beispiele
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
Die LoadCharacterAppearance Eigenschaft legt fest, ob der Charakter eines Spieler:inaussehen soll oder nicht geladen werden soll.
Dies auf false setzt das Ergebnis darin, dass der Spieler keine Kleidung (einschließlich Hüte), Körperfarben, Körperpackungen oder irgendetwas anderes, das der Erscheinung des Spieler:inverwendet, hat. Standardmäßig ist diese Eigenschaft auf true eingestellt.
Durch das Festlegen dieser auf true Ergebnisse im Spieler, der die Erscheinung entsprechend der Spieler:inClass.Player.Character laden wird.
Wenn Player:LoadCharacterWithHumanoidDescription() verwendet wird, kann es vorteilhaft sein, StarterPlayer.LoadCharacterAppearance auf false zu setzen, da der Avatar des Spieler:innicht als alle Asset-IDs ausgerüstet werden, wenn auf dem Charakter der HumanoidDescription übergehen.
Code-Beispiele
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
Zeigt an, ob die Charaktere, die in einem Erlebnis spawnen, mehrere Schichten Kleidung tragen (obwohl Workspace.MeshPartHeadsAndAccessories auch in der Workspace aktiviert sein muss).
LuaCharacterController
NameDisplayDistance
Setzt die Entfernung, bei der dieser Spieler andere Humanoid-Namen sieht. Wenn auf 0 gesetzt, werden die Namen ausgeblendet.
Der NameAnzeigungs距anz StarterPlayer Eigenschaft setzt die Entfernung in Studs, bei der dieser Spieler andere Humanoid-Namen sehen wird. Wenn auf 0 gesetzt, werden die Namen ausgeblendet. Diese Eigenschaft wird standardmäßig auf 100 Studs gesetzt.
Um die Anzeigesdistanz für einen Spieler einmal beizutreten, kannst du die Player.NameDisplayDistance Eigenschafteneinstellen.
Wenn ein Humanoid Name sichtbar ist, können Sie den Anzeigetyp mit Humanoid.DisplayDistanceType einstellen.
Code-Beispiele
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
Dieses Eigenschaft bestimmt, ob Benutzer-Emotes geladen werden, wenn Benutzer-Avatare geladen werden. Setzen Sie diese Eigenschaft auf false, deaktivieren Sie das Laden. Entwickler können das Eigenschaft in Studio direkt oder durch das Spiel Einstellungen-Menü einstellen.
Wenn die Emote-Ladung deaktiviert ist, funktioniert die Emote-Benutzeroberfläche immer noch, solange die Entwickler entscheiden, die Emote-Funktion zu verwenden, indem sie Emotes in ihrem Spiel hinzufügen.
Siehe auch Avatar-Emotes, ein Artikel, der detailliert beschreibt, wie man Avatar-Emotes steuern, gestalten/anpassenund spielen kann.