StarterPlayer

Veraltete anzeigen

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Nicht erstellbar
Dienst

Ein Service, der es ermöglicht, die Standardwerte von Eigenschaften im Player Objekt festlegen.Wenn ein Spieler den Server betritt, wird jedes Eigenschaft des Spielerobjekts auf den aktuellen Wert der entsprechenden Eigenschaft in StarterPlayer gesetzt.

Zusätzlich können Sie vier Objekte zu diesem Service hinzufügen:

  • Eine StarterPlayerScripts.
  • Eine StarterCharacterScripts Instanz mit Skripten, die jedes Mal zum Charakter eines Spieler:inhinzugefügt werden, wenn er Spawn.
  • Eine Instanz namens , die als Standard-Humanoide für den Charakter jedes Spieler:inverwendet wird.
  • Eine Instanz namens , die als Charaktermodell für alle Spieler verwendet wird.

Zusammenfassung

Eigenschaften

Alles Geerbte von Instance anzeigen
Alles Geerbte von Object anzeigen

Eigenschaften

AllowCustomAnimations

boolean
Verborgen
Roblox-Skript-Sicherheit
Parallel lesen

Diese Eigenschaft beschreibt die aktuellen Berechtigungsstufen des aktuellen Spiels in Bezug auf den benutzerdefinierten Avatar Animations von der Website.

Daher kann dieser Wert nicht von innerhalb des Spiels geändert werden.Es kann nur geändert werden, indem die Berechtigungsstufen des Spiels auf der Einstellungsseite der Website geändert werden.

Diese Eigenschaft ist nicht für die Verwendung im Spiel gedacht.

AutoJumpEnabled

boolean
Parallel lesen

Diese Eigenschaft legt fest, ob der Charakter automatisch springt, wenn er ein Hindernis auf einem mobilen Gerät trifft.

Diese Eigenschaft wird von der StarterPlayer bis zur Player kopiert, wenn sie dem Spiel beitreten.Danach.Der Wert dieser Eigenschaft wird auf die Eigenschaft Humanoid.AutoJumpEnabled des Charakters von Humanoid beim Spawn kopiert.Mit anderen Worten, es ist möglich, das Auto-Sprungverhalten auf einer pro-Zeichen-, pro-Spieler- und pro-Spiel-Basis mit diesen drei Eigenschaften einzustellen.

Code-Beispiele

Dieses Codebeispiel ist für einen TextButton gedacht. Es ermöglicht dem Spieler, das automatische Sprungverhalten auf einem mobilen Gerät umzuschalten.

Auto-Sprung umschalten
local Players = game:GetService("Players")



local player = Players.LocalPlayer

local button = script.Parent



local function update()

	-- Aktualisierungstext des Buttons

	if player.AutoJumpEnabled then

		button.Text = "Auto-Jump is ON"

	else

		button.Text = "Auto-Jump is OFF"

	end

	-- Spiegel die Eigenschaft im Charakter des Spielers wider, wenn er eine hat

	if player.Character then

		local human = player.Character:FindFirstChild("Humanoid")

		if human then

			human.AutoJumpEnabled = player.AutoJumpEnabled

		end

	end

end



local function onActivated()

	-- Auto-Sprung umschalten

	player.AutoJumpEnabled = not player.AutoJumpEnabled

	-- Aktualisiere alles andere

	update()

end



button.Activated:Connect(onActivated)

update()

AvatarJointUpgrade

Enum.RolloutState
Nicht repliziert
Nicht skriptfähig
Nicht durchsuchbar
Parallel lesen

CameraMaxZoomDistance

number
Parallel lesen

Diese Eigenschaft legt die maximale Entfernung in Studs fest, von der die Kamera vom Charakter mit den Standardkameras entfernt sein kann.

Diese Eigenschaft legt den Standardwert von Player.CameraMaxZoomDistance für jeden Spieler fest, der dem Spiel beitritt.Wenn dieser Wert auf einen niedrigeren Wert als StarterPlayer.CameraMinZoomDistance festgelegt wird, 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.

Setting Camera Zoom Distance
local Players = game:GetService("Players")



local player = Players.LocalPlayer



player.CameraMaxZoomDistance = 50

player.CameraMinZoomDistance = 75

CameraMinZoomDistance

number
Parallel lesen

Diese Eigenschaft legt die minimale Entfernung in Studs fest, von der die Kamera vom Charakter mit den Standardkameras entfernt sein kann.

Diese Eigenschaft legt den Standardwert von Player.CameraMinZoomDistance für jeden Spieler fest, der dem Spiel beitritt.Wenn dieser Wert auf einen höheren Wert als StarterPlayer.CameraMaxZoomDistance festgelegt wird, wird er auf 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.

Setting Camera Zoom Distance
local Players = game:GetService("Players")



local player = Players.LocalPlayer



player.CameraMaxZoomDistance = 50

player.CameraMinZoomDistance = 75

CameraMode

Enum.CameraMode
Parallel lesen

Legt den Standardwert für Player.CameraMode für jeden Spieler im Spiel fest. Die Kamera hat zwei Modi:

Erste Person

Im Modus der ersten Person ist die Kamera des Spieler:inso weit wie möglich herangezoomt.Es sei denn, es gibt eine sichtbare GUI mit der Eigenschaft GuiButton.Modal , die auf true gesetzt ist, wird die Maus gesperrt und die Kamera des Benutzers dreht sich, wenn die Maus sich bewegt.

Dritte Person

Im dritten Person Modus (Standard) kann der Charakter in der Kamera gesehen werden. Während im dritten Person Modus auf Roblox:

  • Du kannst mit der rechten Maustaste und ziehen, um deine Kamera zu drehen, oder die Pfeiltasten in der rechten unteren Ecke des Bildschirms verwenden.
  • Wenn du deine Maus bewegst, ändert sich deine Kamera nicht (es sei denn, du bewegst die Maus zum Ende des Bildschirms).
  • Wenn du eine der Pfeiltasten drückst, wird sich der Charakter des Benutzers in die entsprechende Richtung des Schlüsselbewegen.
  • Du kannst frei ein- und auszoomen.

Code-Beispiele

This example demonstrates how to change the character's CameraMode to first person using the LockFirstPerson value of the Enum.CameraMode enum.

Playing in First Person
local Players = game:GetService("Players")



local player = Players.LocalPlayer



player.CameraMode = Enum.CameraMode.LockFirstPerson

CharacterJumpHeight

number
Parallel lesen

Diese Eigenschaft legt den Startwert von Humanoid.JumpHeight für einen Spieler:inPlayer.Character fest. Der Wert dieser Eigenschaft wird auf 7,2 Stollen zurückgesetzt.

Diese Eigenschaft ist nur im Eigenschaften-Fenster sichtbar, wenn StarterPlayer.CharacterUseJumpPower auf false gesetzt ist, da sie sonst nicht relevant wäre.

Da diese Eigenschaft nur für Charaktere relevant ist, die in der Zukunft gespawnt werden, ändert sich ihre Änderung nicht auf vorhandene Spielercharaktere.Änderungen an dieser Eigenschaft werden erst dann wirksam, wenn ein Spieler respawniert.

CharacterJumpPower

number
Parallel lesen

Diese Eigenschaft legt den Startwert von Humanoid.JumpPower für einen Spieler:inPlayer.Character fest.Der Wert dieser Eigenschaft wird auf 50 festgelegt und wenn er auf das Humanoid des Spieler:inangewendet wird, wird er zwischen 0 und 1000 eingeschränkt.

Diese Eigenschaft ist nur im Eigenschaften-Fenster sichtbar, wenn StarterPlayer.CharacterUseJumpPower auf true gesetzt ist, da sie sonst nicht relevant wäre.

Da diese Eigenschaft nur für Charaktere relevant ist, die in der Zukunft gespawnt werden, ändert sich ihre Änderung nicht auf vorhandene Spielercharaktere.Änderungen an dieser Eigenschaft werden erst dann wirksam, wenn ein Spieler respawniert.

CharacterMaxSlopeAngle

number
Parallel lesen

Diese Eigenschaft legt den Startwert von Humanoid.MaxSlopeAngle für einen Spieler:inPlayer.Character fest.Es wird standardmäßig auf 89° eingestellt, so dass Humanoide im Grunde jede Steigung klettern können, die sie wollen.Wenn es auf das Spiel des Spieler:inangewendet wird, wird es zwischen 0 und 89 eingeschränkt.

Da diese Eigenschaft nur für Charaktere relevant ist, die in der Zukunft gespawnt werden, ändert sich ihre Änderung nicht auf vorhandene Spielercharaktere.Änderungen an dieser Eigenschaft werden erst dann wirksam, wenn ein Spieler respawniert.

CharacterUseJumpPower

boolean
Parallel lesen

CharacterUseJumpPower legt den Startwert von Humanoid.UseJumpPower für einen Spieler:inPlayer.Character fest.Das Umschalten wird ändern, welche Eigenschaft im Eigenschaften-Fenster sichtbar ist: CharacterJumpHeight (falsch) oder StarterPlayer.CharacterJumpPower (wahr).Standard ist auf wahr.

Da diese Eigenschaft nur für Charaktere relevant ist, die in der Zukunft gespawnt werden, ändert sich ihre Änderung nicht auf vorhandene Spielercharaktere.Änderungen an dieser Eigenschaft werden erst dann wirksam, wenn ein Spieler respawniert.

CharacterWalkSpeed

number
Parallel lesen

Diese Eigenschaft legt den Startwert von Humanoid.WalkSpeed für einen Spieler:inPlayer.Character fest. Diese Eigenschaft wird standardmäßig auf 16 festgelegt.

Da diese Eigenschaft nur für Charaktere relevant ist, die in der Zukunft gespawnt werden, ändert sich ihre Änderung nicht auf vorhandene Spielercharaktere.Änderungen an dieser Eigenschaft werden erst dann wirksam, wenn ein Spieler respawniert.

ClassicDeath

boolean
Nicht durchsuchbar
Parallel lesen

DevCameraOcclusionMode

Enum.DevCameraOcclusionMode
Parallel lesen

Legt fest, wie die Standard-Kamera-Skripte Objekte zwischen der Kamera und dem Kamerathema handhaben.Gilt für alle Spieler, wenn sie sich dem Erlebnis anschließen, und kann für einzelne Spieler nicht geändert werden.

Der Standardwert ist Zoom (0). Siehe Enum.DevCameraOcclusionMode für eine Liste der verfügbaren Modi.

DevComputerCameraMovementMode

Enum.DevComputerCameraMovementMode
Parallel lesen

Diese Eigenschaft lässt den Entwickler den Kameramodus des Spieler:inüberschreiben, wenn der Spieler auf einem Computer ist.

Dies ist die Standard-Eigenschaft für Spieler, die dem Spiel beitreten. Sie kann für einzelne Spieler durch die Einstellung der Player.DevComputerCameraMode geändert werden.

Wenn auf UserChoice gesetzt, wird der Kamerabewegungsmodus des Spieler:indurch das bestimmt, was der Spieler in den Spieleinstellungen festgelegt hat.Andernfalls wird der Modus basierend auf dieser Eigenschaftenfestgelegt.

Siehe Enum.DevComputerCameraMovementMode für die verfügbaren verschiedenen Kameramodi.

Diese Eigenschaft hat keine Auswirkung auf Spieler, die nicht auf einem 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.

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

Enum.DevComputerMovementMode
Parallel lesen

Diese Eigenschaft lässt den Entwickler den Bewegungsmodus des Spieler:inüberschreiben, wenn der Spieler auf einem Computer ist.

Dies ist die Standard-Eigenschaft für Spieler, die dem Spiel beitreten. Sie kann für einzelne Spieler durch die Einstellung der Player.DevComputerMovementMode geändert werden.

Wenn auf UserChoice gesetzt, wird der Bewegungsmodus des Spieler:indurch das bestimmt, was der Spieler in den Spieleinstellungen festgelegt hat.Andernfalls wird der Modus basierend auf dieser Eigenschaftenfestgelegt.

Siehe Enum.DevComputerMovementMode für die verfügbaren verschiedenen Bewegungsmodi. Lassen Sie den Entwickler den Bewegungsmodus des Spieler:inüberschreiben, wenn der Spieler an einem Computer ist.

Diese Eigenschaft hat keine Auswirkung auf Spieler, die nicht auf einem Computer sind.

Code-Beispiele

Demonstrates how to set the movement mode for players on computers using the Player.DevComputerMovementMode property.

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

Enum.DevTouchCameraMovementMode
Parallel lesen

Diese Eigenschaft lässt den Entwickler den Kameramodus des Spieler:inüberschreiben, wenn der Spieler auf einem Gerätist.

Dies ist die Standard-Eigenschaft für Spieler, die dem Spiel beitreten. Sie kann für einzelne Spieler durch die Einstellung der Player.DevTouchCameraMode geändert werden.

Wenn auf UserChoice gesetzt, wird der Kamerabewegungsmodus des Spieler:indurch das bestimmt, was der Spieler in den Spieleinstellungen festgelegt hat.Andernfalls wird der Modus basierend auf dieser Eigenschaftenfestgelegt.

Siehe Enum.DevTouchCameraMovementMode für die verfügbaren verschiedenen Kameramodi.

Diese Eigenschaft hat keine Auswirkung 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.

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

Enum.DevTouchMovementMode
Parallel lesen

Diese Eigenschaft lässt den Entwickler den Bewegungsmodus des Spieler:inüberschreiben, wenn der Spieler auf einem Gerätist.

Dies ist die Standard-Eigenschaft für Spieler, die dem Spiel beitreten. Sie kann für einzelne Spieler durch die Einstellung der Player.DevTouchMovementMode geändert werden.

Wenn auf UserChoice gesetzt, wird der Bewegungsmodus des Spieler:indurch das bestimmt, was der Spieler in den Spieleinstellungen festgelegt hat.Andernfalls wird der Modus basierend auf dieser Eigenschaftenfestgelegt.

Siehe Enum.DevTouchMovementMode für die verfügbaren verschiedenen Bewegungsmodi. Lassen Sie den Entwickler den Bewegungsmodus des Spieler:inüberschreiben, wenn der Spieler auf einem Gerätist.

Diese Eigenschaft hat keine Auswirkung auf Spieler, die nicht auf einem touch-aktivierten 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.

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

Enum.LoadDynamicHeads
Nicht skriptfähig
Parallel lesen

EnableMouseLockOption

boolean
Parallel lesen

Diese Eigenschaft bestimmt, ob ein Spieler die Mausverriegelung standardmäßig umschalten kann.

Mouselock sperrt den Cursor des Spieler:inin der Mitte des Bildschirms.Das Bewegen der Maus dreht die Camera und Player wird sich relativ zur aktuellen Rotation der Kamera bewegen.

Diese Eigenschaft legt den Wert von Player.DevEnableMouseLock fest.

Beachte, dass API-Schnittstellen, die Shift-Lock verwenden, im Prozess sind, als veraltet kennzeichnen / nicht mehr unterstützenzu werden, daher wird empfohlen, stattdessen UserInputService.MouseBehavior zu verwenden, 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.

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

number
Parallel lesen

Diese Eigenschaft legt die Entfernung in Klötzen fest, auf die dieser Spieler andere Humanoid Gesundheitsbalken sehen wird.Wenn auf 0 gesetzt, werden die Gesundheitsbalken nicht angezeigt.Diese Eigenschaft wird standardmäßig auf 100 Stollen eingestellt.

Um die Anzeigedistanz für einen Spieler zu ändern, sobald er dem Spiel beitritt, kannst du die EigenschaftenPlayer.HealthDisplayDistance festlegen.

Wenn eine Humanoid Gesundheitsleiste sichtbar ist, kannst du den Anzeigetyp mit Humanoid.DisplayDistanceType festlegen.

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.

Hiding Player Health and Names
local Players = game:GetService("Players")



local player = Players.LocalPlayer



player.HealthDisplayDistance = 0

player.NameDisplayDistance = 0

LoadCharacterAppearance

boolean
Parallel lesen

Diese Eigenschaft legt fest, ob das Aussehen eines Spieler:ingeladen werden soll oder nicht.

Das Festlegen auf false führt dazu, dass der Spieler keine Kleidung (einschließlich Hüte), Körperfarben, Körperpakete oder sonstiges im Zusammenhang mit dem Aussehen des Avatars des Spieler:inhat.Standardmäßig wird diese Eigenschaft auf true festgelegt.

Das Festlegen auf true führt dazu, dass der Spieler das Aussehen entsprechend dem Aussehen des Spieler:inPlayer.CharacterAppearanceId lädt.

Wenn Player:LoadCharacterWithHumanoidDescription() verwendet wird, kann es vorteilhaft sein, StarterPlayer.LoadCharacterAppearance auf false festzulegen, da der Avatar des Spieler:innicht erforderlich ist, da alle Asset-IDs, die auf den Charakter ausgerüstet werden, aus dem übergebenen HumanoidDescription stammen.

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.

Disabling a Player's Appearance
local Players = game:GetService("Players")



local player = Players.LocalPlayer



player.CanLoadCharacterAppearance = false

LoadCharacterLayeredClothing

Enum.LoadCharacterLayeredClothing
Nicht repliziert
Nicht skriptfähig
Parallel lesen

Zeigt an, ob Charaktere, die in ein Erlebnis spawnen, mit mehrschichtigen Kleidungsaccessoires ausgestattet sein werden (obwohl Workspace.MeshPartHeadsAndAccessories auch aktiviert werden muss in der Workspace ).

LuaCharacterController

Enum.CharacterControlMode
Nicht durchsuchbar
Parallel lesen

NameDisplayDistance

number
Parallel lesen

Legt die Entfernung fest, in der dieser Spieler andere Humanoid Namen sehen wird.Wenn auf 0 festgelegt, werden Namen versteckt.Diese Eigenschaft wird standardmäßig auf 100 Stollen eingestellt.

Um die Anzeigedistanz für einen Spieler zu ändern, sobald er dem Spiel beitritt, kannst du die EigenschaftenPlayer.NameDisplayDistance festlegen.

Wenn ein Humanoid Name sichtbar ist, kannst du den Anzeigetyp mit Humanoid.DisplayDistanceType festlegen.

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.

Hiding Player Health and Names
local Players = game:GetService("Players")



local player = Players.LocalPlayer



player.HealthDisplayDistance = 0

player.NameDisplayDistance = 0

RagdollDeath

boolean
Nicht durchsuchbar
Parallel lesen

UserEmotesEnabled

boolean
Parallel lesen

Diese Eigenschaft bestimmt, ob benutzerdefinierte Emotes geladen werden, wenn Avatare geladen werden.Das Festlegen dieser Eigenschaft auf false deaktiviert das Laden.Entwickler können die Eigenschaft im Studio direkt oder über das Spiele-Einstellungen-Menü festlegen.

Wenn die Emote-Ladung deaktiviert ist, wird die Emote-Benutzeroberfläche weiterhin funktionieren, solange Entwickler sich dafür entscheiden, die Emote-Funktion zu verwenden, indem sie Emotes innerhalb ihres Spiels hinzufügen.

Siehe auch Avatar-Emotes, einen Artikel, der detailliert beschreibt, wie Avatar-Emotes gesteuert, gestalten/anpassenund gespielt werden.

Alles Geerbte von Instance anzeigen
Alles Geerbte von Object anzeigen

Methoden

Alles Geerbte von Instance anzeigen
Alles Geerbte von Object anzeigen

Ereignisse

Alles Geerbte von Instance anzeigen
Alles Geerbte von Object anzeigen