Pengguna dan pemain

Ketika seorang pengguna Roblox bergabung dengan permainan, mereka diwakili sebagai Player dalam DataModel. Objek Player ini berisi informasi tentang pengguna yang bersifat universal di seluruh permainan, seperti nama pengguna, daftar teman, dan karakter avatar yang disimpan, serta properti, metode, dan peristiwa yang mempengaruhi siklus hidup pengguna antara bergabung dan meninggalkan permainan. Setiap objek Player juga memiliki empat kontainer penting yang dapat Anda gunakan untuk menyesuaikan pengalaman pengguna: Backpack, StarterGear, PlayerGui, dan PlayerScripts.

Setiap Player juga mengekspos properti Player.User, yang merupakan nilai User yang mewakili identitas pengguna yang terikat pada domain dalam permainan saat ini. Untuk informasi lebih lanjut tentang cara kerja identifikasi pengguna, termasuk ID pengguna yang terikat pada domain dan tipe User, lihat Pengguna dan ID pengguna yang terikat pada domain.

Siklus Hidup

Layanan Players berisi semua instance Player dalam sebuah permainan. Skrip sisi klien dan server dapat terhubung ke peristiwa Players.PlayerAdded dan Players.PlayerRemoved untuk melakukan tindakan sebagai respons terhadap siklus hidup objek Player. Skrip juga dapat terhubung ke peristiwa Player.CharacterAdded dan Player.CharacterRemoving untuk melakukan tindakan terkait permainan ketika karakter muncul atau menghilang.

Bergabungnya Pengguna

Ketika klien pengguna terhubung ke sebuah permainan, peristiwa Players.PlayerAdded terjadi dan mengirimkan objek Player dari pengguna yang bergabung; Anda dapat menggunakan objek ini untuk berbagai tujuan seperti memuat data pengguna dari penyimpanan data atau menetapkan pemain ke sebuah tim.

Sebagai contoh, untuk memuat data pengguna ketika mereka bergabung dengan permainan, gunakan peristiwa PlayerAdded dalam sebuah Script untuk mengambil data pengguna yang disimpan dalam penyimpanan data berdasarkan ID pengguna mereka:

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

local playerDataStore = DataStoreService:GetDataStore("PlayerData")

Players.PlayerAdded:Connect(function(player)
	local userId = player.UserId

	-- Baca kunci penyimpanan data
	local getSuccess, currentData = pcall(function()
		return playerDataStore:GetAsync(userId)
	end)

	if getSuccess then
		print(currentData)
	end

	-- Lakukan tindakan lebih lanjut dengan currentData
end)

Munculnya Karakter

Secara default, model Player.Character pengguna mewakili avatar platform mereka dan Players.CharacterAutoLoads adalah true, yang berarti model karakter secara otomatis muncul ketika pengguna bergabung dengan permainan.

Ketika Player.Character pengguna muncul, Scripts dan LocalScripts dalam StarterCharacterScripts disalin ke dalam model karakter dan peristiwa Player.CharacterAdded terjadi. Peristiwa ini mengirimkan model karakter baru kepada pendengarnya yang dapat Anda gunakan untuk menemukan objek Humanoid karakter dan memodifikasi perilakunya. Sebagai contoh, Anda dapat menggunakan Humanoid:ApplyDescription() untuk mengubah pakaian avatar.

Menghilangnya Karakter

Ketika Humanoid pemain mati, server secara otomatis menghapus model karakter setelah waktu yang ditentukan oleh Players.RespawnTime. Anda kemudian dapat menggunakan peristiwa Player.CharacterRemoving untuk mereset objek lain atau memperbarui data yang terkait dengan karakter.

Pengguna Meninggalkan

Ketika klien pengguna terputus dari permainan, server menghancurkan objek Player yang terkait di dalam layanan Players. Pada titik ini, peristiwa Players.PlayerRemoving terjadi dan mengirimkan objek Player dari pengguna yang terputus. Anda dapat menggunakan ini untuk berbagai tujuan seperti menyimpan data pengguna, menghapus statistik pemain dari papan skor, atau menghancurkan model yang dibuat pemain dalam permainan.

Contoh Script berikut mendengarkan peristiwa PlayerRemoving dan mencoba menyimpan data pengguna dalam penyimpanan data berdasarkan ID pengguna mereka:

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

local playerDataStore = DataStoreService:GetDataStore("PlayerData")

Players.PlayerRemoving:Connect(function(player)
	local userId = player.UserId

	-- Dapatkan status data pemain dalam permainan
	local currentData = getCurrentData(player)

	-- Simpan ke penyimpanan data
	local setSuccess, errorMessage = pcall(function()
	    playerDataStore:SetAsync(userId, currentData)
	end)

	if not setSuccess then
	    warn(errorMessage)
	end
end)

Kontainer

Setiap objek Player yang mewakili klien pengguna menyimpan beberapa kontainer penting: Backpack, StarterGear, PlayerGui, dan PlayerScripts. Pada waktu runtime permainan, beberapa kontainer dalam model data "edit" menyalin kontennya ke kontainer Player ini, termasuk StarterGui ke PlayerGui, StarterPack ke Backpack, dan StarterPlayerScripts ke PlayerScripts.

Objek Tool dalam Backpack membentuk inventaris pemain dan ditampilkan sebagai tombol ikon di bagian bawah layar. Lihat alat dalam permainan untuk informasi lebih lanjut.

Seperti yang diilustrasikan di atas, konten dari StarterPack dan StarterGear pemain disalin ke Backpack ketika Character pemain muncul. Ketika karakter mati, klien menghancurkan Backpack dan menggantinya dengan yang baru.

Untuk menonaktifkan GUI inventaris default Roblox dan menggantinya dengan milik Anda sendiri, panggil StarterGui:SetCoreGuiEnabled() dalam sebuah LocalScript seperti yang dijelaskan dalam nonaktifkan UI default.

Larang Pengguna

Untuk memastikan kesopanan dan permainan yang adil dalam permainan Anda, Anda dapat melarang pengguna yang melanggar aturan atau pedoman komunitas. Anda dapat memodifikasi durasi larangan, pesan larangan, dan bahkan memperpanjang larangan ke akun alternatif yang mungkin. Saat menggunakan fitur ini, Anda harus mengikuti pedoman larangan dan pesan.

Anda memiliki beberapa opsi untuk bekerja dengan larangan:

• Setiap halaman permainan di Creator Hub memiliki dasbor Larangan.
• Untuk penggunaan programatik dengan API mesin, lihat Players:BanAsync().
• Untuk Open Cloud, lihat larangan dan blok.

Pemblokiran Perangkat

Selain melarang sebuah akun, Players:BanAsync() mendukung pemblokiran perangkat melalui bidang ApplyDeviceBlock dalam tabel konfigurasinya. Ketika Anda melarang pengguna yang saat ini terhubung ke permainan Anda dengan ApplyDeviceBlock diatur ke true, perangkat yang terkait dengan pengguna tersebut juga diblokir dari bergabung kembali selama 24 jam. Opsi ini menambah kesulitan terhadap penghindaran larangan; pemain yang dilarang tidak dapat segera bergabung kembali ke permainan dari akun baru di perangkat yang sama.

• Pemblokiran perangkat saat ini hanya berlaku untuk pemain di desktop (Windows dan macOS). Ini tidak berlaku untuk perangkat seluler atau konsol.
• Pemblokiran perangkat tidak menyebar sebagai larangan ke akun lain yang telah menggunakan perangkat tersebut.
• Memanggil API pencabutan larangan pada pengguna yang terpengaruh segera menghapus pemblokiran perangkat aktif yang terkait dengan perangkat pengguna tersebut, memungkinkan mereka untuk bergabung kembali ke permainan.

Pedoman Larangan

Saat menerapkan larangan dalam permainan Anda, patuhi pedoman berikut:

• Aturan permainan tidak boleh bertentangan dengan Standar Komunitas dan Ketentuan Penggunaan Roblox. Misalnya, Anda tidak dapat membuat aturan permainan yang mengecualikan seseorang karena jenis kelamin mereka, karena ini melanggar Kebijakan Diskriminasi, Kata Kasar, dan Ujaran Kebencian Roblox.
• Pembuat harus dengan jelas menyatakan aturan permainan mereka di tempat yang dapat diakses oleh semua pengguna.
• Pembuat harus menerapkan aturan permainan mereka secara adil dan tidak secara sewenang-wenang menargetkan pengguna tertentu.
• Pengguna dapat mengajukan banding kepada pembuat secara langsung jika mereka percaya larangan mereka tidak benar. Roblox tidak akan menengahi banding ini, kecuali pengguna percaya bahwa aturan permainan pembuat atau penegakan aturan mereka melanggar Standar Komunitas.
• Roblox dapat memoderasi sebuah permainan jika ada alasan untuk percaya bahwa aturan permainan pembuat atau penegakan aturan mereka melanggar Standar Komunitas.

Pedoman Pesan

Ketika seorang pengguna dilarang, mereka menerima modal kesalahan yang menampilkan informasi seperti durasi larangan dan alasan. Dalam pesan yang difilter teks, Anda dapat menyertakan informasi tambahan seperti informasi banding atau kontak selama Anda memenuhi Standar Komunitas Roblox.

Sebagai contoh, dalam pesan larangan Anda, Anda diizinkan untuk merujuk merek dan platform:

• "Kunjungi Discord di grup/halaman permainan saya"
• "Pesan saya di Twitter atau X"

Penyebutan informasi pribadi atau tautan langsung tidak diperbolehkan dalam bidang pesan ini. Ini termasuk memposting nama pengguna atau pegangan tertentu, atau memberikan tautan langsung ke server Discord atau akun X.