Ketika seorang pengguna bergabung dengan pengalaman, Roblox mewakili mereka sebagai Pemain di model data. Objek Player mengandung informasi tentang pengguna yang universal di semua pengalaman, seperti nama pengguna, daftar teman, dan ketikavatar yang disimpan, serta jenis,
Layanan Players mengandung semua instansi Player dalam pengalaman. Setiap Player objek mewakili pengguna di pengalaman, dan itu orang tua empat wad
Siklus hidup
Skrip client dan server dapat keduanya terhubung ke Players.PlayerAdded dan Players.PlayerRemoved acara untuk mengeksekusi tindakan dalam menanggapi sikl
Gunakan Skrip untuk mengakses layanan terkait server, seperti penyimpanan data untuk mengambil dan menyimpan data saat seorang pengguna bergabung atau meninggalkan. Gunakan Skrip Lokal jika klien memerlukan untuk menciptakan dan menghapus instans gameplay yang terikat dengan pengguna, seperti tampilan GUI untuk statistik pengguna di papan peringkat khusus.
Pengguna Bergabung
Ketika klien terhubung ke pengalaman, objek Player yang terkaitnya diklon ke layanan Players. The
Memuat Data Pengguna Saat Bergabung
Untuk memuat data pengguna saat mereka bergabung dengan pengalaman, gunakan acara Players.PlayerAdded dalam Script . Berikut adalah contoh Script daftar yang mendengarkan acara dan mencoba untuk mengambil data pengguna menggunakan ID pengguna mereka sebagai k
local DataStoreService = game:GetService("DataStoreService")
local playerDataStore = DataStoreService:GetDataStore("PlayerData")
game:GetService("Players").PlayerAdded:Connect(function(player)
local userId = player.UserId
-- Baca kunci unitdata
local getSuccess, currentData = pcall(function()
return playerDataStore:GetAsync(userId)
end)
if getSuccess then
print(currentData)
end
-- Lakukan tindakan lebih lanjut dengan data saat ini
end)
The Instance.Name of the Player object is the name of the user. If you need a unique reference to a user, such as to save information about them in a data store , use their 1> Class.Player.UserId1> instead of their 4> Class
Pengguna meninggalkan
Ketika klien terputus dari pengalaman, server menghancurkan objek Player yang terkait dari layanan
Perhatikan bahwa acara diberi nama Player.PlayerRemoving, bukan Player.PlayerRemoved, karena "dihapus" menyiratkan bahwa objek Player sudah dihapus dan oleh karena itu tidak dapat diakses oleh skrip.
Menyimpan Data Pengguna saat Berangkat
Untuk menyimpan data pengguna saat mereka meninggalkan pengalaman, gunakan acara Players.PlayerRemoving di dalam Script . Berikut adalah contoh Script listens ke acara dan mencoba untuk menyimpan data pengguna menggunakan ID pengguna mereka sebagai kunci penyimpanan data.
Skrip di ServerScriptService
local DataStoreService = game:GetService("DataStoreService")
local playerDataStore = DataStoreService:GetDataStore("PlayerData")
game:GetService("Players").PlayerRemoving:Connect(function(player)
local userId = player.UserId
-- Dapatkan status data pemain dalam game
local currentData = getCurrentData(player)
-- Simpan ke toko data
local setSuccess, errorMessage = pcall(function()
playerDataStore:SetAsync(userId, currentData)
end)
if not setSuccess then
warn(errorMessage)
end
end)
Karakter Bergerak
Model Player.Character pengguna mewakili avatar mereka. Secara default, Player.CharacterAutoLoads benar, dan model karakter pengguna otomatis muncul ketika mereka bergabung dengan pengalaman. Jika Player.CharacterAutoLoads benar, maka Anda perlu menelepon 1>Class.Player:
Ketika pengguna
Karakter Despawning
Ketika pemainnya Humanoid mati, bagian tubuhnya jatuh ke tanah dan acara Humanoid.Died terfire. Server secara otomatis menghapus model karakter dan setiap script di dalamnya setelah jumlah waktu
Menghitung Kematian Pemain
Anda dapat menggunakan acara Humanoid.Died untuk menangani skor untuk membunuh atau membuat model ragdoll khusus. Berikut Script terhubung ke Class
Skrip di ServerScriptService
game:GetService("Players").PlayerAdded:Connect(function(player)
local deaths = 0
player.CharacterAdded:Connect(function(character)
local humanoid = character:WaitForChild("Humanoid")
humanoid.Died:Connect(function()
deaths += 1
print(player.Name .. " death count: " .. deaths)
end)
end)
end)
Menghentikan Pengguna
Untuk menjamin kewibawaan dan permainan yang adil dalam pengalaman Anda, Anda dapat melarang pengguna yang melanggar aturan pengalaman Anda dan pedoman komunitas. Anda dapat mengubah durasi pemblokiran, pesan pemblokiran, dan bahkan memperpanjang pemblokiran ke akun alternatif potensial. Saat menggunakan fitur ini, Anda juga harus mengikuti panduan untuk melarang dan m
Untuk implementasi dan instruksi penggunaan, lihat Players.BanAsync .
Panduan Pengaturan
Saat menerapkan larangan di pengalaman Anda, ikuti panduan berikut:
- Aturan pengalaman tidak boleh bertentangan dengan Standar Komunitas Roblox dan Ketentuan Penggunaan.
- Misalnya, Anda tidak dapat membuat aturan pengalaman yang mengecualikan seseorang karena gender mereka karena ini melanggar kebijakan Diskriminasi, Slurs, dan Kebencian Speech Roblox ini .
- Para pencipta harus dengan jelas menyatakan aturan pengalaman mereka di suatu tempat yang dapat diakses oleh semua pengguna.
- Pencipta harus menerapkan aturan pengalaman mereka dengan cukup dan tidak menargetkan pengguna tertentu secara arbitral.
- Pengguna dapat mengajukan kasus terhadap pembuat jika mereka percaya bahwa larangan mereka tidak benar.
- Roblox tidak akan menengahi keluhan ini, kecuali jika pengguna percaya aturan pengalaman kreatoratau penerapan aturan mereka melanggar Standar Komunitas.
- Roblox dapat menyetujui pengalaman jika ada alasan untuk percaya bahwa aturan pengalaman kreatoratau ketentuan pengalaman mereka melanggar Standar Komunitas.
Panduan Pesan
Ketika seorang pengguna dilarang, mereka menerima tampilan modul kesalahan yang menunjukkan informasi seperti panjang larangan dan alasan. Dalam pesan yang disaring oleh teks, Anda dapat menyertakan informasi tambahan seperti informasi permintaan atau kontak sepanjang Anda memenuhi Standar Komunitas Roblox.
Misalnya, dalam pesan larangan Anda, Anda diizinkan untuk mengacu pada nama merek dan platform:
- Kunjungi Discord di halaman grup/pengalaman saya
- “Pesan saya di Twitter atau X”
Penggunaan informasi pribadi atau tautan langsung tidak diperbolehkan di bidang pesan ini. Ini termasuk mengirimkan nama pengguna khusus atau tangan, atau memberikan tautan langsung ke server Discord atau akunX.
Wadah
Objek Player menyimpan beberapa wadah penting:
Ransel
Wadah Player.Backpack menyimpan inventaris pengguna. Objek Tool dalam Backpack pengguna di layar mereka di bagian bawah layar mereka. Jika seorang pengguna meng選擇
Ketika seorang pengguna Player.Character muncul, konten layanan StarterPack dan klon mereka Player.StarterGear ke 1> Class.Player.Backpack1> mereka. Saat karakter mati, klien menghancurkan mereka 4> Class.Back
Class.Backpack juga menyimpan dan mengeksekusi Scripts dan LocalScripts yang klien dan server dapat akses bersama.
Roblox menyediakan antarmuka bagi seorang pemain untuk mengakses Backpack dan inventaris mereka di bagian bawah layar. Untuk menonaktifkan antarmuka punggung Roblox default dan menggantikannya dengan Anda memiliki, panggil StarterGui:SetCoreGuiEnabled() di LocalScript. Untuk informasi lebih lanjut, lihat
Peralatan Pemula
Wadah StarterGear mengkloning kontennya ke Player.Backpack pengguna ketika karakter mereka muncul. Selain itu, jika tempat Anda mengizinkan peralatan dan pengguna memiliki perlengkapan, objek Tool peralatan mereka klon ke 1> Class.Player.StarterGear1> mere
Tidak seperti StarterPack, Player.StarterGear bukanlah layanan tetapi lebih bien seorang
Selalu tes game setelah menambahkan Gear ke mereka untuk memeriksa bahwa pengguna tidak dapat dengan mudah menyalahgunakannya di sana. Gear termasuk Script objek dan memungkinkan pemain untuk melakukan tindakan yang mungkin tidak Anda pertimbangkan. Misalnya, peralatan navigasi mungkin memungkinkan pemain untuk mengak
PemutarGui
Wadah PlayerGui menyimpan objek yang menciptakan GUI pemain. Jika ScreenGUI adalah cucu dari Class
Jika Players.CharacterAutoLoads di set ke false, karakter tidak muncul, dan StarterGui konten tidak muncul sampai Player:LoadCharacter() di panggil. Jika Class.StarterGui.
Skrip Pemain
Ketika seorang pengguna bergabung dengan pengalaman, konten di StarterPlayer.StarterPlayerScripts kontainer klon ke PlayerScripts . Setiap LocalScripts danModuleScripts berjalan ketika mereka klon.