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 umożliwia ustawienie domyślnych właściwości w obiekcie Player, aby były ustawiać. Gdy gracz wejdzie na serwer, każda właściwość gracza zostanie ustawiona na bieżącą wartość odpowiedniej właściwości w StarterPlayer.
Dodatkowo możesz dodać cztery obiekty do tej usługi:
- Instancja StarterPlayerScripts z skryptami, które są uruchomione raz dla każdego gracza.
- Instancja StarterCharacterScripts ze skryptami do dodania do każdego postaci gracza za każdym razem, gdy się pojawiają.
- Instancja Humanoid nazyjąca się StarterHumanoid, która będzie używana jako domyślny kształt dla każdego postaci gracza.
- Instancja Model nazyjąca się StarterCharacter, która będzie używana jako model postaci dla wszystkich graczy.
Podsumowanie
Właściwości
Opisuje poziomy upoważnienia aktualnej graw odniesieniu do animacji awatara z witryny.
Określa, czy postać automatycznie skoczęła бы po uderzeniu przez przeszkodę na urządzeniemobilnym.
Maksymalna odległość, jaką może zwiększyć kamera gracza, jest dozwolona w metrach.
Minimalna odległość w studsach w kamery standardowe gracza jest dozwolona do skalowania.
Zmienia tryb kamery domyślnej na jedną z pierwszych lub trzecich osób.
Określa wartość początkową Humanoid.JumpHeight dla Player.Character .
Określa wartość początkową 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, jak domyślna kamera traktuje obiekty między kamerą a graczem.
Pozwólmy użytkownikowi na zapisanie trybu kamerze domyślnej dla każdego gracza, jeśli użytkownik jest na komputerze.
Napisać rozwinięty tryb przemieszczania gracza, jeśli gracz jest na komputerze.
Pozwólmy użytkownikowi na zapisanie ustawień kamerze dla każdego gracza, jeśli użytkownik jest na urządzeniemobilnym.
Napiszemy w ten sposób tryb przemieszczania gracza, jeśli gracz jest na urządzeniedotykowym.
Określa, czy gracz może ustawić automatyczne zamywanie myszy.
Ustawia odległość, w której ten gracz będzie widział inne Humanoid zdrowotne balki. Jeśli ustawiony na 0, zdrowotne balki nie będą wyświetlane.
Czy wygląd postaci gracza powinien zostać załadowany czy nie.
Wskazuje, czy postacie, które się doświadczą, będą nosić dodatki odzieżowe z wielu warstw.
Ustawia odległość, w której ten gracz będzie widział inne imiona Humanoid. Jeśli ustawiony na 0, imiona są ukryte.
Określa, czy własne emotki użytkownika są ładowane podczas ładowania awatarów.
Właściwości
AllowCustomAnimations
Właściwość AllowCustomAnimations opisuje poziomy upoważnienia dla awatarów w graw oparciu o dane o swoim awatarze Animations z witryny.
Jako taki, ten wartość nie może być zmieniony od wewnątrz gra. Można go zmienić tylko poprzez zmianę poziomów upoważnienia graw grana stronie ustawień witryny.
Ta właściwość nie jest przeznaczona do użycia w gra.
AutoJumpEnabled
Właściwość AutoJumpEnabled ustawia, czy postać automatycznie skaczy, gdy uderza obstruklem na urządzeniemobilnym.
Właściwość ta jest kopiowana z StarterPlayer do Player gdy dołączają do gra. Po tym. wartość tej właściwości jest kopiowana na Humanoid.AutoJumpEnabled właściwości charakteru na spawn. Innymi słowy,
Przykłady kodu
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
Właściwość CameraMaxZoomDistance ustawia maksymalną odległość w studsach, jaką kamera może mieć od postaci z domyślnymi kamerami.
Ta właściwość 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 ona 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ść CameraMinZoonDistance ustawia minimalną odległość w studsach, z której kamera może być od kamery z domyślnymi kamerkami.
Ta właściwość ustawia domyślną wartość Player.CameraMinZoomDistance dla każdego gracza, który dołącza do gry. Jeśli ta wartość jest ustawiona na wyższą niż StarterPlayer.CameraMaxZoomDistance zostanie ona zmniejszona do KameramaxZoomDistance.
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 skalowana w całym kadrze. Chyba że istnieje widoczny zestaw GUI z właściwością GuiButton.Modal ustawioną na true, myszka zostanie zablokowana, a kamera gracza będzie się zmieniać, gdy myszka się porusza.
Trzecia osoba
W trybie postaci w trzeciej osobie (domyślny), postać można zobaczyć w kameryze. Podczas gdy w trybie postaci w trzeciej osobie na Roblox:
- Możesz prawe kliknąć i przeciągnąć, aby obrócić swoją kamerę, lub użyć strzałek w dolnym rogu ekranu.
- Gdy przesuniesz myszkę, kamera nie się nie zmienia (chyba że przesuniesz myszkę do końca ekranu).
- Gdy nacjesz dowolną z klawiszy strzałki, postać użytkownika stanie w kierunku odpowiadającej klucz.
- Możesz swobodnie przyjmować i oddawać.
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
CharacterJumpHeight określa początkową wartość Humanoid.JumpHeight dla gracza Character. Wartość tego właściwości domyślnie wynosi 7,2 studs.
Właściwość ta jest widoczna tylko w oknie Właściwości, jeśli StarterPlayer.CharacterUseJumpPower jest ustawiony na false, ponieważ nie miałaby ona sensu w innym przypadku.
Ponieważ ta właściwość dotyczy tylko postaci, które będą się pojawiać w przyszłości, zmiany tej właściwości nie będą wpływać na istniejące postacie gracza. Zmiany tej właściwości będą miały wpływ tylko wtedy, gdy gracz się odrodzi.
CharacterJumpPower
CharacterJumpPower określa wartość początkową Humanoid.JumpPower dla gracza Character. Wartość tego właściwości domyślnie wynosi 50 i gdy zostanie stosowana do gracza 0> Class.Humanoid0>, będzie ograniczona między 0 a
Właściwość ta jest widoczna tylko w oknie Właściwości, jeśli StarterPlayer.CharacterUseJumpPower ustawiony na true, ponieważ nie miałoby to sensu w przeciwnym razie.
Ponieważ ta właściwość dotyczy tylko postaci, które będą się pojawiać w przyszłości, zmiany tej właściwości nie będą wpływać na istniejące postacie gracza. Zmiany tej właściwości będą miały wpływ tylko wtedy, gdy gracz się odrodzi.
CharacterMaxSlopeAngle
CharacterMaxSlopeAngle określa wartość początkową Humanoid.MaxSlopeAngle dla gracza Character. Domyślnie jest to 89°, więc humanoidy mogą w górę prawie każdego kosia, jakiego chcą domyślnie. Gdy z
Ponieważ ta właściwość dotyczy tylko postaci, które będą się pojawiać w przyszłości, zmiany tej właściwości nie będą wpływać na istniejące postacie gracza. Zmiany tej właściwości będą miały wpływ tylko wtedy, gdy gracz się odrodzi.
CharacterUseJumpPower
CharacterUseJumpPower określa wartość początkową Humanoid.UseJumpPower dla gracza Character. Przełączniki zmieniają widoczność następującej właściwości: 0> Class.St
Ponieważ ta właściwość dotyczy tylko postaci, które będą się pojawiać w przyszłości, zmiany tej właściwości nie będą wpływać na istniejące postacie gracza. Zmiany tej właściwości będą miały wpływ tylko wtedy, gdy gracz się odrodzi.
CharacterWalkSpeed
CharacterWalkSpeed określa początkową wartość Humanoid.WalkSpeed dla gracza Character. Ta wartość domyślnie wynosi 16.
Ponieważ ta właściwość dotyczy tylko postaci, które będą się pojawiać w przyszłości, zmiany tej właściwości nie będą wpływać na istniejące postacie gracza. Zmiany tej właściwości będą miały wpływ tylko wtedy, gdy gracz się odrodzi.
DevCameraOcclusionMode
Definiuje, jak domyślne skrypty kamery poruszają obiekty między kamera a podmiotem kamery. Ma to zastosowanie do wszystkich graczy, gdy dołączają do doświadczenia i nie mogą być zmienione dla poszczególnych graczy.
Domyślną wartością jest Zoom (0). Zobacz Enum.DevCameraOcclusionMode dla listy dostępnych trybów.
DevComputerCameraMovementMode
Właściwość DevComputerCameraMovementMode pozwala rozwójowi opracować tryb kamerze gracza, jeśli gracz jest na komputerze.
To jest domyślna właściwość dla graczy dołączających do gry. Można ją zmienić dla każdych graczy poprzez ustawienie Player.DevComputerCameraMode.
Jeśli ustawiony na UserChoice to ustawiony przez gracza tryb ruchu kamery będzie zależał od tego, co ustawił gracz w ustawieniach gry. W przeciwnym wypadku tryb zostanie ustawiony na podstawie tej właściwości.
Zobacz Enum.DevComputerCameraMovementMode dla różnych dostępnych 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ść DevComputerMovementMove pozwala na nakreślenie trybu przemieszczania gracza, jeśli gracz jest na komputerze.
To jest domyślna właściwość dla graczy dołączających do gry. Można go zmienić dla poszczególnych graczy poprzez ustawienie Player.DevComputerMovementMode .
Jeśli ustawiony na UserChoice to tryb przemieszczania gracza będzie zależał od ustawień gracza w ustawieniach gry. W przeciwnym wypadku tryb będzie ustawiony na tej podstawie.
Zobacz Enum.DevComputerMovementMode dla różnych dostępnych trybów ruchu. Pisać modyfikator ruchu dla gracza, jeśli 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ść DevTouchCameraMovementMode pozwala rozwójowi opracować sposób używania kamery gracza, jeśli gracz jest na urządzeniedotykowym.
To jest 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 ustawiony na UserChoice to ustawiony przez gracza tryb ruchu kamery będzie zależał od tego, co ustawił gracz w ustawieniach gry. W przeciwnym wypadku tryb zostanie ustawiony na podstawie tej właściwości.
Zobacz Enum.DevTouchCameraMovementMode dla różnych dostępnych trybów kamery.
Ta właściwość 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ść DevTouchMovementMode pozwala na nakreślenie trybu przemieszczania gracza, jeśli gracz jest na urządzeniedotykowym.
To jest domyślna właściwość dla graczy dołączających do gry. Można ją zmienić dla każdych graczy poprzez ustawienie Player.DevTouchMovementMode .
Jeśli ustawiony na UserChoice to tryb przemieszczania gracza będzie zależał od ustawień gracza w ustawieniach gry. W przeciwnym wypadku tryb zostanie ustawiony na tej podstawie.
Zobacz Enum.DevTouchMovementMode dla dostępnych różnych trybów ruchu. Pomożemy rozwójowi przesadzić tryb ruchu gracza, jeśli gracz jest na urządzeniedotykowym.
Ta właściwość nie ma wpływu na graczy nie na włączonym urządzeniedotykowym.
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ść EnableMouseLockOption określa, czy gracz może włączyć lub wyłączyć automatyczne zablokowanie myszy domyślnie.
Mouselock zablokuje kursoр gracza na środku ekranu. Przesunięcie myszy będzie obrótywało Camera i Player w stosunku do obecnej rotacji kamery.
Ta właściwość ustawia wartość Player.DevEnableMouseLock .
Uwaga, że API związane z zamkiem zmiany stanu przesuwane są w trakcie deprecji, więc zaleca się używanie UserInputService.MouseBehavior zamiast zamkiem myszy.
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ść HealthDisplayDistance ustawia odległość w studsach, w których ten gracz będzie widział inne Humanoid bary zdrowia. Jeśli ustawiono na 0, bary zdrowia nie będą wyświetlane. Ta właściwość jest ustawiona na 100 studs domyślnie.
Aby zmienić dystans wyświetlania dla gracza, gdy dołączy do gry, możesz ustawić właściwość Player.HealthDisplayDistance.
Jeśli widoczna jest Humanoid barwa zdrowia, możesz ustawić typ wyświetlania używając 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ść LoadCharacterAppearance ustawia, czy wygląd postaci gracza powinien być załadowany lub nie.
Ustawienie tego na false wynika w graczu bez ubrań (w tym czapek), kolorów ciała, pakietów ciała lub czegokolwiek innego związanego z wyglądem gracza. Domyślnie ustawione jest to na true.
Ustawienie tego na true wynika w graczu ładowanie wyglądu odpowiadającego Player.CharacterAppearanceId .
Jeśli Player:LoadCharacterWithHumanoidDescription() jest używany, może być korzystne ustawić StarterPlayer.LoadCharacterAppearance na false, ponieważ awatar gracza nie jest wymagany jako wszystkie ID zasobów do użycia na postaci pochodzą z przepustki 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, które się narodzą w doświadczeniu, będą nosić dodatki ubrań z wieloma warstwami (chociaż Workspace.MeshPartHeadsAndAccessories musi być również włączone w Workspace ).
LuaCharacterController
NameDisplayDistance
Ustawia odległość, w której ten gracz będzie widział inne imiona Humanoid. Jeśli ustawiony na 0, imiona są ukryte.
Właściwość NameDisplayDistance StarterPlayer ustawia odległość w studsach, przy której ten gracz będzie widział inne imiona Humanoid. Jeśli ustawiono na 0, imiona są ukryte. Ta właściwość ustawiona jest na 100 studs domyślnie.
Aby zmienić dystans wyświetlania dla gracza, gdy dołączy do gry, możesz ustawić właściwość Player.NameDisplayDistance.
Jeśli widoczny jest Humanoid imię, możesz ustawić typ wyświetlania używając 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 = 0UserEmotesEnabled
Ta właściwość określa, czy własne emotki zostaną załadowane podczas ładowania awatarów. Ustawienie tej właściwości na false wyłącza ładowanie. Rozwój może ustawić właściwość w Studio bezpośrednio lub poprzez menu Ustawienia gry.
Gdy wczytywanie emotikon jest wyłączone, interfejs emotikon będzie nadal działać, tak długo, jak użytkownicy wybiorą użycie funkcji emotikon poprzez dodawanie emotikon do swojej gra.
Zobacz również Emotki dla awatara, artykuł szczegółowo opisujący sposób kontroli, dostosowania i gry emotikami dla awatara.