Player

The AccountAge adalah property Player yang menggambarkan berapa lama waktu yang telah diperbarui account pemain dalam hari. Ini diatur menggunakan fungsi Player:SetAccountAge(), yang tidak dapat diakses oleh skrip.

Item ini berguna untuk menampilkan konten pemain Roblox baru secara kondisional seperti tutorial.

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)

Properti AutoJumpEnabled menentukan apakah Player.Character dari Class.Player menggunakan perangkat seluler akan secara otomatis melompat ketika mereka menabrakkan rintangan. Ini dapat membuat tingkat lebih terselubung saat berada di perangkat seluler.

Ketika pemain bergabung dengan game, nilai StarterPlayer.AutoJumpEnabled menentukan status awal dari prop ini. Kemudian, prop ini menentukan nilai Humanoid.AutoJumpEnabled dari prop Player.Character saat menelur. Secara kata l

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

Hak CameraMaxZoomDistance Player menetapkan jarak maksimum dalam studs kamera dapat berasal dari karakter dengan kamera default.

Dengan kata lain, itu mengontrol jarak maksimum yang diizinkan kamera pemain untuk mengekspor.

Nilai default dari properti ini ditetapkan oleh StarterPlayer.CameraMaxZoomDistance . Jika nilai ini ditetapkan ke nilai yang lebih rendah dari Player.CameraMinZoomDistance, itu akan ditingkatkan ke CameraMinZoomDistance.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75

KameraMinZoonDistance Player property menetapkan jarak minimum dalam studs kamera dapat berasal dari karakter dengan kamera default.

Dengan kata lain, itu mengontrol jarak minimum yang diizinkan kamera pemain untuk zoom dalam.

Nilai default dari properti ini ditetapkan oleh StarterPlayer.CameraMinZoomDistance . Jika nilai ini ditetapkan ke nilai yang lebih tinggi dari Player.CameraMaxZoomDistance itu akan dikurangi menjadi CameraMaxZoomDistance.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75

Properti CameraMode mengatur mode kamera pemain, beralih ke mode pihak ketiga.

Orang Ketiga

Dalam mode orang ketiga default ( Enum.CameraMode.Classic ) , karakter dapat dilihat di kamera. Saat dalam mode ini, perilaku default adalah:

• Pemain dapat menekan tombol kanan dan menyeret (mouse), mengetuk dan menyeret (Mobile), menggunakan tombol penggeseran sekunder (Gamepad), atau menekan tombol kiri/kanan (Keyboard) untuk memutar kamera di sekitar karakter mereka.
• Ketika pemain menggerakkan karakter mereka, itu menghadap ke arah gerakan yang sesuai.
• Pemain dapat mengeklik dan mengeklik keluar secara bebas, bahkan kepada orang pertama di zoom penuh.

Orang Pertama

Pada mode orang pertama ( Enum.CameraMode.LockFirstPerson )), kamera pemain diperbesar sepanjang jalan. Kecuali ada GUI yang terlihat dengan set kepemilikan GuiButton.Modal , menyesuaikan pemindah mouse, mengetuk-拖动 di perangkat seluler, atau menggunakan tombol penggeseran sekunder di gamepad akan

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CameraMode = Enum.CameraMode.LockFirstPerson

Karakteristik CanLoadCharacter Player property menentukan apakah tampilan karakter akan dimuat saat pemain bertelur.Nilai default dari property ini ditetapkan oleh StarterPlayer.LoadPlayerAppearance.

Jika benar , karakter akan memuat tampilan pemain yang sesuai dengan Player.CharacterAppearanceId pemain.

Jika palsu, pemain akan muncul dengan tampilan default - model karakter abu-abu tanpa topi, kemeja, celana, dll.

Mencoba untuk menetapkan property setelah karakter telah bertelur tidak akan mengubah karakter, Anda harus memanggil Player:LoadCharacter() untuk memuat penampilanbaru.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CanLoadCharacterAppearance = false

Properti Karakter memuat referensi ke Model yang berisi Humanoid , bagian tubuh, skrip, dan objek lainnya yang di

Awalnya property ini adalah nil dan diatur ketika karakter pemain pertama kali muncul. Gunakan acara Player.CharacterAdded untuk mendeteksi ketika karakter pemain benar-benar dimuat, dan acara Player.CharacterRemoving untuk mendeteksi ketika karakter akan despawn. hind

Catat bahwa LocalScripts yang diklon dari StarterGui atau StarterPack

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

Properti ini menentukan ID pengguna akun cuy karakter tampilannya digunakan untuk Class.Player.Character pemain. Secara default, properti ini adalah Player.Character, yang menggunakan avatar pemain sebagai mereka telah menciptakannya di situs web Roblox.

Mengubah property ini menjadi ID pengguna account lain akan menyebabkan pemain muncul dengan penampilan akuntersebut (topi, kemeja, celana, dll).

Game juga dapat menyalakan apakah atau tidak tampilan karakter pemain dimuat dalam game dengan mengubah StarterPlayer.LoadCharacterAppearance property.

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)

Mendefinisikan cara skrip kamera default menangani objek di antara kamera dan subjek kamera. Diatur oleh StarterPlayer.DevCameraOcclusionMode dan tidak dapat diubah untuk pemain individual.

Nilai default adalah Zoom (0). Lihat Enum.DevCameraOcclusionMode untuk daftar mode yang tersedia.

Prop DevComputerCameraMode menentukan cara pemain menggerakkan kamera mereka saat menggunakan perangkat dengan mouse dan keyboard. Lihat Enum.DevComputerCameraMovementMode untuk deskripsi setiap mode kontrol kamera yang tersedia. Prop ini tidak dapat diatur menggunakan LocalScript (harus diatur di server menggunakan Script).

Nilai default dari properti ini ditentukan oleh StarterPlayer.DevComputerCameraMovementMode .

Kata "Komputer" dalam nama kepemilikan ini mengacu pada perangkat tidak- TouchEnabled , perangkat tidak- GamepadEnabled .

Ketika diatur ke Pilihan Pengguna , seorang pemain dapat memilih antara mode kontrol apa pun (kecuali Scriptable ) dalam pengaturan permainan Roblox. Secara umum, ide yang baik adalah memungkinkan pemain untuk memilih mode kontrol mereka untuk meningkatkan aksesibilitas.

Mungkin untuk membuat skema kontrol khusus dengan menetapkan propperti ini ke Scriptable .

Properti ini tidak meng影响 pemain yang menggunakan perangkat sentuh yang aktif. Lihat Player.DevTouchCameraMode sebagai gantinya.

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

Propiedad DevComputerMovementMode menentukan cara pemain menggerakkan karakter mereka ketika menggunakan perangkat dengan mouse dan keyboard. Lihat Enum.DevComputerMovementMode untuk deskripsi setiap mode gerakan kontrol tersedia. Propiedad ini tidak dapat diatur menggunakan LocalScript (harus diatur di server menggunakan Script).

Nilai default dari properti ini ditentukan oleh StarterPlayer.DevComputerMovementMode .

Kata "Komputer" dalam nama kepemilikan ini mengacu pada perangkat non- TouchEnabled .

Ketika diatur ke Pilihan Pengguna , seorang pemain dapat memilih antara mode kontrol apa pun (kecuali Scriptable ) dalam pengaturan permainan Roblox. umum, ide yang baik adalah memungkinkan pemain untuk memilih mode kontrol mereka untuk meningkatkan aksesibilitas.

Mungkin untuk membuat skema kontrol khusus dengan menetapkan propperti ini ke Scriptable .

Properti ini tidak meng影响 pemain yang menggunakan perangkat yang didukung sentuh. Lihat Player.DevTouchMovementMode sebagai gantinya.

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)

Elemen ini menentukan apakah seorang pemain dapat mengubah Mouse kunci dengan menekan Shift . Seorang pemain dapat menonaktifkan tombol kunci mouse di pengaturan permainan Roblox. Secara default, elemen ini diatur ke nilai Class.StarterPlayer.Enable

Ketika mouse lock aktif, cursor pemain dikunci ke tengah layar. Menggerakkan mouse akan mengorbit kamera di sekitar pemain character , dan karakter akan menghadapi arah yang sama dengan camera . Ini juga menyetel tampilan kamera hanya di atas bahun pemain.

Catat bahwa API terkait geser-lock sedang dalam proses dihapus, jadi disarankan untuk menggunakan UserInputService.MouseBehavior alih-alih mengunci mouse.

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)

속성 DevTouchCameraMode menentukan cara pemain menggerakkan kamera mereka ketika menggunakan perangkat TouchEnabled. Lihat Enum.DevTouchCameraMovementMode untuk deskripsi setiap mode kontrol kamera yang tersedia. Hal ini tidak dapat diatur menggunakan Class.LocalScript

Nilai default dari properti ini ditentukan oleh StarterPlayer.DevTouchCameraMovementMode .

Ketika diatur ke Pilihan Pengguna , seorang pemain dapat memilih antara mode kontrol apa pun (kecuali Scriptable ) dalam pengaturan permainan Roblox. umum, ide yang baik adalah memungkinkan pemain untuk memilih mode kontrol mereka untuk meningkatkan aksesibilitas.

Mungkin untuk membuat skema kontrol khusus dengan menetapkan propperti ini ke Scriptable .

Properti ini tidak meng影响 menggunakan perangkat yang tidak menggunakan sentuh-aktif. Lihat Player.DevComputerCameraMovementMode sebagai gantinya.

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

Propiedad DevTouchMovementMode menentukan cara pemain menggerakkan karakter mereka ketika menggunakan perangkat TouchEnabled. Lihat Enum.DevTouchMovementMode untuk deskripsi setiap mode gerakan kontrol tersedia. Propiedad ini tidak dapat diatur menggunakan Class.

Nilai default dari properti ini ditentukan oleh StarterPlayer.DevTouchMovementMode .

Ketika diatur ke Pilihan Pengguna , seorang pemain dapat memilih antara mode kontrol apa pun (kecuali Scriptable ) dalam pengaturan permainan Roblox. Secara umum, ide yang baik adalah memungkinkan pemain untuk memilih mode kontrol mereka untuk meningkatkan aksesibilitas.

Mungkin untuk membuat skema kontrol khusus dengan menetapkan propperti ini ke Scriptable .

Properti ini tidak meng影响 pemain yang tidak menggunakan perangkat yang didukung sentuh. Lihat Player.DevComputerMovementMode sebagai gantinya.

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 adalah properti Player yang berisi nama layar pengguna yang terkait dengan objek Player. Beda dengan nama pengguna, nama layar adalah nama yang tidak unik yang pemain menunjukkan kepada orang lain. Jika pengguna Roblox belum memilih salah sat

Catatan:

• Karena nama layar tidak unik, mungkin bagi dua pemain di instansi tunggal untuk memiliki nama yang sama. Jika Anda memerlukan identitas unik global untuk pemain, gunakan Player.UserId (yang merupakan identitas statis) atau Player.Name (yang merupakan nama pengguna saat ini) alih-alih.
• Karakter yang dihasilkan dengan Player.LoadCharacter atau oleh mesin Roblox akan memiliki property Humanoid.DisplayName yang ditetapkan ke properti Player.DisplayName .
• Nama tampilan mungkin memiliki karakter unicode di string. Lihat UTF-8 untuk lebih banyak informasi tentang cara bekerja dengan string dengan karakter unicode.

The FollowUserId adalah properti Player yang berisi Player.UserId dari pengguna yang diikuti ke dalam game. Jika pemain tidak mengikuti siapa pun ke dalam game, properti ini akan menjadi 0. Properti ini berguna untuk mengirimkan pemain yang telah diikuti oleh pemain lain ke dalam game.

Anda dapat mendapatkan nama pemain yang diikuti menggunakan user ID ini dan fungsi 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)

GameplayPaused property menunjukkan apakah pemain berada dalam kondisi暂停 di tempat dengan StreamingEnabled yang aktif. Ini ditetapkan di klien tetapi direplikasi ke server. Untuk menentukan status暂停, Anda dapat menggunakan property ini.

Lihat juga:

• Workspace.StreamingEnabled yang mengontrol apakah streaming konten diaktifkan
• Workspace.StreamingIntegrityMode dan Enum.StreamingIntegrityMode untuk lebih banyak informasi tentang kapan gameplay dihentikan.

Properti HasVerifiedBadge Player menunjukkan apakah pemain memiliki Lencana Terverifikasi.

Properti HealthDisplayDistance Player menetapkan jarak dalam studs di mana pemain ini akan melihat bar kesehatan lainnya Humanoid . Jika diatur ke 0, bar kesehatan tidak akan ditampilkan. Propperti ini diatur ke StarterPlayer.HealthDisplayDistance secara default.

Jika bar kesehatan Humanoid terlihat, Anda dapat mengatur jenis tampilan menggunakan Humanoid.DisplayDistanceType .

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0

Properti LocaleId Player menunjukkan lokasi lokasi yang telah ditetapkan oleh pemain lokal untuk akun Roblox mereka. Ini berisi string dengan dua kode huruf (seperti, "en-us") untuk lokasi.

Hal ini dapat digunakan untuk menentukan demografi geografis pemain base game Anda, dan juga lokasi yang akan digunakan untuk lokalisasi otomatis lokal (lihat GuiBase2d.AutoLocalize ) dari konten dalam pengalaman. Hal ini memungkinkan akses ke lokasi pemain dari server.

Lihat juga LocalizationService.RobloxLocaleId, ID lokasi yang digunakan untuk lokalisasi konten internal. Ini akan menjadi nilai yang berbeda ketika Roblox belum secara internal mendukung lokasi pemain lokal.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

print(player.LocaleId)

Item ini hanya dapat dibaca untuk menentukan keanggotaan (tidak dapat disetel ke ketikkeanggotaan lain). Ini berisi Enum.MembershipType enum dari ketikkeanggotaan akun.

local Players = game:GetService("Players")

local player = Players.LocalPlayer

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

NamaDisplayDistance StarterPlayer property menyetel jarak dalam studs di mana pemain ini akan melihat nama Humanoid lainnya. Jika property di set ke 0, nama dikurung. This property set to StarterPlayer.NameDisplayDistance by default.

Jika bar kesehatan Humanoid terlihat, Anda dapat mengatur jenis tampilan menggunakan Humanoid.DisplayDistanceType .

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0

Prop Neutral menentukan apakah pemain berada di tim tertentu.

• Ketika benar , pemain tidak berada di tim khusus. Ini juga berarti bahwa properti Player.Team akan menjadi nol dan Player.TeamColor akan menjadi putih.
• Ketika false , pemain berada di tim khusus. Proprietas Player.Team akan sesuai dengan Team yang pemain berada di, sementara 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

Properti ReplicationFocus Player menetapkan bagian untuk fokus replikasi di sekitar seorang Pemain. Berbagai sistem Roblox yang berkomunikasi melalui jaringan (seperti fisika, streaming, dll) mengkloning pada tingkat yang berbeda tergantung pada seberapa dekat objek berada dengan fokus replikasi.

Ketika nilValue ini nol, itu kembali ke perilaku defaultnya yang adalah untuk mengolah karakter lokal pemain sebagai fokus replikasi.

Properti ini hanya boleh diatur di server dengan Script, bukan LocalScript. Catat bahwa properti ini tidak mengubah atau menyetujui kepemilikan jaringan bagian.

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

Jika diatur, pemain akan respawn di SpawnLocation yang diberikan. Properti ini hanya dapat ditetapkan melalui Lua dan harus berisi referensi ke SpawnLocation yang valid, yang harus memenuhi kriteria berikut:

• Cetus dari Workspace
• SpawnLocation.TeamColor di set ke Player.TeamColor atau SpawnLocation.Neutral

Jika RespawnLocation tidak diatur ke lokasi bertarif yang valid maka logika bertarif bawaan akan diterapkan. Untuk lebih banyak informasi tentang hal ini, lihat halaman untuk SpawnLocation.

Alternatif untuk RespawnLocation

• Sebuah Player akan muncul dari SpawnLocations yang berada di bawah kendali tim mereka. Dalam beberapa kasus, mungkin lebih mudah untuk mengubah Player.Team pemain daripada.
• Menerapkan logika spawn khusus Anda dengan menggunakan PVInstance:PivotTo() untuk secara manual pindahkan 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

Properti Tim adalah referensi ke objek Team di dalam layanan

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)

Prop TeamColor menentukan tim mana yang dimiliki Pemain berdasarkan Class.Team.TeamColor tim tersebut. Mengubah prop ini akan mengubah Class.Player.Team menjadi Player.Team sesuai dengan tim mana yang memiliki BrickColor yang sama untuk

Seringkali merupakan ide yang lebih baik untuk menetapkan Player.Team ke Team masing-masing alih-alih menggunakan nilai BrickColor ini. Mengatur nilai BrickColor ini sering menyebabkan duplikasi nilai BrickColor yang sama untuk tim tertentu di banyak script; ini adalah sesuatu yang ingin Anda hindari saat mengik

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)

UserId adalah Player property yang berisi angka integer yang unik dan konsisten yang mengidentifikasi setiap account pengguna di Roblox. Berbeda dengan Instance.Name dari seorang Pemain, nilai ini tidak akan pernah berubah untuk akun yang sama.

Elemen ini penting saat menyimpan/memuat data pemain menggunakan GlobalDataStores . Gunakan kunci penyimpanan pemain sebagai kunci penyimpanan data sehingga setiap pemain memiliki unitunik.

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)

Fungsi ClearCharacterAppearance menghapus semua Accessory, Shirt, Pants, 1> Class.CharacterMesh1>

Ini tidak menghapus t-shirts , head meshes, atau wajah.

Memberikan nilai

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

Fungsi DistanceFromCharacter Player mengembalikan jarak antara kepala karakter dan titik Vector3 yang diberikan. Ini mengembalikan 0 jika pemain tidak memiliki Player.Character.

Ini berguna ketika menentukan jarak antara pemain dan lokasi atau objek lain dalam game.

Jika Anda ingin menentukan jarak antara dua instans non-player atau posisi, Anda dapat menggunakan mengikuti:

local distance = (position1 - position2).magnitude

Parameter

Memberikan nilai

local Players = game:GetService("Players")

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

Mengembalikan kamus yang menggambarkan cara pemain bergabung dengan pengalaman. Kamus ini berisi salah satu dari berikut:

<tbody>
  <tr>
    <th>Permainan Sumber</th>
    <td>nomor</td>
    <td>The <code>Class.DataModel.GameId</code> of the experience the <code>Pemain</code> teleported from. Hadir hanya jika pemain teleport ke pengalaman saat ini dan jika server menelepon fungsi teleport.</td>
  </tr>

  <tr>
    <th>Penempatan Sumber</th>
    <td>nomor</td>
    <td>The <code>Class.DataModel.PlaceId</code> of the place the <code>Pemain</code> teleported from. Hadir hanya jika pemain teleport ke tempat saat ini dan server menelepon fungsi teleport.</td>
  </tr>

  <tr>
    <th>Direferensikan oleh pemain</th>
    <td>nomor</td>
    <td>The <code>Class.Player.UserId</code> of the player who invited the current player to the experience. Gunakan data ini untuk mengidentifikasi referrer dan menyetel logika hadiah.</td>
  </tr>

  <tr>
    <th>Anggota</th>
    <td>array</td>
    <td>Sebuah matriks yang berisi Class.Player.UserId nomor pengguna yang diteleportasi bersama dengan Pemain. Hanya hadir jika pemain diteleportasi sebagai bagian dari grup.</td>
  </tr>

  <tr>
    <th>Teleportasi Data</th>
    <td>varian</td>
    <td>Mengembalikan <code>teleportData</code> yang ditentukan dalam berteleportasiasli. Berguna untuk berbagi informasi antara server pemain yang ditempatkan. Hanya hadir jika <code>teleportData</code> ditentukan dan server memanggil fungsi teleport.</td>
  </tr>

  <tr>
    <th>Data Peluncuran</th>
    <td>string</td>
    <td>String sederhana atau JSON yang dimodifikasi dalam URL <a href="../../../production/promotion/deeplinking.md">深 link</a> atau <code>Class.ExperienceInviteOptions.LaunchData</code> .</td>
  </tr>
</tbody>

DapatkanJoinData dan TeleportData

Jika server menginisialisasi berteleportasiPemain, definisi yang dikembalikan metode ini termasuk data teleportasi pemain. Metode Player:GetJoinData() hanya dapat digunakan untuk mengambil data teleportasi di server. Untuk mengambil data di klien, gunakan TeleportService:GetLocalPlayerTeleportData().

Tidak seperti TeleportService:GetLocalPlayerTeleportData() , Player:GetJoinData() hanya menyediakan data teleport yang memenuhi kriteria keamanan berikut:

• Ini dijamin telah dikirim oleh server Roblox dalam 48 jam terakhir.
• Dijamin telah dikirim dengan ini Player .
• SourcePlaceId dan SourceGameId dijamin untuk menjadi tempat dan alam semesta di mana data dikirim. Ini berarti Anda dapat memverifikasi bahwa data teleport berasal dari tempat yang disetujui.

Karena data ini dikirim oleh klien, itu masih bisa dimanfaatkan oleh seorang pengeksploiter. Data sensitif seperti mata uang pemain harus dikirim melalui solusi keamanan seperti Memori Tokens.

Memberikan nilai

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)

Fungsi GetMouse Player mengembalikan Mouse yang digunakan oleh klien. Instans mouse pemain dapat digunakan untuk melacak masukan mouse pengguna termasuk klik mouse kiri dan kanan mouse dan lokasi dan lokasi.

Layanan UserInputService menyediakan fungsi dan acara tambahan untuk melacak masukan pengguna - terutama untuk perangkat yang tidak menggunakan mouse.

Catatan:

• Item ini harus digunakan dalam LocalScript untuk bekerja seperti yang diharapkan secara online.
• Setelah pembaruan pada bulan Juli 2014, icon mouse sekarang dapat diatur dengan metode ini.

Memberikan nilai

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)

DapatkanNetworkPing mengembalikan kelambatan jaringan yang terisolasi dari Player dalam detik. "Ping" adalah pengukuran waktu yang dibutuhkan untuk mengirim data dari klien ke server, lalu kembali lagi. Ini tidak melibatkan desialisasi atau pemrosesan data.

Untuk client-side LocalScripts, fungsi ini hanya dapat dipanggil di Players.LocalPlayer. Fungsi ini berguna dalam mengidentifikasi dan men-debug masalah yang terjadi dalam skenario jaringan tinggi. Ini juga berguna untuk menyembunyikan latensi, seperti menyesuaikan kecepatan animasi untuk proyektil.

Memberikan nilai

Fungsi HasAppearanceLoaded Player mengembalikan apakah atau tidak penampilan pemain Player.Character telah dimuat.

Penampilan pemain termasuk item seperti Class.Shirt pemain, Shirt , dan Pants .

Ini berguna ketika menentukan apakah penampilan pemain telah dimuat setelah mereka pertama kali bergabung dengan game, yang dapat diperbarui menggunakan acara Players.PlayerAdded.

Memberikan nilai

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)

Mengembalikan nilai booleh yang menunjukkan status verifikasi pemain. Saat benar, pemain dinyatakan verifikasi. Verifikasi termasuk, tetapi bukan terbatas pada, nomor telepon non-VOIP atau verifikasi ID pemerintah.

Saat menerapkan IsVerified, latih perhatian untuk memastikan bahwa implementasi tidak secara tidak sengaja memblokir semua pengguna yang tidak terverifikasi.

Catat bahwa metode ini hanya dapat dipanggil di server backend. Menangginya dari sisi klien akan menghasilkan kesalahan. Selain itu, metode ini akan selalu mengembalikan false di Studio.

Memberikan nilai

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)

Metode Kick() memungkinkan pengalaman untuk dengan sopan menghubungkan klien dan opsi untuk memberikan pesan kepada pengguna yang terputus. Ini berguna untuk moderasi pengguna yang berlebihan. Anda hanya boleh mengizinkan pengguna spesifik yang Anda percaya untuk mengaktifkan metode ini pada pengguna lain.

Memanggil metode ini di Player tanpa argumen menghubungkan pengguna dari server dan menyediakan pesan pemberitahuan default. Memanggil metode ini di Player bersama dengan string sebagai argumen pertama menghapus pesan default dengan string yang disediakan.

Ketika menggunakan metode ini dari LocalScript, hanya klien pengguna lokal yang bisa diusir.

Parameter

Memberikan nilai

Fungsi Pindah Player menyebabkan karakter pemain berjalan dalam arah yang diberikan sampai dihentikan, atau ditangani oleh pemain (menggunakan kendalimereka).

Ini berguna ketika menyetel NPC Humanoids yang bergerak di sekitar peta - tetapi tidak dikendalikan oleh masukan pemain nyata.

Catat bahwa argumen kedua fungsi menunjukkan apakah Vector3 yang disediakan harus pindah pemain relatif ke koordinat dunia ( false ) atau Camera ( 1> true1> ) pemain.

Parameter

Memberikan nilai

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)

Fungsi SetAccountAge menetapkan Player.AccountAge pemain dalam hari.

Ini digunakan untuk menetapkan Player property yang menggambarkan berapa lama waktu sejak akun pemain terdaftar dalam hari.

Ini tidak menetapkan usia pemain di akun, tetapi usia akun itu sendiri relatif terhadap ketika dibuat pertama kali.

Parameter

Memberikan nilai

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)

Metode ini menetapkan apakah atau tidak pemain melihat obrolan yang disaring oleh TextService:FilterStringAsync() daripada chatting normal.

local Players = game:GetService("Players")

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

Terlepas dari apakah pemain telah menyaring obrolan diaktifkan, semua obrolan harus disaring oleh TextService saat dibث ke pemain lain atau di layar pemain sendiri. TextService:FilterStringAsync() mengembalikan objek TextFilterResult yang dapat disaring secara berbeda menurut tujuan pengguna.

Parameter

Memberikan nilai

Fungsi ini mengembalikan array teman online, terbatas oleh nilai maxFriends. Fungsi menggunakan cache 30 detik.

Dalam array yang dikembalikan, beberapa kolom hanya hadir untuk jenis lokasi tertentu. Misalnya, PlaceId tidak akan hadir ketika TypeLokasi adalah 0 (Situs Web Seluler).

<tbody>
  <tr>
    <td><b>KunjungiId</b></td>
    <td>nomor</td>
    <td>The <code>Class.Player.UserId</code> of the teman.</td>
  </tr>

  <tr>
    <td><b>Nama Pengguna</b></td>
    <td>string</td>
    <td>Nama pengguna teman.</td>
  </tr>

  <tr>
    <td><b>Nama Layar</b></td>
    <td>string</td>
    <td>Class.Player.DisplayName teman.</td>
  </tr>

  <tr>
    <td><b>Terakhir Online</b></td>
    <td>string</td>
    <td>Ketika teman terakhir online.</td>
  </tr>

  <tr>
    <td><b>Adalah Online</b></td>
    <td>boolean</td>
    <td>Jika teman itu saat ini online.</td>
  </tr>

  <tr>
    <td><b>LastLocation</b></td>
    <td>string</td>
    <td>Nama lokasi teman saat ini.</td>
  </tr>

  <tr>
    <td><b>TempatId</b></td>
    <td>nomor</td>
    <td>ID tempat teman terakhir.</td>
  </tr>

  <tr>
    <td><b>GameId</b></td>
    <td>string</td>
    <td>DataModel/JobId dari lokasi terakhir teman.</td>
  </tr>

  <tr>
    <td><b>Jenis Lokasi</b></td>
    <td>nomor</td>

    <td>
      Jenis lokasi tempat teman terakhir berada:

      <table>
         
      </table>
    </td>
  </tr>
</tbody>