Player

AgeKonto to właściwość Player, która opisuje, ile dni temu zostało zarejestrowane konto gracza. Ustawione jest przy użyciu funkcji Player:SetAccountAge(), która nie może być dostępna przez skrypty.

Właściwość ta jest przydatna do okazania nowym graczom Roblox treści, która może być wyświetlana kondycyjnie, takiej jak tutoriale.

local Players = game:GetService("Players")

local MAX_AGE_NEW_PLAYER = 7 -- one week
local MIN_AGE_VETERAN = 365 -- one year

-- This function marks a part with text using a BillboardGui
local function mark(part, text)
	local bbgui = Instance.new("BillboardGui")
	bbgui.AlwaysOnTop = true
	bbgui.StudsOffsetWorldSpace = Vector3.new(0, 2, 0)
	bbgui.Size = UDim2.new(0, 200, 0, 50)
	local textLabel = Instance.new("TextLabel")
	textLabel.Size = UDim2.new(1, 0, 1, 0) -- Fill parent
	textLabel.Text = text
	textLabel.TextColor3 = Color3.new(1, 1, 1)
	textLabel.TextStrokeTransparency = 0
	textLabel.BackgroundTransparency = 1
	textLabel.Parent = bbgui
	-- Add to part
	bbgui.Parent = part
	bbgui.Adornee = part
end

local function onPlayerSpawned(player, character)
	local head = character:WaitForChild("Head")
	if player.AccountAge >= MIN_AGE_VETERAN then
		mark(head, "Veteran Player")
	elseif player.AccountAge <= MAX_AGE_NEW_PLAYER then
		mark(head, "New Player")
	else
		mark(head, "Regular Player")
	end
end

local function onPlayerAdded(player)
	-- Listen for this player spawning
	if player.Character then
		onPlayerSpawned(player, player.Character)
	end
	player.CharacterAdded:Connect(function()
		onPlayerSpawned(player, player.Character)
	end)
end

Players.PlayerAdded:Connect(onPlayerAdded)

Właściwość AutoJumpEnabled określa, czy Player.Character Class.Player używającego urządzenia mobilnego będzie automatycznie skakiować, gdy dotknie ono przeszkody. To może ułatwić poziomy do przeglądania po poziomie, gdy jest używany na urządzeniemobilnym.

Gdy gracz dołącza do gry, wartość StarterPlayer.AutoJumpEnabled określa początkowy stan tej właściwości. Następnie ta właściwość określa wartość Humanoid.AutoJumpEnabled właściwości Player.Character podczas wchodzenia. Innymi słowy

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()

Właściwość CameraMaxZoomDistance Player ustawia maksymalną odległość w studsach, jaką może mieć kamera od postaci z domyślnymi kamerkami.

Innymi słowy, kontroluje maksymalną odległość, jaką kamera gracza może skorygować.

Domyślna wartość tego właściwości jest ustawiona przez StarterPlayer.CameraMaxZoomDistance. Jeśli ta wartość zostanie ustawiona na niższą wartość niż Player.CameraMinZoomDistance, zostanie ona zwiększona do CameraMinZoomDistance.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75

Właściwość CameraMinZoonDistance Player ustawia minimalną odległość w studsach, z której kamera może być od kamery z domyślnymi kamerkami.

Innymi słowy, kontroluje minimalną odległość, jaką kamera gracza może zoomować.

Domyślną wartością tego właściwości jest ustawiony przez StarterPlayer.CameraMinZoomDistance. Jeśli ta wartość jest ustawiona na większą niż Player.CameraMaxZoomDistance zostanie zmniejszona do CameraMaxZoomDistance.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75

Właściwość KameraModuł ustawia tryb kamerze gracza, domyślnie na trzeci osobnik.

Trzecia osoba

W trybie postaci w trzeciej osobie domyślnej ( Enum.CameraMode.Classic ) widoczny jest postać w kamery. W tym trybie domyślnym zachowaniem jest:

• Gracze mogą prawić kliknąć i przeciągnąć (myszka), naciąć i przeciągnąć (telefon), użyć współczynnika rotacji (gamepad), lub naciąć lewą / prawą strzałkę (klawiatura), aby obrócić kamerę wokół ich postaci.
• Gdy gracz porusza swoją postacią, to twarzy w kierunku odpowiednim ruchu.
• Gracze mogą przyjmować i oddawać darmową skalę, nawet do pierwszej osoby w pełnym skali w.

Pierwsza osoba

W trybie pierwszej osoby ( Enum.CameraMode.LockFirstPerson ) kamerka gracza jest skalowana w całym kadrze. Chyba, że istnieje widoczna GUI z własnością GuiButton.Modal ustawioną na true , ruszając myszką, dotykając na telefonie lub używając dodatkowego joysticka na gamepadzie, k

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CameraMode = Enum.CameraMode.LockFirstPerson

Właściwość CanLoadCharacterAppearance Player określa, czy wygląd postaci zostanie załadowany, gdy gracz się pojawi. Domyślną wartość tej właściwości ustawia StarterPlayer.LoadPlayerAppearance.

Jeśli prawda, postać załadować będzie wygląd gracza odpowiadającego Player.CharacterAppearanceId gracza.

Jeśli fałszywy , gracz pojawi się z domyślnym wyglądem - model postaci czarnego postaci bez żadnych czapek, koszul, spodni itp.

Próbując ustawić właściwość po pojawieniu się postaci nie zmieni postaci, musisz wywołać Player:LoadCharacter(), aby załadować nowy wygląd.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CanLoadCharacterAppearance = false

Właściwość Postać zawiera odniesienie do Model zawierającego Humanoid, części ciała, skrypty i inne obiekty w

Początkowo właściwość ta jest nil i jest ustawiona, gdy postać gracza po raz pierwszy się pojawia. Użyj wydarzenia Player.CharacterAdded, aby wykryć, gdy postać gracza zostanie prawidłowo załadowana, a wydarzenia Player.CharacterRemoving, aby wyk

Uwaga, że LocalScripts, które są sklonowane z StarterGui lub StarterPack do gracza 2>

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

local character = player.Character
if not character or character.Parent == nil then
	character = player.CharacterAdded:Wait()
end

Ten parametr określa ID użytkownika konta, którego postać wygląda na gracza Class.Player.Character . Domyślnie, ten parametr jest Player.Character, który używa awatara gracza, jakim został stworzony na stronie Roblox.

Zmiana tego właściwości na ID użytkownika innego konta spowoduje, że gracz zostanie zespawnowany z wyglądem tego konto(czapki, koszule, spodnie itp).

Gry mogą również zmieniać, czy wygląd postaci gracza jest ładowany w grze poprzez zmianę właściwości StarterPlayer.LoadCharacterAppearance.

local Players = game:GetService("Players")

local disguiseCommand = "/disguise "

local function onPlayerChatted(player, message)
	if message:sub(1, disguiseCommand:len()):lower() == disguiseCommand:lower() then
		local input = message:sub(disguiseCommand:len() + 1)
		local id = tonumber(input)
		if not id then -- Number failed to parse, maybe they typed a username instead
			pcall(function() -- This call can fail sometimes!
				id = Players:GetUserIdFromNameAsync(input) -- Fetch ID from name
			end)
		end
		if id then
			-- Set character appearance then respawn
			player.CharacterAppearanceId = id
			player:LoadCharacter()
		else
			-- We couldn't get an ID from their input
		end
	end
end

local function onPlayerAdded(player)
	player.Chatted:Connect(function(...)
		onPlayerChatted(player, ...)
	end)
end

Players.PlayerAdded:Connect(onPlayerAdded)

Definiuje sposób, w jaki domyślne skrypty kamery poruszają obiekty między kamera a kamera subiektu. Ustawione przez StarterPlayer.DevCameraOcclusionMode i nie może być zmienione dla poszczególnych graczy.

Domyślną wartością jest Zoom (0). Zobacz Enum.DevCameraOcclusionMode dla listy dostępnych trybów.

Właściwość DevComputerCameraMode określa sposób, w jaki gracz porusza kamerę, gdy używa urządzenia z myszką i klawiaturą. Zobacz Enum.DevComputerCameraMovementMode dla opisu każdego dostępnego trybu kamerowego. Ta właściwość nie może być ustawiona za pomocą LocalScript (musi być ustawiona na serwerze za pomocą

Domyślną wartość tego właściwości jest określona przez StarterPlayer.DevComputerCameraMovementMode .

Słowo „komputer” w tej nazwie właściwości odnosi się do nie- TouchEnabled , nie- GamepadEnabled urządzeń.

Gdy ustawiony na Wybór użytkownika , gracz może wybrać pomiędzy dowolnym trybem kontroli (za wyjątkiem Skrypty ) w ustawieniach gry Roblox. W ogólnedobrym pomysłem jest pozwolenie graczom wybrać swój tryb kontroli, aby zwiększyć dostępność.

Możliwe jest utworzenie niestandardowego schemu kontroli ustawiając tę właściwość na Scriptable .

Ta właściwość nie dotyczy graczy, którzy używają włączonego urządzeniedotykowego. Zobacz Player.DevTouchCameraMode zamiast tego.

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

Właściwość DevComputerMovementMode określa sposób, w jaki gracz porusza swojego postaci, gdy używa urządzenia z myszką i klawiaturą. Zobacz Enum.DevComputerMovementMode dla opisu każdego trybu ruchu dostępnego. Ta właściwość nie może być ustawiona za pomocą LocalScript (musi być ustawiona na serwerze za pom

Domyślną wartość tego właściwości jest zdeterminowana przez StarterPlayer.DevComputerMovementMode .

Słowo „komputer” w tej nazwie właściwości odnosi się do nie- TouchEnabled urządzeń.

Gdy ustawiony na Wybór użytkownika , gracz może wybrać pomiędzy dowolnym trybem kontroli (za wyjątkiem Skrypty ) w ustawieniach gry Roblox. W ogólne, dobrym pomysłem jest pozwolenie graczom wybrać swój tryb kontroli, aby zwiększyć dostępność.

Możliwe jest utworzenie niestandardowego schemu kontroli ustawiając tę właściwość na Scriptable .

Ta właściwość nie dotyczy graczy używających urządzeniez możliwością dotyku. Zobacz Player.DevTouchMovementMode zamiast tego.

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)

Ta właściwość określa, czy gracz jest w stanie przełączyć Mouse zablokowanie poprzez naciśnięcie Shift . Gracz może wyłączyć przełącznik zablokowania myszy w ustawieniach gry Roblox. Domyślnie ta właściwość jest ustawiona na wartość

Gdy ustawiony jest mikropomiar, kursorek gracza jest zablokowany w centrum ekranu. Przesuwanie myszy po orbicie kamery wokół gracza character i znajduje się w tym samym kierunku co camera . Przesunięcie kamery również zdefiniuje widok kamery w okolicy prawego ramienia gracza.

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.

local Players = game:GetService("Players")

local function toggleMouseLock(player)
	player.DevEnableMouseLock = not player.DevEnableMouseLock
	if player.DevEnableMouseLock then
		print("Mouse lock is available")
	else
		print("Mouse lock is not available")
	end
end

local function onPlayerChatted(player, message, _recipient)
	if message == "mouselock" then
		toggleMouseLock(player)
	end
end

local function onPlayerAdded(player)
	player.Chatted:Connect(function(...)
		onPlayerChatted(player, ...)
	end)
end

Players.PlayerAdded:Connect(onPlayerAdded)

Właściwość DevTouchCameraMode określa sposób, w jaki gracz porusza kamerę, gdy używa urządzenieTouchEnabled. Patrz Enum.DevTouchCameraMovementMode dla opisu każdego trybu sterowania kamerą dostępnego. Nie można ustawić właściwości używając <

Domyślną wartość tego właściwości jest określona przez StarterPlayer.DevTouchCameraMovementMode .

Gdy ustawiony na Wybór użytkownika , gracz może wybrać pomiędzy dowolnym trybem kontroli (za wyjątkiem Skrypty ) w ustawieniach gry Roblox. W ogólne, dobrym pomysłem jest pozwolenie graczom wybrać swój tryb kontroli, aby zwiększyć dostępność.

Możliwe jest utworzenie niestandardowego schemu kontroli ustawiając tę właściwość na Scriptable .

Ta właściwość nie dotyczy graczy, którzy nie używają włączonego dotykowo urządzenie. Zobacz Player.DevComputerCameraMovementMode zamiast tego.

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

Właściwość DevTouchMovementMode określa sposób, w jaki gracz porusza swojego postaci, gdy używa urządzenieTouchEnabled. Patrz Enum.DevTouchMovementMode dla opisu każdego trybu ruchu dostępnego. Ta właściwość nie może być ustawiona za pomocą <

Domyślną wartość tego właściwości jest zdeterminowana przez StarterPlayer.DevTouchMovementMode .

Gdy ustawiony na Wybór użytkownika , gracz może wybrać pomiędzy dowolnym trybem kontroli (za wyjątkiem Skrypty ) w ustawieniach gry Roblox. W ogólnedobrym pomysłem jest pozwolenie graczom wybrać swój tryb kontroli, aby zwiększyć dostępność.

Możliwe jest utworzenie niestandardowego schemu kontroli ustawiając tę właściwość na Scriptable .

Ta właściwość nie dotyczy graczy, którzy nie używają urządzeniew pełni włączonego dotykowo. Zobacz Player.DevComputerMovementMode zamiast tego.

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)

DisplayName jest własnością Player, która zawiera nazwę wyświetlaną przez autoryzowanego użytkownika powiązanego z obiektem Player. W przeciwieństwie do imion użytkowników, nazwy wyświetlanie są niepowtarzalnymi nazwami, które gracz wyświetla dla innych. Jeśli u

Notatka:

• Ponieważ nazwy wyświetlanych są niepowtarzalne, może być dla dwóch graczy w jednej instancji identycznych nazw. Jeśli potrzebujesz unikalnego identyfikatora dla gracza, użyj Player.UserId (który jest statyczny) lub Player.Name (który jest obecnym nazwą użytkownika).
• Zwierzęta generowane za pomocą Player.LoadCharacter lub przez silnik Roblox będą posiadać ich właściwość Humanoid.DisplayName przypisaną do właściwości Player.DisplayName.
• Nazwy mogą zawierać znaki niezgodne z polską wersją języka. See UTF-8 for more information on how to work with strings with unicode characters.

FollowUserId to właściwość Player, która zawiera Player.UserId użytkownika, którego gracz podążył do gry. Jeśli gracz nie podążył za nikim w grze, ta właściwość będzie 0. Ta właściwość jest użyteczna do alarmowania graczy, którzy podążają za innym graczem w grę.

Możesz uzyskać nazwę gracza podążając używając tego użytkownika ID i funkcji Players:GetNameFromUserIdAsync().

local Players = game:GetService("Players")

local player = Players.LocalPlayer

local function onPlayerAdded(newPlayer)
	if newPlayer.FollowUserId == player.UserId then
		local hint = Instance.new("Hint")
		hint.Parent = player:WaitForChild("PlayerGui")
		hint.Text = "You were followed to this game by " .. newPlayer.Name .. "!"
		task.delay(3, function()
			if hint then
				hint:Destroy()
			end
		end)
	end
end

Players.PlayerAdded:Connect(onPlayerAdded)

Właściwość GameplayPaused wskazuje, czy gracz jest obecnie w stanie zawieszenia w miejscu z włączonym StreamingEnabled . Jest ustawiony na klienta, ale skopiowany na serwer. Aby określić statuszawieszenia, możesz użyć tej właściwości.

Zobacz również:

• Workspace.StreamingEnabled Który kontroluje czy włączone jest przesyłanie treści
• Workspace.StreamingIntegrityMode i Enum.StreamingIntegrityMode dla więcej szczegółów na temat tego, kiedy gry wstrzymane są.

Właściwość HasVerifiedBadge Player wskazuje, czy gracz ma aktywowany znчок.

Właściwość HealthDisplayDistance Player 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 StarterPlayer.HealthDisplayDistance przez domyślnie.

Jeśli widać barwę zdrowia ludoidu, możesz ustawić typ wyświetlania używając Humanoid.DisplayDistanceType .

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0

Właściwość Player z lokalnym ID pokazuje lokalny identyfikator lokalizacji, który ustawił lokalny gracz dla swojego kontoRoblox. Zawiera strunę z dwóch kodów literowych (na przykład „en-us”) dla lokalizacji.

Można użyć tego, aby określić demografię geograficzną graczy w bazie grze, a jest to również lokalizacja używana do automatycznej lokalizacji (patrz GuiBase2d.AutoLocalize), która jest w grze. Ta właściwość umożliwia dostęp do lokalizacji gracza z serwera.

Zobacz również LocalizationService.RobloxLocaleId , lokalizator lokalizacji używany do lokalizacji treści wewnętrznej. Będzie to inna wartość, gdy Roblox jeszcze nie wspiera lokalnie lokalizatora lokalizacji lokalnej.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

print(player.LocaleId)

Ta właściwość może być czytana tylko z tożsamości (nie może być ustawione na inny wpisywaćczłonkowstwa). Zawiera Enum.MembershipType enkumenium wpisywaćczłonkowstwa konto.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

if player.MembershipType == Enum.MembershipType.Premium then
	-- Take some action specifically for Premium members
end

Właściwość StarterPlayer ustawia odległość w studsach, przy której ten gracz będzie widział inne imiona Humanoid. Jeśli właściwość jest ustawiona na 0, imiona są ukryte. Ta właściwość jest ustawiona na StarterPlayer.NameDisplayDistance przez domyślnie.

Jeśli widać barwę zdrowia ludoidu, możesz ustawić typ wyświetlania używając Humanoid.DisplayDistanceType .

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0

Właściwość Neutralna określa, czy gracz jest w konkretnej drużynie.

• Gdy prawda, gracz nie jest w konkretnej drużynie. Oznacza to również, że właściwość Player.Team będzie nil i kolor Player.TeamColor będzie biały.
• Gdy fałszywy, gracz jest w drużynie specyficznej. Właściwość Player.Team będzie odpowiadać Team, na której znajduje się gracz, a 1> Class.Player.TeamColor1> .

local Players = game:GetService("Players")

local player = Players.LocalPlayer

if player.Neutral then
	print("Player is neutral!")
else
	print("Player is not neutral!")
end

Właściwość ReplicationFocus Player ustawia część, aby skupić replikację wokół gracza. Różne systemy Roblox, które komunikują się poprzez sieć (takie jak fizyka, przesyłanie i inne) replikują się w różnych szybkościach w zależności od tego, jak blisko obiektów jest fokusu replikacji.

Gdy ta właściwość jest nil, zwraca się do jej domyślnego zachowania, które jest traktowanie lokalnego gracza jego postaci PrimaryPart jako obiektu skupienia.

Ten właściwość powinien być ustawiony tylko na serwerze z Script , a nie LocalScript. Uwaga, że ta właściwość nie zmienia lub aktualizuje własności sieci części.

local Players = game:GetService("Players")

local PLAYER_NAME = "polarpanda16"

local player = Players:WaitForChild(PLAYER_NAME)

local part = Instance.new("Part")
part.Parent = workspace
part.Name = "ReplicationFocusPart"
part.Anchored = true
player.ReplicationFocus = part

Jeśli ustawiać, gracz będzie respawnować na podanym SpawnLocation . Ta właściwość może być ustawiona tylko poprzez Lua i musi zawierać odniesienie do ważnego SpawnLocation , który musi spełniać następujące kryteria:

• Potomstwo Workspace
• SpawnLocation.TeamColor ustawiony na Player.TeamColor lub SpawnLocation.Neutral

Jeśli RespawnLocation nie jest ustawiony na ważną SpawnLocation to wtedy zastosuje się domyślna logika spawningu. Aby uzyskać więcej informacji na ten temat, zobacz stronę dla SpawnLocation .

Alternatywy dla RespawnLocation

• A Player pojawi się z SpawnLocations należące do ich zespołu. W niektórych przypadkach może być prostsze zmienienie gracza Player.Team zamiast tego.
• Wdroż swoją własną niestandardową logikę spawnu używając PVInstance:PivotTo() , aby ręcznie przenieść Player.Character .

local Players = game:GetService("Players")

local function addSpawn(spawnLocation)
	-- listen for the spawn being touched
	spawnLocation.Touched:Connect(function(hit)
		local character = hit:FindFirstAncestorOfClass("Model")
		if character then
			local player = Players:GetPlayerFromCharacter(character)
			if player and player.RespawnLocation ~= spawnLocation then
				local humanoid = character:FindFirstChildOfClass("Humanoid")
				-- make sure the character isn't dead
				if humanoid and humanoid:GetState() ~= Enum.HumanoidStateType.Dead then
					print("spawn set")
					player.RespawnLocation = spawnLocation
				end
			end
		end
	end)
end

local firstSpawn

-- look through the workspace for spawns
for _, descendant in pairs(workspace:GetDescendants()) do
	if descendant:IsA("SpawnLocation") then
		if descendant.Name == "FirstSpawn" then
			firstSpawn = descendant
		end
		addSpawn(descendant)
	end
end

local function playerAdded(player)
	player.RespawnLocation = firstSpawn
end

-- listen for new players
Players.PlayerAdded:Connect(playerAdded)

-- go through existing players
for _, player in pairs(Players:GetPlayers()) do
	playerAdded(player)
end

Właściwość Zespół określa obiekt Team w usłudze Class

local Players = game:GetService("Players")
local Teams = game:GetService("Teams")

local teamPlaying = Teams.Playing
local teamSpectators = Teams.Spectating

local playCommand = "/play"

local function play(player)
	player.Team = teamPlaying
	player.TeamColor = teamPlaying.TeamColor
	-- Respawn the player (moves them to spawn location)
	player:LoadCharacter()
end

local function onPlayerDied(player, _character)
	-- When someone dies, put them on the spectator team
	player.Team = teamSpectators
end

local function onPlayerSpawned(player, character)
	local human = character:WaitForChild("Humanoid")
	human.Died:Connect(function()
		onPlayerDied(player, character)
	end)
end

local function onPlayerChatted(player, message)
	if message:sub(1, playCommand:len()):lower() == playCommand then
		play(player)
	end
end

local function onPlayerAdded(player)
	if player.Character then
		onPlayerSpawned(player, player.Character)
	end
	player.CharacterAdded:Connect(function()
		onPlayerSpawned(player, player.Character)
	end)
	player.Chatted:Connect(function(message, _recipient)
		onPlayerChatted(player, message)
	end)
end

for _, player in pairs(Players:GetPlayers()) do
	onPlayerAdded(player)
end
Players.PlayerAdded:Connect(onPlayerAdded)

local Players = game:GetService("Players")
local Teams = game:GetService("Teams")

-- Command to choose a team (note the trailing space)
local joinCommand = "/jointeam "

local function findTeamByName(name)
	-- First, check for the exact name of a team
	if Teams:FindFirstChild(name) then
		return Teams[name]
	end
	-- Let's check for case-insensitive partial matches, like "red" for "Red Robins"
	for _, team in pairs(Teams:GetChildren()) do
		if team.Name:sub(1, name:len()):lower() == name:lower() then
			return team
		end
	end
	-- If we get to this point, no team matched the one we were looking for :(
end

local function onPlayerChatted(player, message, _recipient)
	-- Note: string.sub(message, ...) is the same as message:sub(...)
	if message:sub(1, joinCommand:len()):lower() == joinCommand:lower() then
		-- Matched "/JOINTEAM xyz" to our join command prefix "/jointeam "
		local teamName = message:sub(joinCommand:len() + 1) -- Cut out the "xyz" from "/jointeam xyz"
		local team = findTeamByName(teamName)
		if team then
			-- Set the team!
			player.Team = team
			player.Neutral = false
		else
			-- Tell the player that team could not be found :(
			player.Team = nil
			player.Neutral = true
		end
	end
end

local function onPlayerAdded(player)
	player.Chatted:Connect(function(...)
		onPlayerChatted(player, ...)
	end)
end

Players.PlayerAdded:Connect(onPlayerAdded)

Właściwość TeamColor określa, z którym zespołem gracz jest powiązany zgodnie z jego Team.TeamColor . Zmienie tego właściwości zmieni Player.Team według tego, którego zespołu ma tę samą BrickColor dla ich 1>

Często lepszym rozwiązaniem jest ustawienie Player.Team na odpowiedni Team zamiast używania tej właściwości. Ustawienie tej właściwości często prowadzi do powtórzenia tej samej wartości BrickColor dla pewnej drużyny na wielu skryptach; to jest coś, czego chcesz uniknąć, gdy przestrzegasz zasady "N

local Players = game:GetService("Players")
local Teams = game:GetService("Teams")

local teamPlaying = Teams.Playing
local teamSpectators = Teams.Spectating

local playCommand = "/play"

local function play(player)
	player.Team = teamPlaying
	player.TeamColor = teamPlaying.TeamColor
	-- Respawn the player (moves them to spawn location)
	player:LoadCharacter()
end

local function onPlayerDied(player, _character)
	-- When someone dies, put them on the spectator team
	player.Team = teamSpectators
end

local function onPlayerSpawned(player, character)
	local human = character:WaitForChild("Humanoid")
	human.Died:Connect(function()
		onPlayerDied(player, character)
	end)
end

local function onPlayerChatted(player, message)
	if message:sub(1, playCommand:len()):lower() == playCommand then
		play(player)
	end
end

local function onPlayerAdded(player)
	if player.Character then
		onPlayerSpawned(player, player.Character)
	end
	player.CharacterAdded:Connect(function()
		onPlayerSpawned(player, player.Character)
	end)
	player.Chatted:Connect(function(message, _recipient)
		onPlayerChatted(player, message)
	end)
end

for _, player in pairs(Players:GetPlayers()) do
	onPlayerAdded(player)
end
Players.PlayerAdded:Connect(onPlayerAdded)

Id użytkownika to właściwość Class.Player , która zawiera czytelny identyfikator liczby, który Instance.Name identyfikuje każde konto użytkownika na Roblox. W przeciwieństwie do 1> Class.Instance.Name1> gracza, który może się zmieniać w zależności od obecnego nazwa użytkownikaużytkownika, ta w

Ten parametr jest niezbędny podczas zapisywania/ładowania danych gracza używając GlobalDataStores . Użyj unikalnego klucza gracza, aby każdy gracz miał unikalny klucz.

local Players = game:GetService("Players")

local function onPlayerAdded(player)
	print(player.UserId)
end

Players.PlayerAdded:Connect(onPlayerAdded)

local Players = game:GetService("Players")

local player = Players:GetPlayerByUserId(1)

if player then
	print("Player with userId 1 is in this server! Their name is: " .. player.Name)
else
	print("Player with userId 1 is not in this server!")
end

local BadgeService = game:GetService("BadgeService")
local Players = game:GetService("Players")

local OWNER_ID = 212423 -- can use game.CreatorId for published places
local BADGE_ID = 1

local ownerInGame = false

local function playerAdded(newPlayer)
	if newPlayer.UserId == OWNER_ID then
		-- if new player is the owner, set ownerInGame to true and give everyone the badge
		ownerInGame = true
		for _, player in pairs(Players:GetPlayers()) do
			-- don't award the owner
			if player ~= newPlayer then
				BadgeService:AwardBadge(player.UserId, BADGE_ID)
			end
		end
	elseif ownerInGame then
		-- if the owner is in the game, award the badge
		BadgeService:AwardBadge(newPlayer.UserId, BADGE_ID)
	end
end

local function playerRemoving(oldPlayer)
	if oldPlayer.UserId == OWNER_ID then
		ownerInGame = false
	end
end

Players.PlayerAdded:Connect(playerAdded)
Players.PlayerRemoving:Connect(playerRemoving)

local Players = game:GetService("Players")
local DataStoreService = game:GetService("DataStoreService")

local goldDataStore = DataStoreService:GetDataStore("Gold")

local STARTING_GOLD = 100

local function onPlayerAdded(player)
	local playerKey = "Player_" .. player.UserId

	local leaderstats = Instance.new("IntValue")
	leaderstats.Name = "leaderstats"

	local gold = Instance.new("IntValue")
	gold.Name = "Gold"
	gold.Parent = leaderstats

	local success, result = pcall(function()
		return goldDataStore:GetAsync(playerKey) or STARTING_GOLD
	end)
	if success then
		gold.Value = result
	else
		-- Failed to retrieve data
		warn(result)
	end

	leaderstats.Parent = player
end

Players.PlayerAdded:Connect(onPlayerAdded)

Funkcja ClearCharacterAppearance usuwa wszystkie Accessory, Shirt, Pants, 1> Class.CharacterMesh

Nie usuwa t-shirts , sieci głowicy lub twarzy.

Zwroty

local Players = game:GetService("Players")

local player = Players.LocalPlayer

local character = player.Character or player.CharacterAdded:Wait()

local function onChildRemoved(child)
	print(child.ClassName, "removed from character")
end

character.ChildRemoved:Connect(onChildRemoved)

player:ClearCharacterAppearance()
--> BodyColors removed from character
--> ShirtGraphic removed from character
--> Shirt removed from character
--> Pants removed from character
--> CharacterMesh removed from character
--> Hat removed from character
--> Shirt removed from character

Funkcja DistanceFromCharacter Player zwraca dystans między głową znaku a podanym punktem Vector3. Wynika 0, jeśli gracz nie ma Player.Character.

Przydatny jest to, gdy określa się dystans między innym obiektem lub lokalizacją w gra.

Jeśli chcesz określić dystans między dwoma nieobsługującymi instancjami lub pozycji, możesz użyć obserwuje:

local distance = (position1 - position2).magnitude

Parametry

Zwroty

local Players = game:GetService("Players")

for _, player in pairs(Players:GetPlayers()) do
	print(player:DistanceFromCharacter(Vector3.new(0, 0, 0)))
end

Zwraca słownik zawierający informacje opisujące, jak gracz doświadcza. Słownik zawiera dowolne z następujących poles:

<tbody>
  <tr>
    <th>Idź do źródła</th>
    <td>liczba</td>
    <td>The <code>Class.DataModel.GameId</code> of the experience the <code>Player</code> teleported from. Only present if the player teleports to the current experience and if a server calls the teleport function.</td>
  </tr>

  <tr>
    <th>Idź do źródła</th>
    <td>liczba</td>
    <td>Class.DataModel.PlaceId of the place the <code>Player</code> teleported from. Only present if the player teleports to the current place and a server calls the teleport function.</td>
  </tr>

  <tr>
    <th>Zgłoszony przez gracza</th>
    <td>liczba</td>
    <td>Class.Player.UserId gracza, który zaprosił bieżącego gracza do doświadczenia. Użyj tych danych, aby zidentyfikować referera i związać zasadę nagrody.</td>
  </tr>

  <tr>
    <th>Członkowie</th>
    <td>masz</td>
    <td>Materiały <code>Class.Player.UserId</code> zawierające liczby użytkowników teleportowanych obok <code>Player</code>. Obecny tylko wtedy, gdy gracz teleportował się jako część grupa.</td>
  </tr>

  <tr>
    <th>Teleportacja danych</th>
    <td>wartiant</td>
    <td>Odbiera <code>teleportData</code> określoną w oryginalnym teleportować się. Przydatny do udostępniania informacji między serwerami, do których teleportuje się gracz. Tylko prezentuje się, jeśli <code>teleportData</code> została określona i serwer wzywa funkcję teleportacji.</td>
  </tr>

  <tr>
    <th>Dane o uruchomieniu</th>
    <td>ciąg</td>
    <td>Oczywisty lub zaszyfrowany JSONowy ciąg, który zawiera dane uruchomienia określone w adresie URL <a href="../../../production/promotion/deeplinking.md">深链</a> lub <code>Class.ExperienceInviteOptions.LaunchData</code> .</td>
  </tr>
</tbody>

ZdobądźJoinData i TeleportData

Jeśli serwer inicjuje teleportować sięgracza, to słownik, który ten metodę zwraca, zawiera dane teleportacji gracza. Metoda Player:GetJoinData() może być używana tylko do uzyskania danych teleportacji na serwerze. Aby uzyskać dane na klienta, użyj metody TeleportService:GetLocalPlayerTeleportData().

Oprócz TeleportService:GetLocalPlayerTeleportData() , Player:GetJoinData() dostarcza tylko dane teleportu, które spełniają następujące kryteria bezpieczeństwa:

• Gwarantujemy, że został wysłany przez serwer Roblox w ciągu ostatnich 48 godzin.
• Gwarantujemy, że został wysłany z tym Player .
• SourcePlaceId i SourceGameId gwarantują, że są to miejsca i wszechświaty, z których dane zostały wysłane. Oznacza to, że możesz sprawdzić, że dane o teleportacji pochodzą z zatwierdzonego miejsce.

Ponieważ dane te są przesyłane przez klienta, nadal może być potencjalnie wykorzystywane przez eksploitera. Delikatne dane, takie jak waluta gracza, powinny być przesyłane za pośrednictwem bezpiecznego rozwiązania, takiego jak Przechowywanie pamięci.

Zwroty

local DataStoreService = game:GetService("DataStoreService")
local Players = game:GetService("Players")

local analyticsStore = DataStoreService:GetDataStore("Analytics")

local ALLOWED_SOURCES = {
	"twitter";
	"youtube";
	"discord";
}

local function onPlayerAdded(player)
	local source = player:GetJoinData().LaunchData
	-- check if the provided source is valid
	if source and table.find(ALLOWED_SOURCES, source) then
		-- update the data store to track the source popularity
		local success, result = pcall(analyticsStore.IncrementAsync, analyticsStore, source)

		if success then
	  	  print(player.Name, "joined from", source, "- total:", result)
		else
	  	  warn("Failed to record join source: " .. result)
		end
	end
end

Players.PlayerAdded:Connect(onPlayerAdded)

local Players = game:GetService("Players")

local player = Players.LocalPlayer

local DIRECT_JOIN_URL = "https://www.roblox.com/games/start?placeId=%d&launchData=%s"

local textBox = script.Parent

local function generateReferralURL(player)
	return DIRECT_JOIN_URL:format(
		game.PlaceId,
		player.UserId
	)
end

local function highlightAll()
	if -- avoid recursive property updates
		textBox:IsFocused()
		and not (
	  	  textBox.SelectionStart == 1
	  	  and textBox.CursorPosition == #textBox.Text + 1
		)
	then
		textBox.SelectionStart = 1
		textBox.CursorPosition = #textBox.Text + 1
	end
end

textBox.Focused:Connect(highlightAll)
textBox:GetPropertyChangedSignal("SelectionStart"):Connect(highlightAll)
textBox:GetPropertyChangedSignal("CursorPosition"):Connect(highlightAll)

textBox.TextEditable = false
textBox.ClearTextOnFocus = false

textBox.Text = generateReferralURL(player)

local HttpService = game:GetService("HttpService")

local DATA_CHARACTER_LIMIT = 200

local function encodeTableAsLaunchData(data)
	-- convert the table to a string
	local jsonEncodedData = HttpService:JSONEncode(data)

	if #jsonEncodedData <= DATA_CHARACTER_LIMIT then
		-- escape potentially invalid characters, such as spaces
		local urlEncodedData = HttpService:UrlEncode(jsonEncodedData)
		return true, urlEncodedData
	else
		-- report character limit error
		return false, ("Encoded table exceeds %d character limit"):format(DATA_CHARACTER_LIMIT)
	end
end

local sampleData = {
	joinMessage = "Hello!";
	urlCreationDate = os.time();
	magicNumbers = {
		534;
		1337;
		746733573;
	};
}

local success, encodedData = encodeTableAsLaunchData(sampleData)

if success then
	print(encodedData)
else
	warn("failed to encode launch data: " .. encodedData)
end

local HttpService = game:GetService("HttpService")
local Players = game:GetService("Players")

local function onPlayerAdded(player)
  	local launchData = player:GetJoinData().LaunchData
  	if launchData then
  		-- attempt to decode the data
  		local success, result = pcall(HttpService.JSONDecode, HttpService, launchData)
  		if success then
  			print(player.Name, "joined with data:", result)
  		else
  			-- this is probably due to the user messing with the URL
  			warn("Failed to parse launch data:" .. result)
  		end
  	end
end

Players.PlayerAdded:Connect(onPlayerAdded)

local Players = game:GetService("Players")

local approvedPlaceIds = { 1 } -- insert approved PlaceIds here

local function isPlaceIdApproved(placeId)
	for _, id in pairs(approvedPlaceIds) do
		if id == placeId then
			return true
		end
	end
	return false
end

local function onPlayerAdded(player)
	local joinData = player:GetJoinData()

	-- verify this data was sent by an approved place
	if isPlaceIdApproved(joinData.SourcePlaceId) then
		local teleportData = joinData.TeleportData
		if teleportData then
			local currentLevel = teleportData.currentLevel
			print(player.Name .. " is on level " .. currentLevel)
		end
	end
end

Players.PlayerAdded:Connect(onPlayerAdded)

Funkcja GetMouse Player zwraca Mouse używany przez gracz. Instancja miksera można używać do śledzenia wejścia miksera lewego i prawego przycisku myszy i ruchu i lokalizacji.

Usługa UserInputService dostarcza dodatkowe funkcje i wydarzenia do śledzenia wejścia użytkownika - szczególnie dla urządzeń, które nie używają myszy.

Notatka:

• Ten przedmiot musi być używany w LocalScript , aby działał jak oczekiwano online.
• Po aktualizacji w lipcu 2014 r. ikona myszy można teraz ustawić za pomocą tego metody.

Zwroty

local Players = game:GetService("Players")

local player = Players.LocalPlayer

local mouse = player:GetMouse()

local function onButton1Down()
	print("Button 1 is down")
end

mouse.Button1Down:Connect(onButton1Down)

GetNetworkPing zwraca izolowaną sieć latency z Player w sekundach. "Ping" to pomiar czasu potrzebnego na wysłanie danych z klienta na serwer, a następnie ponownie. Nie wiąże się to z dezserwowaniem lub przetwarzaniem danych.

Dla strony klienta LocalScripts , ta funkcja może być wywołana tylko na Players.LocalPlayer . Ta funkcja jest użyteczna w identyfikowaniu i debugowaniu problemów, które występują w wysokich sieciach zależności. Jest również użyteczna do maskowania latencji, takiej jak dostosowywanie szybkości rzucania animacji dla projektli.

Zwroty

Funkcja HasAppearanceLoaded Player zwraca, czy ładowanie widoku gracza Player.Character ładowane jest.

Wygląd gracza zawiera elementy, takie jak Shirt gracza, Pants i Accessories.

Przydatne jest ustalenie, czy wygląd gracza załadował się po raz pierwszy po dołączeniu do gry, co można śledzić za pomocą wydarzenia Players.PlayerAdded.

Zwroty

local Players = game:GetService("Players")

local function onPlayerAdded(player)
	local loaded = player:HasAppearanceLoaded()
	print(loaded)

	while not loaded do
		loaded = player:HasAppearanceLoaded()
		print(loaded)
		task.wait()
	end
end

Players.PlayerAdded:Connect(onPlayerAdded)

Zwraca wartość prawdziwą określającą status weryfikacji gracza. Gdy prawda, gracz jest weryfikowany. Weryfikacja obejmuje, ale nie jest ograniczona do, nie-VOIP numer telefonu lub weryfikacji tożsamości rządowego.

Podczas wdrożenia IsVerified uważaj, aby zagwarantować, że implementacja nie zablokuje niezweryfikowanych użytkowników nieprzypadkowo.

Uwaga, że metoda może być wywołana tylko na serwerze back-end. Wywołanie jej na stronie klienta spowoduje błąd. Ponadto ta metoda zawsze zwraca false w Studio.

Zwroty

local Players = game:GetService("Players")

local function onPlayerAdded(player)
  print(player:IsVerified())
end

for _, player in pairs(Players:GetPlayers()) do
  onPlayerAdded(player)
end
Players.PlayerAdded:Connect(onPlayerAdded)

Methode Kick() pozwala na ładne odłączenie klienta i możliwość opcjonalnego dostarczania wiadomości użytkownikowi odłączonemu. To użyteczne dla moderowania nadużywających użytkowników. Powinieneś pozwolić tylko zaufanym użytkownikom, którzy ufają, aby ten metod działał na innych użytkowników.

Calling this method on a Player with no arguments disconnects the user from the server and provides a default notice wiadomość. Calling this method on a Player along with a string as the first argument replaces the default message with the provided ciąg.

Kiedy używa się tego metody z LocalScript, tylko lokalny użytkownik może zostać wyrzucony.

Parametry

Zwroty

Funkcja Przenieś Player powoduje, że postać gracza chodzi w określonym kierunku do końca, lub jest przerwana przez gracza (używając jego elementy sterujące).

Przydatne jest to, gdy skryptuje się NPC Humanoids, który porusza się po mapie - ale nie jest kontrolowany przez rzeczywisty wpis gracza.

Uwaga, że drugi argument funkcji wskazuje, czy dostarczony Vector3 powinien przesuwać gracza względem światowych koordynat ( fałszywy ) lub gracza's Camera ( 1> prawdziwy1> ).

Parametry

Zwroty

local Players = game:GetService("Players")
local localPlayer = Players.LocalPlayer

-- Wait for the player's character and humanoid, which must exist before calling :Move()
local character = localPlayer.Character or localPlayer.CharacterAdded:Wait()
character:WaitForChild("Humanoid")

-- The player will move until they are 50 studs away from the camera's position at the time of running
localPlayer:Move(Vector3.new(0, 0, -50), true)

Funkcja SetAccountAge ustawia Player.AccountAge gracza w dni.

Służy do ustawienia właściwości Player, która opisuje, ile dni temu zostało zarejestrowane konto gracza.

To nie ustawia wieku gracza na konto, ale wieku konta sam w sobie w odniesieniu do czasu jego pierwszego utworzenia.

Parametry

Zwroty

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player:SetAccountAge(100)

local Players = game:GetService("Players")

local MAX_AGE_NEW_PLAYER = 7 -- one week
local MIN_AGE_VETERAN = 365 -- one year

-- This function marks a part with text using a BillboardGui
local function mark(part, text)
	local bbgui = Instance.new("BillboardGui")
	bbgui.AlwaysOnTop = true
	bbgui.StudsOffsetWorldSpace = Vector3.new(0, 2, 0)
	bbgui.Size = UDim2.new(0, 200, 0, 50)
	local textLabel = Instance.new("TextLabel")
	textLabel.Size = UDim2.new(1, 0, 1, 0) -- Fill parent
	textLabel.Text = text
	textLabel.TextColor3 = Color3.new(1, 1, 1)
	textLabel.TextStrokeTransparency = 0
	textLabel.BackgroundTransparency = 1
	textLabel.Parent = bbgui
	-- Add to part
	bbgui.Parent = part
	bbgui.Adornee = part
end

local function onPlayerSpawned(player, character)
	local head = character:WaitForChild("Head")
	if player.AccountAge >= MIN_AGE_VETERAN then
		mark(head, "Veteran Player")
	elseif player.AccountAge <= MAX_AGE_NEW_PLAYER then
		mark(head, "New Player")
	else
		mark(head, "Regular Player")
	end
end

local function onPlayerAdded(player)
	-- Listen for this player spawning
	if player.Character then
		onPlayerSpawned(player, player.Character)
	end
	player.CharacterAdded:Connect(function()
		onPlayerSpawned(player, player.Character)
	end)
end

Players.PlayerAdded:Connect(onPlayerAdded)

Ten metod ustawia, czy gracz widzi czat filtrowany przez TextService:FilterStringAsync() lub zwykłe czaty.

local Players = game:GetService("Players")

local player = Players.LocalPlayer
player:SetSuperSafeChat(true)

Niezależnie czy gracz miał włączoną filtrację czatu, cały czat powinien być filtrowany przez TextService przy nadawaniu do innych graczy lub na ekranie gracza. TextService:FilterStringAsync() zwraca obiekt TextFilterResult, który można filtrować w zależności od przeznaczenia wiadomość.

Parametry

Zwroty

Funkcja ta zwraca arkusz znajomych online, ograniczony przez wartość maxFriends. Funkcja używa 30-sekundowego zapisu.

W zwróconym arkuszu obiektów niektóre pola są tylko dla pewnych typów lokalizacji. Na przykład, PlaceId nie będzie obecny, gdy TypeLocation ma 0 (strona mobilna).

<tbody>
  <tr>
    <td><b>Id wizytówki</b></td>
    <td>liczba</td>
    <td>Class.Player.UserId of the znajomy.</td>
  </tr>

  <tr>
    <td><b>Imię użytkownika</b></td>
    <td>ciąg</td>
    <td>Imię znajomy.</td>
  </tr>

  <tr>
    <td><b>Imię wyświetlanie</b></td>
    <td>ciąg</td>
    <td>Class.Player.DisplayName znajomy.</td>
  </tr>

  <tr>
    <td><b>LastOnline)</b></td>
    <td>ciąg</td>
    <td>Kiedy przyjaciel był ostatnio online.</td>
  </tr>

  <tr>
    <td><b>Jest w trybie online</b></td>
    <td>boolean</td>
    <td>Jeśli przyjaciel jest obecnie online.</td>
  </tr>

  <tr>
    <td><b>Ostatni lokalizacja.</b></td>
    <td>ciąg</td>
    <td>Imię lokalizacji znajomy.</td>
  </tr>

  <tr>
    <td><b>Identyfikator miejsca</b></td>
    <td>liczba</td>
    <td>ID miejsca ostatniej lokalizacji znajomy.</td>
  </tr>

  <tr>
    <td><b>Id gry</b></td>
    <td>ciąg</td>
    <td>Model danych/Id punktu końca znajomy.</td>
  </tr>

  <tr>
    <td><b>Typ lokalizacji</b></td>
    <td>liczba</td>

    <td>
      Typ lokalizacji ostatniej lokalizacji znajomy:

      <table>
             0  >  Strona główna mobilna > 1> Strona główna1> > 4> Strona główna Xbox4> > 

        <tbody>
          7> Strona główna Xbox
        </tbody>

        7> > 0> Strona główna mobilna0> > 3> Strona główna3> > 6> Strona główna Xbox6> > 

        <tr>
          9> Strona główna mobilna
        </tr>

        9> > 2> Strona główna2> > 5> Strona główna mobilna5> > 

        8> Strona główna

        8> > 1> Strona główna
      </table>
    </td>
  </tr>
</tbody>