StarterPlayer
*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.
Usługa, która pozwala na ustawiaćdomyślnych właściwości w obiekcie Player .Kiedy gracz wchodzi na serwer, każda właściwość obiektu gracza jest ustawiona na aktualną wartość odpowiedniej właściwości w StarterPlayer .
Ponadto możesz dodać cztery obiekty do tej usługi:
- Instancja StarterPlayerScripts z kodami, które uruchamiają się raz dla każdego gracza.
- Instancja StarterCharacterScripts z kodami, które należy dodać do każdej postaci gracza za każdym razem, gdy się pojawią.
- Instancja Humanoid, nazwana StarterHumanoid, która zostanie użyta jako domyślny humanoid dla każdej postaci gracza.
- Instancja Model, która będzie nazywana StarterCharacter, której użyto jako modelu postaci dla wszystkich graczy.
Podsumowanie
Właściwości
Opisuje poziomy uprawnień obecnej gradotyczące animacji awatara niestandardowego z witryny.
Ustawia, czy postać automatycznie skoczy, gdy uderzy w przeszkodę na urządzeniemobilnym.
Maksymalna odległość, na jaką domyślna kamera gracza może się przybliżyć w szpilkach.
Minimalna odległość w szpilkach, do której domyślna kamera gracza może się przybliżyć.
Zmienia tryb domyślnej kamery na pierwszą lub trzecią osobę.
Określa początkową wartość Humanoid.JumpHeight dla Player.Character.
Określa początkową wartość Humanoid.JumpPower dla Player.Character.
Określa początkową wartość Humanoid.MaxSlopeAngle dla Player.Character.
Określa początkowy stan Humanoid.UseJumpPower dla Player.Character.
Określa początkową wartość Humanoid.WalkSpeed dla Player.Character.
Ustawia, w jaki sposób domyślna kamera obsługuje obiekty między kamerą a graczem.
Pozwól programiście zmienić domyślny tryb kamery dla każdego gracza, jeśli gracz jest na komputerze.
Pozwól programiście ponownie napisać tryb ruchu gracza, jeśli gracz jest na komputerze.
Pozwól programiście zmienić domyślny tryb ruchu kamery dla każdego gracza, jeśli gracz jest na urządzeniemobilnym.
Pozwól programiście ponownie napisać tryb ruchu gracza, jeśli gracz jest na urządzeniedotykowym.
Określa, czy gracz może przełączać blokadę myszy domyślnie.
Ustawia odległość, na której ten gracz zobaczy inne paski zdrowia Humanoid. Jeśli ustawiono na 0, paski zdrowia nie będą wyświetlane.
Czy powinno zostać załadowane wygląd postaci gracza, czy nie.
Wskazuje, czy postacie pojawiające się w doświadczeniu będą miały wyposażone w nich akcesoria do odzieży warstwowej.
Ustawia odległość, na której ten gracz zobaczy inne Humanoid nazwy.
Określa, czy emotki należące do użytkownika są wczytywane podczas ładowania awatarów.
Właściwości
AllowCustomAnimations
Właściwość ta opisuje poziomy uprawnień obecnej gradotyczące niestandardowego awatara z witryny.
W związku z tym ta wartość nie może być zmieniana z wewnątrz gra.Można go zmienić tylko poprzez zmianę poziomów uprawnień grana stronie ustawień grana stronie internetowej.
Właściwość ta nie jest przeznaczona do użycia w gra.
AutoJumpEnabled
Właściwość ta określa, czy postać automatycznie skoczy, gdy uderzy w przeszkodę na urządzeniemobilnym.
Właściwość ta jest kopiowana z StarterPlayer do Player po dołączeniu do gry.Po tym.wartość tej właściwości jest kopiowana do właściwości właściwości postaci na spawn.Innymi słowy, można ustawić zachowanie automatycznego skoku na podstawie każdej postaci, gracza i gry za pomocą tych trzech właściwości.
Przykłady kodu
Ten przykład kodu jest przeznaczony dla TextButton. Pozwala graczowi przełączyć zachowanie automatycznego skoku podczas korzystania z urządzenia mobilnego.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local button = script.Parent
local function update()
-- Aktualizuj tekst przycisku
if player.AutoJumpEnabled then
button.Text = "Auto-Jump is ON"
else
button.Text = "Auto-Jump is OFF"
end
-- Odbij właściwość w postaci gracza, jeśli ma jedną
if player.Character then
local human = player.Character:FindFirstChild("Humanoid")
if human then
human.AutoJumpEnabled = player.AutoJumpEnabled
end
end
end
local function onActivated()
-- Przełącz automatyczne skakanie
player.AutoJumpEnabled = not player.AutoJumpEnabled
-- Zaktualizuj wszystko inne
update()
end
button.Activated:Connect(onActivated)
update()AvatarJointUpgrade
CameraMaxZoomDistance
Właściwość ta ustawia maksymalną odległość w szpilkach, z jakiej kamera może być od postaci z domyślnymi kamerami.
Właściwość ta ustawia domyślną wartość Player.CameraMaxZoomDistance dla każdego gracza, który dołącza do gry.Jeśli ta wartość zostanie ustawiona na niższą wartość niż StarterPlayer.CameraMinZoomDistance zostanie zwiększona do CameraMinZoomDistance.
Przykłady kodu
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
Właściwość ta ustawia minimalną odległość w szpilkach, z jakiej kamera może być od postaci z domyślnymi kamerami.
Właściwość ta ustawia domyślną wartość Player.CameraMinZoomDistance dla każdego gracza, który dołącza do gry.Jeśli ta wartość zostanie ustawiona na wyższą wartość niż StarterPlayer.CameraMaxZoomDistance zostanie zmniejszona do CameraMaxZoomDistance.
Przykłady kodu
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
Ustawia domyślną wartość dla Player.CameraMode dla każdego gracza w grze. Kamera ma dwa tryby:
Pierwsza osoba
W trybie pierwszej osoby kamera gracza jest powiększona do końca.Chyba że istnieje widoczny interfejs GUI z właściwością GuiButton.Modal ustawioną na true, mysz zostanie zablokowana, a kamera użytkownika będzie się obracać, gdy mysz się porusza.
Trzecia osoba
W trybie osoby trzeciej (domyślny) postać można zobaczyć w kamerze. W trybie osoby trzeciej na Roblox:
- Możesz kliknąć prawym przyciskiem myszy i przeciągnąć, aby obrócić kamerę, lub użyć strzałek w prawym dolnym rogu ekranu.
- Kiedy przesuwasz mysz, kamera nie zmienia się (chyba że przesuwasz mysz do końca ekranu).
- Kiedy naciśniesz którąkolwiek z klawiszy strzałek, postać użytkownika będzie skierowana w kierunku odpowiedniej klawiszy klucz.
- Możesz swobodnie przybliżać i oddalać.
Przykłady kodu
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
Właściwość ta określa początkową wartość Humanoid.JumpHeight dla gracza Player.Character. Wartość tej właściwości domyślnie wynosi 7,2 ćwieków.
Właściwość ta jest widoczna tylko w oknie Właściwości, jeśli StarterPlayer.CharacterUseJumpPower jest ustawiona na false, ponieważ w przeciwnym razie nie byłaby istotna.
Ponieważ ta właściwość jest odpowiednia tylko dla postaci generowanych w przyszłości, zmiana jej nie zmieni istniejących postaci graczy.Zmiany w tej właściwości będą miały zastosowanie tylko wtedy, gdy gracz odrodzi się.
CharacterJumpPower
Właściwość ta określa początkową wartość Humanoid.JumpPower dla gracza Player.Character.Wartość tej właściwości domyślnie wynosi 50, a gdy zostanie zastosowana do Humanoid gracza, będzie ograniczona między 0 a 1000.
Właściwość ta jest widoczna tylko w oknie Właściwości, jeśli StarterPlayer.CharacterUseJumpPower jest ustawiona na true, ponieważ w przeciwnym razie nie byłaby istotna.
Ponieważ ta właściwość jest odpowiednia tylko dla postaci generowanych w przyszłości, zmiana jej nie zmieni istniejących postaci graczy.Zmiany w tej właściwości będą miały zastosowanie tylko wtedy, gdy gracz odrodzi się.
CharacterMaxSlopeAngle
Właściwość ta określa początkową wartość Humanoid.MaxSlopeAngle dla gracza Player.Character.Domyślnie wynosi 89°, więc ludzik może wspinąć się prawie każdą pochyłością, jaką chce domyślnie.Gdy zostanie zastosowany do gracza Humanoid, będzie ograniczony między 0 a 89.
Ponieważ ta właściwość jest odpowiednia tylko dla postaci generowanych w przyszłości, zmiana jej nie zmieni istniejących postaci graczy.Zmiany w tej właściwości będą miały zastosowanie tylko wtedy, gdy gracz odrodzi się.
CharacterUseJumpPower
CharacterUseJumpPower określa początkową wartość Humanoid.UseJumpPower dla gracza Player.Character .Przełączanie go zmieni to, które właściwości są widoczne w oknie właściwości: CharacterJumpHeight (fałsz) lub StarterPlayer.CharacterJumpPower (prawda).Domyślnie prawda.
Ponieważ ta właściwość jest odpowiednia tylko dla postaci generowanych w przyszłości, zmiana jej nie zmieni istniejących postaci graczy.Zmiany w tej właściwości będą miały zastosowanie tylko wtedy, gdy gracz odrodzi się.
CharacterWalkSpeed
Właściwość ta określa początkową wartość Humanoid.WalkSpeed dla gracza Player.Character. Ta właściwość domyślnie wynosi 16.
Ponieważ ta właściwość jest odpowiednia tylko dla postaci generowanych w przyszłości, zmiana jej nie zmieni istniejących postaci graczy.Zmiany w tej właściwości będą miały zastosowanie tylko wtedy, gdy gracz odrodzi się.
ClassicDeath
DevCameraOcclusionMode
Określa, w jaki sposób domyślne skrypty kamery obsługują obiekty między kamerą a przedmiotem kamerowym.Dotyczy wszystkich graczy, gdy dołączają do doświadczenia i nie może być zmieniana dla poszczególnych graczy.
Domyślną wartością jest Zoom (0). Zobacz Enum.DevCameraOcclusionMode dla listy dostępnych trybów.
DevComputerCameraMovementMode
Właściwość ta pozwala programiście ponownie zapisać tryb kamery gracza, jeśli gracz jest na komputerze.
Jest to domyślna właściwość dla graczy dołączających do gry. Można ją zmienić dla poszczególnych graczy poprzez ustawienie Player.DevComputerCameraMode.
Jeśli ustawiono na UserChoice , wówczas tryb ruchu kamery gracza zostanie określony przez to, co gracz ustawił w ustawieniach gry.W przeciwnym razie tryb zostanie ustawiony w oparciu o tę właściwość.
Zobacz Enum.DevComputerCameraMovementMode dla dostępnych różnych trybów kamery.
Ta właściwość nie ma wpływu na graczy nie na komputerze.
Przykłady kodu
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
Właściwość ta pozwala programiście ponownie napisać tryb ruchu gracza, jeśli gracz jest na komputerze.
Jest to domyślna właściwość dla graczy dołączających do gry. Można ją zmienić dla poszczególnych graczy poprzez ustawienie Player.DevComputerMovementMode.
Jeśli ustawiono na UserChoice, tryb ruchu gracza zostanie określony przez to, co gracz ustawił w ustawieniach gry.W przeciwnym razie tryb zostanie ustawiony w oparciu o tę właściwość.
Zobacz Enum.DevComputerMovementMode dla dostępnych różnych trybów ruchu. Pozwól programiście zastąpić tryb ruchu gracza, jeśli gracz jest na komputerze.
Ta właściwość nie ma wpływu na graczy nie na komputerze.
Przykłady kodu
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
Właściwość ta pozwala programiście ponownie zapisać tryb kamery gracza, jeśli gracz jest na urządzeniedotykowym.
Jest to domyślna właściwość dla graczy dołączających do gry. Można ją zmienić dla poszczególnych graczy poprzez ustawienie Player.DevTouchCameraMode.
Jeśli ustawiono na UserChoice , wówczas tryb ruchu kamery gracza zostanie określony przez to, co gracz ustawił w ustawieniach gry.W przeciwnym razie tryb zostanie ustawiony w oparciu o tę właściwość.
Zobacz Enum.DevTouchCameraMovementMode dla dostępnych różnych trybów kamery.
Właściwość ta nie ma wpływu na graczy nie na urządzeniemobilnym.
Przykłady kodu
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
Właściwość ta pozwala programiście ponownie napisać tryb ruchu gracza, jeśli gracz jest na urządzeniedotykowym.
Jest to domyślna właściwość dla graczy dołączających do gry. Można ją zmienić dla poszczególnych graczy poprzez ustawienie Player.DevTouchMovementMode.
Jeśli ustawiono na UserChoice, tryb ruchu gracza zostanie określony przez to, co gracz ustawił w ustawieniach gry.W przeciwnym razie tryb zostanie ustawiony w oparciu o tę właściwość.
Zobacz Enum.DevTouchMovementMode dla dostępnych różnych trybów ruchu. Pozwól programiście zastąpić tryb ruchu gracza, jeśli gracz jest na urządzeniedotykowym.
Właściwość ta nie ma wpływu na graczy nie na urządzeniez włączonym dotykiem.
Przykłady kodu
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
Właściwość ta określa, czy gracz może przełączać blokadę myszy domyślnie.
Mouselock zamknie kurzor gracza w centrum ekranu.Przesuwanie myszy obróci Camera i Player będzie się poruszać względem obecnego obrotu kamery.
Właściwość ta ustawia wartość Player.DevEnableMouseLock.
Zauważ, że interfejsy API związane z przełączaniem blokady są w trakcie wycofania, więc zaleca się użycie UserInputService.MouseBehavior zamiast blokować mysz.
Przykłady kodu
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
Właściwość ta ustawia odległość w szpilkach, na której ten gracz zobaczy inne paski zdrowia Humanoid.Jeśli ustawiono na 0, paski zdrowia nie będą wyświetlane.Właściwość ta jest ustawiona domyślnie na 100 szpilkami.
Aby zmienić odległość wyświetlania dla gracza po dołączeniu do gry, możesz ustawić właściwość Player.HealthDisplayDistance.
Jeśli pasek zdrowia Humanoid jest widoczny, możesz ustawić typ wyświetlania za pomocą Humanoid.DisplayDistanceType.
Przykłady kodu
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
Właściwość ta określa, czy powinno zostać załadowane wygląd postaci gracza, czy nie.
Ustawienie tego na false powoduje, że gracz nie ma ubrania (w tym czapki), kolorów ciała, pakietów ciała lub czegokolwiek innego związanego z wyglądem awatara gracza.Domyślnie właściwość ta jest ustawiona na true .
Ustawienie tego na true powoduje, że gracz ładować będzie wygląd odpowiadający graczowi Player.CharacterAppearanceId .
Jeśli Player:LoadCharacterWithHumanoidDescription() jest używany, może być korzystne ustawienie StarterPlayer.LoadCharacterAppearance na fałsz, ponieważ awatar gracza nie jest wymagany, ponieważ wszystkie ID zasobów do wyposażenia na postaci pochodzą z przekazanych w HumanoidDescription .
Przykłady kodu
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
Wskazuje, czy postacie pojawiające się w doświadczeniu będą miały wyposażone w nich akcesoria do odzieży warstwowej (chociaż Workspace.MeshPartHeadsAndAccessories również muszą być włączone w Workspace ).
LuaCharacterController
NameDisplayDistance
Ustawia odległość, na której ten gracz zobaczy inne Humanoid nazwy.Jeśli ustawiono na 0, nazwy są ukryte.Właściwość ta jest ustawiona domyślnie na 100 szpilki.
Aby zmienić odległość wyświetlania dla gracza po dołączeniu do gry, możesz ustawić właściwość Player.NameDisplayDistance.
Jeśli nazwa Humanoid jest widoczna, możesz ustawić typ wyświetlania za pomocą Humanoid.DisplayDistanceType.
Przykłady kodu
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 = 0RagdollDeath
UserEmotesEnabled
Właściwość ta określa, czy emotki należące do użytkownika są wczytywane podczas ładowania awatarów.Ustawienie tej właściwości na fałsz wyłącza ładowanie.Twórcy mogą ustawić właściwość w Studio bezpośrednio lub za pośrednictwem menu Ustawień gry.
Gdy włączenie emotek jest wyłączone, interfejs użytkownika emotek nadal będzie działał tak długo, jak długo programiści zdecydują się korzystać z funkcji emotek, dodając emotki do swojej gry.
Zobacz także Emotki awatara, artykuł szczegółowo opisujący, jak kontrolować, dostosowywać i odtwarzać emotki awatara.