Pelajari
Kelas Engine
Players
Tidak Dapat Dibuat
Layanan

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.


Rangkuman
Metode
BanAsync(config: Dictionary):()
Chat(message: string):()
CreateHumanoidModelFromDescription(description: HumanoidDescription,rigType: Enum.HumanoidRigType,assetTypeVerification: Enum.AssetTypeVerification):Model
Tidak digunakan lagi
CreateHumanoidModelFromUserId(userId: User):Model
Tidak digunakan lagi
GetCharacterAppearanceAsync(userId: User):Model
Tidak digunakan lagi
getPlayers():{Player}
Tidak digunakan lagi
playerFromCharacter(character: Model):Player
Tidak digunakan lagi
players():{Player}
Tidak digunakan lagi
TeamChat(message: string):()
Anggota yang Diwariskan

Referensi API
Properti
BanningEnabled
Tidak Dapat Ditulis Skripnya
Baca Paralel
Kemampuan: Players
Players.BanningEnabled:boolean

BubbleChat
Hanya Baca
Tidak Direplikasi
Baca Paralel
Kemampuan: Chat, Players
Players.BubbleChat:boolean

CharacterAutoLoads
Tidak Direplikasi
Baca Paralel
Kemampuan: Players
Players.CharacterAutoLoads:boolean
Contoh Kode
Pengatur Waktu Respawn Pemain
local Players = game:GetService("Players")
-- Set CharacterAutoLoads ke false
Players.CharacterAutoLoads = false
-- Hapus karakter pemain dari workspace saat mati
Players.PlayerAdded:Connect(function(player)
while true do
local char = player.CharacterAdded:Wait()
char.Humanoid.Died:Connect(function()
char:Destroy()
end)
end
end)
-- Respawn semua pemain yang mati setiap 10 detik
while true do
local players = Players:GetChildren()
-- Cek apakah setiap pemain mati dengan memeriksa jika mereka tidak memiliki karakter, jika mati muat karakter pemain itu
for _, player in pairs(players) do
if not workspace:FindFirstChild(player.Name) then
player:LoadCharacterAsync()
end
end
-- Tunggu 10 detik sebelum cek respawn berikutnya
task.wait(10)
end

ClassicChat
Hanya Baca
Tidak Direplikasi
Baca Paralel
Kemampuan: Chat, Players
Players.ClassicChat:boolean

LocalPlayer
Hanya Baca
Tidak Direplikasi
Baca Paralel
Kemampuan: Players
Players.LocalPlayer:Player

localPlayer
Tidak digunakan lagi

MaxPlayers
Hanya Baca
Tidak Direplikasi
Baca Paralel
Kemampuan: Players
Players.MaxPlayers:number

NumPlayers
Tidak digunakan lagi

numPlayers
Tidak digunakan lagi

PreferredPlayers
Hanya Baca
Tidak Direplikasi
Baca Paralel
Kemampuan: Players
Players.PreferredPlayers:number

RespawnTime
Baca Paralel
Kemampuan: Players
Players.RespawnTime:number

UseStrafingAnimations
Tidak Dapat Ditulis Skripnya
Baca Paralel
Kemampuan: Players
Players.UseStrafingAnimations:boolean

Metode
BanAsync
Hasil
Kemampuan: Players, Consequences
Players:BanAsync(config:Dictionary):()
Parameter
config:Dictionary
Memberikan nilai
()
Contoh Kode
Mencegah Pengguna
local Players = game:GetService("Players")
if shouldBeBanned(player) then
local banHistoryPages = Players:GetBanHistoryAsync(player.UserId)
local duration = 86400 -- 24 jam dalam detik. Rekomendasi: gunakan logika Anda sendiri berdasarkan pada BanHistory pengguna
local config: BanConfigType = {
UserIds = { player.UserId },
Duration = duration,
DisplayReason = "Anda melanggar pedoman komunitas #5",
PrivateReason = "Letakkan sesuatu di sini yang tidak seharusnya diketahui pengguna tetapi berguna untuk catatan Anda",
ExcludeAltAccounts = false,
ApplyToUniverse = true,
}
local success, err = pcall(function()
return Players:BanAsync(config)
end)
print(success, err)
end

Chat
Keamanan Plugin
Kemampuan: Players
Players:Chat(message:string):()
Parameter
message:string
Memberikan nilai
()
Contoh Kode
Pemain:Chat
-- Command bar
game:GetService("Players"):Chat("Halo, dunia!") --Menghasilkan 'Halo, dunia!' muncul di log Chat di bawah nama Pemain Anda.
-- Script
local Players = game:GetService("Players")
Players:Chat("Halo, dunia!") --Kesalahan

CreateHumanoidModelFromDescription
Tidak digunakan lagi

CreateHumanoidModelFromDescriptionAsync
Hasil
Kemampuan: AvatarAppearance, Players
Players:CreateHumanoidModelFromDescriptionAsync(
description:HumanoidDescription, rigType:Enum.HumanoidRigType, assetTypeVerification:Enum.AssetTypeVerification
Parameter
assetTypeVerification:Enum.AssetTypeVerification
Nilai Default: "Default"
Memberikan nilai
Contoh Kode
Buat Model Humanoid Dari Deskripsi
game.Players:CreateHumanoidModelFromDescriptionAsync(Instance.new("HumanoidDescription"), Enum.HumanoidRigType.R15).Parent =
game.Workspace

CreateHumanoidModelFromUserId
Tidak digunakan lagi

CreateHumanoidModelFromUserIdAsync
Hasil
Kemampuan: Players
Players:CreateHumanoidModelFromUserIdAsync(userId:User):Model
Parameter
userId:User
Memberikan nilai
Contoh Kode
Buat Model Humanoid Dari ID Pengguna
game.Players:CreateHumanoidModelFromUserIdAsync(1).Parent = game.Workspace

GetBanHistoryAsync
Hasil
Kemampuan: Players, Consequences
Players:GetBanHistoryAsync(userId:User):BanHistoryPages
Parameter
userId:User
Memberikan nilai

GetCharacterAppearanceAsync
Tidak digunakan lagi

GetCharacterAppearanceInfoAsync
Hasil
Kemampuan: Players
Players:GetCharacterAppearanceInfoAsync(userId:User):Dictionary
Parameter
userId:User
Memberikan nilai
Contoh Kode
Contoh Kamus Penampilan Karakter Kembali
local result = {
playerAvatarType = "R15",
defaultPantsApplied = false,
defaultShirtApplied = false,
scales = {
bodyType = 0,
head = 1,
height = 1.05,
proportion = 0,
depth = 0.92,
width = 0.85,
},
bodyColors = {
leftArmColorId = 1030,
torsoColorId = 1001,
rightArmColorId = 1030,
headColorId = 1030,
leftLegColorId = 1001,
rightLegColorId = 1001,
},
assets = {
{
id = 1031492,
assetType = {
name = "Hat",
id = 8,
},
name = "Topi Bergaris",
},
{
id = 13062491,
assetType = {
name = "Aksesori Wajah",
id = 42,
},
name = "Vision Française ",
},
{
id = 16598440,
assetType = {
name = "Aksesori Leher",
id = 43,
},
name = "Pita Merah",
},
{
id = 28999228,
assetType = {
name = "Wajah",
id = 18,
},
name = "Kejutan Bahagia",
},
{
id = 86896488,
assetType = {
name = "Baju",
id = 11,
},
name = "Jaket Tuxedo Merah Mahal",
},
{
id = 86896502,
assetType = {
name = "Celana",
id = 12,
},
name = "Celana Tuxedo Merah Mahal",
},
{
id = 376530220,
assetType = {
name = "Lengan Kiri",
id = 29,
},
name = "Lengan Kiri Anak ROBLOX",
},
{
id = 376531012,
assetType = {
name = "Lengan Kanan",
id = 28,
},
name = "Lengan Kanan Anak ROBLOX",
},
{
id = 376531300,
assetType = {
name = "Kaki Kiri",
id = 30,
},
name = "Kaki Kiri Anak ROBLOX",
},
{
id = 376531703,
assetType = {
name = "Kaki Kanan",
id = 31,
},
name = "Kaki Kanan Anak ROBLOX",
},
{
id = 376532000,
assetType = {
name = "Torso",
id = 27,
},
name = "Torso Anak ROBLOX",
},
},
}
print(result)

GetFriendsAsync
Hasil
Kemampuan: Players, Social
Players:GetFriendsAsync(userId:User):FriendPages
Parameter
userId:User
Memberikan nilai
Contoh Kode
Cetak Teman Roblox
local Players = game:GetService("Players")
local USERNAME = "Cozecant"
local function iterPageItems(pages)
return coroutine.wrap(function()
local pagenum = 1
while true do
for _, item in ipairs(pages:GetCurrentPage()) do
coroutine.yield(item, pagenum)
end
if pages.IsFinished then
break
end
pages:AdvanceToNextPageAsync()
pagenum = pagenum + 1
end
end)
end
-- Pertama, dapatkan ID pengguna dari pemain
local userId = Players:GetUserIdFromNameAsync(USERNAME)
-- Kemudian, dapatkan objek FriendPages untuk teman-temannya
local friendPages = Players:GetFriendsAsync(userId)
-- Lakukan iterasi atas item-item di halaman. Untuk FriendPages, ini
-- adalah table informasi tentang teman, termasuk Nama Pengguna.
-- Kumpulkan setiap nama pengguna dalam sebuah table
local usernames = {}
for item, _pageNo in iterPageItems(friendPages) do
table.insert(usernames, item.Username)
end
print("Koneksi dari " .. USERNAME .. ": " .. table.concat(usernames, ", "))

GetHumanoidDescriptionFromOutfitId
Tidak digunakan lagi

GetHumanoidDescriptionFromOutfitIdAsync
Hasil
Kemampuan: AvatarAppearance, Players
Players:GetHumanoidDescriptionFromOutfitIdAsync(outfitId:number):HumanoidDescription
Parameter
outfitId:number
Memberikan nilai
Contoh Kode
Dapatkan HumanoidDescription Dari Outfit ID
local Players = game:GetService("Players")
local Workspace = game:GetService("Workspace")
local function getOutfitId(bundleId)
if bundleId <= 0 then
return
end
local info = game.AssetService:GetBundleDetailsAsync(bundleId)
if not info then
return
end
for _, item in pairs(info.Items) do
if item.Type == "UserOutfit" then
return item.Id
end
end
return nil
end
local function getHumanoidDescriptionBundle(bundleId)
local itemId = getOutfitId(bundleId)
if itemId and itemId > 0 then
return Players:GetHumanoidDescriptionFromOutfitIdAsync(itemId)
end
return nil
end
local humanoidDescription = getHumanoidDescriptionBundle(799)
local humanoidModel = Players:CreateHumanoidModelFromDescriptionAsync(humanoidDescription, Enum.HumanoidRigType.R15)
humanoidModel.Parent = Workspace

GetHumanoidDescriptionFromUserId
Tidak digunakan lagi

GetHumanoidDescriptionFromUserIdAsync
Hasil
Kemampuan: AvatarAppearance, Players
Players:GetHumanoidDescriptionFromUserIdAsync(userId:User):HumanoidDescription
Parameter
userId:User
Memberikan nilai
Contoh Kode
Ambil HumanoidDescription Dari User ID
game.Players:CreateHumanoidModelFromDescriptionAsync(
game.Players:GetHumanoidDescriptionFromUserIdAsync(1),
Enum.HumanoidRigType.R15
).Parent =
game.Workspace

GetNameFromUserIdAsync
Hasil
Kemampuan: Players
Players:GetNameFromUserIdAsync(userId:User):string
Parameter
userId:User
Memberikan nilai
Contoh Kode
Dapatkan Nama dari UserId
local Players = game:GetService("Players")
-- Contoh Data:
-- UserId: 118271 Nama: "RobloxRulez"
-- UserId: 131963979 Nama: "docsRule"
local nameOne = Players:GetNameFromUserIdAsync(118271)
local nameTwo = Players:GetNameFromUserIdAsync(131963979)
print(nameOne, nameTwo)
-- mencetak: "RobloxRulez docsRule"
Dapatkan Nama dari UserId menggunakan cache
local Players = game:GetService("Players")
-- Buat tabel bernama 'cache' untuk menyimpan setiap 'Name' saat ditemukan.
-- Jika kita mencari 'Name' menggunakan 'UserId' yang sama, 'Name' akan didapat
-- dari cache (cepat) alih-alih GetNameFromUserIdAsync() (menghasilkan).
local cache = {}
function getNameFromUserId(userId)
-- Pertama, periksa apakah cache mengandung 'userId'
local nameFromCache = cache[userId]
if nameFromCache then
-- jika sebuah nilai disimpan dalam cache pada kunci 'userId', maka 'nameFromCache' ini
-- adalah Nama yang benar dan kita bisa mengembalikannya.
return nameFromCache
end
-- Jika sampai sini, 'userId' tidak pernah dicari sebelumnya dan tidak ada dalam
-- cache. Sekarang kita perlu menggunakan GetNameFromUserIdAsync() untuk mencari nama
local name
local success, _ = pcall(function()
name = Players:GetNameFromUserIdAsync(userId)
end)
if success then
-- jika 'success' benar, GetNameFromUserIdAsync() berhasil menemukan
-- nama. Simpan nama ini dalam cache menggunakan 'userId' sebagai kunci, sehingga kita
-- tidak perlu mencari nama ini di masa depan. Kemudian kembalikan name.
cache[userId] = name
return name
end
-- Jika sampai sini, 'success' salah, berarti GetNameFromUserIdAsync()
-- tidak dapat menemukan 'name' untuk 'userId' yang diberikan. Peringatkan pengguna
-- ini terjadi dan kemudian kembalikan tidak ada, atau nil.
warn("Tidak dapat menemukan Nama untuk UserId:", userId)
return nil
end
-- Contoh Data:
-- UserId: 118271 Name: "RobloxRulez"
-- UserId: 131963979 Name: "docsRule"
-- Kali pertama sebuah UserId digunakan, GetNameFromUserIdAsync() akan dipanggil
local nameOne = getNameFromUserId(118271)
local nameTwo = getNameFromUserId(131963979)
-- Karena 118271 sudah pernah digunakan, ambil Namanya dari cache
local nameOneQuick = getNameFromUserId(118271)
print(nameOne, nameTwo, nameOneQuick)
-- mencetak: "RobloxRulez docsRule RobloxRulez"

GetPlayerByUserId
Tulis Paralel
Kemampuan: Players
Players:GetPlayerByUserId(userId:User):Player
Parameter
userId:User
Memberikan nilai
Contoh Kode
Pemain:GetPlayerByUserId
local Players = game:GetService("Players")
local player = Players:GetPlayerByUserId(1)
if player then
print("Pemain dengan userId 1 ada di server ini! Nama mereka adalah: " .. player.Name)
else
print("Pemain dengan userId 1 tidak ada di server ini!")
end

GetPlayerFromCharacter
Kemampuan: Players
Akses Simulasi
Players:GetPlayerFromCharacter(character:Model):Player
Parameter
character:Model
Memberikan nilai
Contoh Kode
Pemain:GetPlayerFromCharacter
local Players = game:GetService("Players")
local Workspace = game:GetService("Workspace")
local PLAYER_NAME = "Nightriff"
local character = Workspace:FindFirstChild(PLAYER_NAME)
local player = Players:GetPlayerFromCharacter(character)
if player then
print(`Pemain {player.Name} ({player.UserId}) ada di dalam permainan`)
else
print(`Pemain {PLAYER_NAME} tidak ada di dalam permainan!`)
end

GetPlayers
Tulis Paralel
Kemampuan: Players
Players:GetPlayers():{Player}
Memberikan nilai
Contoh Kode
Berikan Sparkles kepada Semua
local Players = game:GetService("Players")
local function onCharacterAdded(character)
-- Berikan mereka sparkles di kepala mereka jika mereka belum memilikinya
if not character:FindFirstChild("Sparkles") then
local sparkles = Instance.new("Sparkles")
sparkles.Parent = character:WaitForChild("Head")
end
end
local function onPlayerAdded(player)
-- Periksa apakah mereka sudah muncul
if player.Character then
onCharacterAdded(player.Character)
end
-- Dengarkan pemain yang (ulang) muncul
player.CharacterAdded:Connect(onCharacterAdded)
end
Players.PlayerAdded:Connect(onPlayerAdded)

getPlayers
Tidak digunakan lagi

GetUserIdFromNameAsync
Hasil
Kemampuan: Players
Players:GetUserIdFromNameAsync(userName:string):number
Parameter
userName:string
Memberikan nilai
Contoh Kode
Dapatkan UserId dari Nama
local Players = game:GetService("Players")
-- Contoh Data:
-- UserId: 118271 Nama: "RobloxRulez"
-- UserId: 131963979 Nama: "docsRule"
local userIdOne = Players:GetUserIdFromNameAsync("RobloxRulez")
local userIdTwo = Players:GetUserIdFromNameAsync("docsRule")
print(userIdOne, userIdTwo)
-- mencetak: "118271 131963979"
Dapatkan UserId dari Nama menggunakan cache
local Players = game:GetService("Players")
-- Buat tabel bernama 'cache' untuk menyimpan setiap 'UserId' saat ditemukan.
-- Jika kita mencari 'UserId' menggunakan 'Name' yang sama, 'UserId' akan diambil
-- dari cache (cepat) alih-alih dari GetUserIdFromNameAsync() (menghasilkan).
local cache = {}
function getUserIdFromName(name)
-- Pertama, periksa apakah cache berisi 'name'
local userIdFromCache = cache[name]
if userIdFromCache then
-- jika nilai disimpan di cache pada kunci 'name', maka 'userIdFromCache' ini
-- adalah UserId yang benar dan kita bisa mengembalikannya.
return userIdFromCache
end
-- Jika sampai sini, 'name' belum pernah dicari sebelumnya dan tidak ada di
-- cache. Sekarang kita perlu menggunakan GetUserIdFromNameAsync() untuk mencarikan userId
local userId
local success, _ = pcall(function()
userId = Players:GetUserIdFromNameAsync(name)
end)
if success then
-- jika 'success' benar, GetUserIdFromNameAsync() berhasil menemukan
-- userId. Simpan userId ini di cache menggunakan 'name' sebagai kunci sehingga kita
-- tidak perlu mencarian userId ini di masa depan. Kemudian kembalikan userId.
cache[name] = userId
return userId
end
-- Jika sampai sini, 'success' salah, yang berarti GetUserIdFromNameAsync()
-- tidak dapat menemukan 'userId' untuk 'name' yang diberikan. Kita bisa memberi peringatan kepada
-- pengguna bahwa ini terjadi dan kemudian mengembalikan tidak ada, atau nil.
warn("Tidak dapat menemukan UserId untuk Nama:", name)
return nil
end
-- Contoh Data:
-- UserId: 118271 Nama: "RobloxRulez"
-- UserId: 131963979 Nama: "docsRule"
-- Pertama kali Nama digunakan, GetUserIdFromNameAsync() akan dipanggil
local userIdOne = getUserIdFromName("RobloxRulez")
local userIdTwo = getUserIdFromName("docsRule")
-- Karena "RobloxRulez" sebelumnya telah digunakan, dapatkan UserId-nya dari cache
local userIdOneQuick = getUserIdFromName("RobloxRulez")
print(userIdOne, userIdTwo, userIdOneQuick)
-- mencetak: "118271 131963979 118271"

GetUserThumbnailAsync
Hasil
Kemampuan: Players
Players:GetUserThumbnailAsync(
userId:User, thumbnailType:Enum.ThumbnailType, thumbnailSize:Enum.ThumbnailSize
Parameter
userId:User
thumbnailType:Enum.ThumbnailType
thumbnailSize:Enum.ThumbnailSize
Memberikan nilai
Contoh Kode
Tampilkan Thumbnail Pemain
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local PLACEHOLDER_IMAGE = "rbxassetid://0" -- ganti dengan gambar placeholder
-- ambil thumbnail
local userId = player.UserId
local thumbType = Enum.ThumbnailType.HeadShot
local thumbSize = Enum.ThumbnailSize.Size420x420
local content, isReady = Players:GetUserThumbnailAsync(userId, thumbType, thumbSize)
-- atur konten ImageLabel ke thumbnail pengguna
local imageLabel = script.Parent
imageLabel.Image = (isReady and content) or PLACEHOLDER_IMAGE
imageLabel.Size = UDim2.new(0, 420, 0, 420)

playerFromCharacter
Tidak digunakan lagi

players
Tidak digunakan lagi

SetChatStyle
Keamanan Plugin
Kemampuan: Players
Players:SetChatStyle(style:Enum.ChatStyle):()
Parameter
Nilai Default: "Classic"
Memberikan nilai
()
Contoh Kode
Mengatur Gaya Obrolan Pemain
-- Command bar
game.Players:SetChatStyle(Enum.ChatStyle.Classic) -- Mengatur gaya obrolan ke Classic
-- LocalScript
local Players = game:GetService("Players")
Players:SetChatStyle(Enum.ChatStyle.Classic) -- Menghasilkan kesalahan

TeamChat
Keamanan Plugin
Kemampuan: Players
Players:TeamChat(message:string):()
Parameter
message:string
Memberikan nilai
()
Contoh Kode
Mengirim Obrolan Tim
-- Command bar
game.Players:TeamChat("Halo Dunia") -- Mengirim pesan "Halo Dunia" ke semua pemain di tim pemain lokal
-- LocalScript
local Players = game:GetService("Players")
Players:TeamChat("Halo Dunia") -- Kesalahan

UnbanAsync
Hasil
Kemampuan: Players, Consequences
Players:UnbanAsync(config:Dictionary):()
Parameter
config:Dictionary
Memberikan nilai
()
Contoh Kode
Membatalkan Larangan Pengguna
local Players = game:GetService("Players")
if shouldBeUnbanned(player) then
local config: UnbanConfigType = {
UserIds = { player.UserId, 789 },
ApplyToUniverse = false,
}
local success, err = pcall(function()
return Players:UnbanAsync(config)
end)
print(success, err)
end

Acara
PlayerAdded
Kemampuan: Players
Players.PlayerAdded(player:Player):RBXScriptSignal
Parameter
player:Player
Contoh Kode
Pemain.PlayerDitambahkan
local Players = game:GetService("Players")
local function onPlayerAdded(player)
print("Seorang pemain telah masuk: " .. player.Name)
end
Players.PlayerAdded:Connect(onPlayerAdded)

PlayerMembershipChanged
Kemampuan: Players
Players.PlayerMembershipChanged(player:Player):RBXScriptSignal
Parameter
player:Player
Contoh Kode
Mengelola Perubahan Keanggotaan Premium
local Players = game:GetService("Players")
local function grantPremiumBenefits(player)
-- Berikan akses kepada pemain ke area, item, atau apapun yang hanya untuk Premium!
print("Memberikan", player, "manfaat premium!")
end
local function playerAdded(player)
if player.MembershipType == Enum.MembershipType.Premium then
grantPremiumBenefits(player)
end
end
local function playerMembershipChanged(player)
print("Menerima event PlayerMembershipChanged. Keanggotaan baru = " .. tostring(player.MembershipType))
if player.MembershipType == Enum.MembershipType.Premium then
grantPremiumBenefits(player)
end
end
Players.PlayerAdded:Connect(playerAdded)
Players.PlayerMembershipChanged:Connect(playerMembershipChanged)

PlayerRemoving
Kemampuan: Players
Players.PlayerRemoving(
Parameter
player:Player
Contoh Kode
Players.PlayerRemoving
local Players = game:GetService("Players")
local function onPlayerRemoving(player)
print("Seorang pemain telah keluar: " .. player.Name)
end
Players.PlayerRemoving:Connect(onPlayerRemoving)

UserSubscriptionStatusChanged
Kemampuan: Players, Monetization
Players.UserSubscriptionStatusChanged(
user:Player, subscriptionId:string
Parameter
user:Player
subscriptionId:string

©2026 Roblox Corporation. Roblox, logo Roblox, dan Powering Imagination termasuk dalam merek dagang kami yang terdaftar dan tidak terdaftar di AS dan negara lainnya.