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
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
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75
CameraMinZoomDistance
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
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75
CameraMode
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
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMode = Enum.CameraMode.LockFirstPerson
CharacterJumpHeight
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
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
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
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
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
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
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
local Players = game:GetService("Players")
local player = Players.LocalPlayer
while true do
player.DevEnableMouseLock = not player.DevEnableMouseLock
task.wait(5)
end
HealthDisplayDistance
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
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0
LoadCharacterAppearance
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
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CanLoadCharacterAppearance = false
LoadCharacterLayeredClothing
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
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0
UserEmotesEnabled
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.