StarterPlayer

Pokaż przestarzałe

*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.

Brak możliwości tworzenia
Usługa

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

Właściwości

AllowCustomAnimations

Ukryte
Zabezpieczenia skryptów Roblox
Odczyt równoległy

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

Odczyt równoległy

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

Auto-Jump Toggle

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

Bez replikacji
Brak możliwości dodawania do skryptu
Brak możliwości przeglądania
Odczyt równoległy

CameraMaxZoomDistance

Odczyt równoległy

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

Setting Camera Zoom Distance

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75

CameraMinZoomDistance

Odczyt równoległy

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

Setting Camera Zoom Distance

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75

CameraMode

Odczyt równoległy

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

Playing in First Person

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMode = Enum.CameraMode.LockFirstPerson

CharacterJumpHeight

Odczyt równoległy

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

Odczyt równoległy

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

Odczyt równoległy

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

Odczyt równoległy

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

Odczyt równoległy

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

Odczyt równoległy

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

Odczyt równoległy

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

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

Odczyt równoległy

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

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

Odczyt równoległy

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

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

Odczyt równoległy

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

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

Brak możliwości dodawania do skryptu
Odczyt równoległy

EnableMouseLockOption

Odczyt równoległy

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

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

Odczyt równoległy

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

Hiding Player Health and Names

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0

LoadCharacterAppearance

Odczyt równoległy

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

Disabling a Player's Appearance

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CanLoadCharacterAppearance = false

LoadCharacterLayeredClothing

Bez replikacji
Brak możliwości dodawania do skryptu
Odczyt równoległy

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

Brak możliwości przeglądania
Odczyt równoległy

NameDisplayDistance

Odczyt równoległy

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

Hiding Player Health and Names

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0

UserEmotesEnabled

Odczyt równoległy

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.

Metody

Zdarzenia