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 mereka, 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 wadah penting yang dapat Anda gunakan untuk menyesuaikan pengalaman pengguna: Backpack, StarterGear, PlayerGui, dan PlayerScripts.
Setiap Player juga memiliki properti Player.User, yang merupakan nilai User yang mewakili identitas skop domain pemain dalam permainan saat ini. Untuk informasi lebih lanjut tentang cara kerja identifikasi pengguna, termasuk ID pengguna dengan skop domain dan jenis User, lihat Pengguna dan ID pengguna dengan skop domain.
Siklus Hidup
Layanan Players berisi semua instansi Player dalam sebuah permainan. Skrip sisi klien dan sisi server keduanya 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.
Bergabung sebagai pengguna
Ketika klien pengguna terhubung ke sebuah permainan, peristiwa Players.PlayerAdded akan diaktifkan dan meneruskan 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 tim.
Sebagai contoh, untuk memuat data pengguna ketika mereka bergabung dengan permainan, gunakan peristiwa PlayerAdded dalam Script untuk mengambil data pengguna yang disimpan dalam penyimpanan data di bawah ID pengguna mereka:
Script in ServerScriptService
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)
Spawning 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 diklon ke dalam model karakter dan peristiwa Player.CharacterAdded diaktifkan. Peristiwa ini meneruskan model karakter baru kepada pendengarnya yang dapat Anda gunakan untuk menemukan objek Humanoid dari karakter dan memodifikasi perilakunya. Misalnya, Anda bisa menggunakan Humanoid:ApplyDescription() untuk mengubah pakaian avatar.
Menghilangkan 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 saat ini, peristiwa Players.PlayerRemoving diaktifkan dan meneruskan 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 oleh pemain dalam permainan.
Contoh Script berikut mendengarkan peristiwa PlayerRemoving dan mencoba menyimpan data pengguna dalam penyimpanan data di bawah ID pengguna mereka:
Script in ServerScriptService
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)
Wadah
Setiap objek Player yang mewakili klien pengguna menyimpan beberapa wadah penting: Backpack, StarterGear, PlayerGui, dan PlayerScripts. Pada saat runtime permainan, beberapa wadah dalam model data "edit" menyalin kontennya ke dalam wadah 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 StarterPack dan StarterGear pemain diklon ke Backpack ketika karakter Character pemain muncul. Ketika karakter mati, klien menghancurkan Backpack dan menggantinya dengan yang baru.
Untuk menonaktifkan GUI inventaris bawaan Roblox dan menggantinya dengan milik Anda sendiri, panggil StarterGui:SetCoreGuiEnabled() dalam LocalScript seperti yang dijelaskan dalam nonaktifkan UI bawaan.
Mengalami larangan pengguna
Untuk memastikan ketertiban 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 memperluas larangan ke kemungkinan akun alternatif. Saat menggunakan fitur ini, Anda harus mengikuti pedoman larangan dan pesan.
Anda memiliki beberapa pilihan untuk bekerja dengan larangan:
- Setiap halaman permainan di Creator Hub memiliki dasbor Larangan.
- Untuk penggunaan programatik dengan API engine, lihat Players:BanAsync().
- Untuk Open Cloud, lihat larangan dan blok.
Blokir perangkat
Selain melarang akun, Players:BanAsync() mendukung pemblokiran perangkat melalui field ApplyDeviceBlock dalam tabel konfigurasinya. Ketika Anda melarang pengguna yang saat ini terhubung ke permainan Anda dengan ApplyDeviceBlock diatur ke true, perangkat yang terhubung dengan pengguna tersebut juga akan diblokir dari bergabung kembali selama 24 jam. Opsi ini menambah kesulitan untuk menghindari larangan; pemain yang dilarang tidak dapat langsung 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 unban untuk pengguna yang terpengaruh segera menghapus pemblokiran perangkat aktif yang terkait dengan perangkat pengguna tersebut, memungkinkan mereka untuk bergabung kembali dengan permainan.
Pedoman larangan
Saat menerapkan larangan dalam permainan Anda, patuhi pedoman berikut:
- Aturan permainan tidak boleh bertentangan dengan Standar Komunitas dan Syarat Penggunaan Roblox. Misalnya, Anda tidak dapat membuat aturan permainan yang mengecualikan seseorang karena jenis kelamin mereka, karena ini melanggar Kebijakan Diskriminasi, Sumpah, dan Ujaran Kebencian Roblox.
- Pembuat harus menyatakan aturan permainan mereka dengan jelas di tempat yang dapat diakses oleh semua pengguna.
- Pembuat harus menerapkan aturan permainan mereka secara adil dan tidak secara sembarangan menargetkan pengguna tertentu.
- Pengguna dapat mengajukan banding kepada pembuat secara langsung jika mereka merasa larangan mereka tidak benar. Roblox tidak akan memediasi banding ini, kecuali pengguna merasa 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, Anda dapat menyertakan informasi tambahan seperti informasi pengaduan atau kontak selama Anda memenuhi Standar Komunitas Roblox.
Misalnya, dalam pesan larangan Anda, Anda diizinkan untuk merujuk nama 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.