Learn
Motor Sınıfı
Players
Oluşturulamaz
Hizmet

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.


Özet
Yöntemler
BanAsync(config: Dictionary):()
Chat(message: string):()
CreateHumanoidModelFromDescription(description: HumanoidDescription,rigType: Enum.HumanoidRigType,assetTypeVerification: Enum.AssetTypeVerification):Model
Artık Kullanılmayan
CreateHumanoidModelFromUserId(userId: User):Model
Artık Kullanılmayan
GetCharacterAppearanceAsync(userId: User):Model
Artık Kullanılmayan
getPlayers():{Player}
Artık Kullanılmayan
playerFromCharacter(character: Model):Player
Artık Kullanılmayan
players():{Player}
Artık Kullanılmayan
TeamChat(message: string):()
Devralınan Üyeler

API Referansı
Özellikler
BanningEnabled
Betiklenemez
Paralel oku
Capabilities: Players
Players.BanningEnabled:boolean

BubbleChat
Salt Okunur
Çoğaltılmamış
Paralel oku
Capabilities: Chat, Players
Players.BubbleChat:boolean

CharacterAutoLoads
Çoğaltılmamış
Paralel oku
Capabilities: Players
Players.CharacterAutoLoads:boolean
Kod Örnekleri
Oyuncu Yeniden Doğma Zamanlayıcı
local Players = game:GetService("Players")
-- KarakterOtomatikYüklemelerini false olarak ayarla
Players.CharacterAutoLoads = false
-- Ölümde oyuncunun karakterini çalışma alanından kaldır
Players.PlayerAdded:Connect(function(player)
while true do
local char = player.CharacterAdded:Wait()
char.Humanoid.Died:Connect(function()
char:Destroy()
end)
end
end)
-- Her 10 saniyede bir ölü oyuncuları yeniden doğur
while true do
local players = Players:GetChildren()
-- Her oyuncunun ölü olup olmadığını kontrol et, eğer ölü ise o oyuncunun karakterini yükle
for _, player in pairs(players) do
if not workspace:FindFirstChild(player.Name) then
player:LoadCharacterAsync()
end
end
-- Sonraki yeniden doğurma kontrolü için 10 saniye bekle
task.wait(10)
end

ClassicChat
Salt Okunur
Çoğaltılmamış
Paralel oku
Capabilities: Chat, Players
Players.ClassicChat:boolean

LocalPlayer
Salt Okunur
Çoğaltılmamış
Paralel oku
Capabilities: Players
Players.LocalPlayer:Player

localPlayer
Artık Kullanılmayan

MaxPlayers
Salt Okunur
Çoğaltılmamış
Paralel oku
Capabilities: Players
Players.MaxPlayers:number

NumPlayers
Artık Kullanılmayan

numPlayers
Artık Kullanılmayan

PreferredPlayers
Salt Okunur
Çoğaltılmamış
Paralel oku
Capabilities: Players
Players.PreferredPlayers:number

RespawnTime
Paralel oku
Capabilities: Players
Players.RespawnTime:number

UseStrafingAnimations
Betiklenemez
Paralel oku
Capabilities: Players
Players.UseStrafingAnimations:boolean

Yöntemler
BanAsync
Bekletir
Capabilities: Players, Consequences
Players:BanAsync(config:Dictionary):()
Parametreler
config:Dictionary
Dönüşler
()
Kod Örnekleri
Kullanıcıları Yasaklama
local Players = game:GetService("Players")
if shouldBeBanned(player) then
local banHistoryPages = Players:GetBanHistoryAsync(player.UserId)
local duration = 86400 -- 24 saat, saniye cinsinden. Öneri: Kullanıcının BanHistory'sine dayalı kendi mantığınızı kullanın
local config: BanConfigType = {
UserIds = { player.UserId },
Duration = duration,
DisplayReason = "Topluluk kılavuzunu #5 ihlal ettiniz",
PrivateReason = "Kullanıcının bilmemesi gereken ancak kayıtlarınız için faydalı olan her şeyi buraya koyun",
ExcludeAltAccounts = false,
ApplyToUniverse = true,
}
local success, err = pcall(function()
return Players:BanAsync(config)
end)
print(success, err)
end

Chat
Eklenti Güvenliği
Capabilities: Players
Players:Chat(message:string):()
Parametreler
message:string
Dönüşler
()
Kod Örnekleri
Oyuncular: Sohbet
-- Komut çubuğu
game:GetService("Players"):Chat("Merhaba, dünya!") --Sonuç olarak 'Merhaba, dünya!' oyuncunuzun adı altında Sohbet kaydında görünür.
-- Script
local Players = game:GetService("Players")
Players:Chat("Merhaba, dünya!") --Hata verir

CreateHumanoidModelFromDescription
Artık Kullanılmayan

CreateHumanoidModelFromDescriptionAsync
Bekletir
Capabilities: AvatarAppearance, Players
Players:CreateHumanoidModelFromDescriptionAsync(
description:HumanoidDescription, rigType:Enum.HumanoidRigType, assetTypeVerification:Enum.AssetTypeVerification
Parametreler
assetTypeVerification:Enum.AssetTypeVerification
Varsayılan değer: "Default"
Dönüşler
Kod Örnekleri
Açıklamadan Humanoid Modeli Oluştur
game.Players:CreateHumanoidModelFromDescriptionAsync(Instance.new("HumanoidDescription"), Enum.HumanoidRigType.R15).Parent =
game.Workspace

CreateHumanoidModelFromUserId
Artık Kullanılmayan

CreateHumanoidModelFromUserIdAsync
Bekletir
Capabilities: Players
Players:CreateHumanoidModelFromUserIdAsync(userId:User):Model
Parametreler
userId:User
Dönüşler
Kod Örnekleri
Kullanıcı Kimliğinden İnsan Modeli Oluştur
game.Players:CreateHumanoidModelFromUserIdAsync(1).Parent = game.Workspace

GetBanHistoryAsync
Bekletir
Capabilities: Players, Consequences
Players:GetBanHistoryAsync(userId:User):BanHistoryPages
Parametreler
userId:User
Dönüşler

GetCharacterAppearanceAsync
Artık Kullanılmayan

GetCharacterAppearanceInfoAsync
Bekletir
Capabilities: Players
Players:GetCharacterAppearanceInfoAsync(userId:User):Dictionary
Parametreler
userId:User
Dönüşler
Kod Örnekleri
Örnek İade Karakter Görünüm Sözlüğü
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 = "Şapka",
id = 8,
},
name = "Çizgili Şapka",
},
{
id = 13062491,
assetType = {
name = "Yüz Aksesuarı",
id = 42,
},
name = "Vision Française ",
},
{
id = 16598440,
assetType = {
name = "Boyun Aksesuarı",
id = 43,
},
name = "Kırmızı Kravat",
},
{
id = 28999228,
assetType = {
name = "Yüz",
id = 18,
},
name = "Neşeli Sürpriz",
},
{
id = 86896488,
assetType = {
name = "Gömlek",
id = 11,
},
name = "Pahalı Kırmızı Smokin Ceketi",
},
{
id = 86896502,
assetType = {
name = "Pantolon",
id = 12,
},
name = "Pahalı Kırmızı Smokin Pantolonu",
},
{
id = 376530220,
assetType = {
name = "Sol Kol",
id = 29,
},
name = "ROBLOX Çocuk Sol Kolu",
},
{
id = 376531012,
assetType = {
name = "Sağ Kol",
id = 28,
},
name = "ROBLOX Çocuk Sağ Kolu",
},
{
id = 376531300,
assetType = {
name = "Sol Bacak",
id = 30,
},
name = "ROBLOX Çocuk Sol Bacağı",
},
{
id = 376531703,
assetType = {
name = "Sağ Bacak",
id = 31,
},
name = "ROBLOX Çocuk Sağ Bacağı",
},
{
id = 376532000,
assetType = {
name = "Torso",
id = 27,
},
name = "ROBLOX Çocuk Torso",
},
},
}
print(result)

GetFriendsAsync
Bekletir
Capabilities: Players, Social
Players:GetFriendsAsync(userId:User):FriendPages
Parametreler
userId:User
Dönüşler
Kod Örnekleri
Roblox Arkadaşlarını Yazdır
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
-- İlk olarak, oyuncunun kullanıcı kimliğini al
local userId = Players:GetUserIdFromNameAsync(USERNAME)
-- Daha sonra, arkadaşları için bir FriendPages nesnesi al
local friendPages = Players:GetFriendsAsync(userId)
-- Sayfalardaki öğeler üzerinde döngü. FriendPages için bunlar
-- arkadaş hakkında bilgi tablolarıdır, Kullanıcı adı dahil.
-- Her kullanıcı adını bir tabloda topla
local usernames = {}
for item, _pageNo in iterPageItems(friendPages) do
table.insert(usernames, item.Username)
end
print("" .. USERNAME .. "'nın Bağlantıları: " .. table.concat(usernames, ", "))

GetHumanoidDescriptionFromOutfitId
Artık Kullanılmayan

GetHumanoidDescriptionFromOutfitIdAsync
Bekletir
Capabilities: AvatarAppearance, Players
Players:GetHumanoidDescriptionFromOutfitIdAsync(outfitId:number):HumanoidDescription
Parametreler
outfitId:number
Kod Örnekleri
Kıyafet ID'sinden HumanoidDescription Al
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
Artık Kullanılmayan

GetHumanoidDescriptionFromUserIdAsync
Bekletir
Capabilities: AvatarAppearance, Players
Players:GetHumanoidDescriptionFromUserIdAsync(userId:User):HumanoidDescription
Parametreler
userId:User
Kod Örnekleri
Kullanıcı Kimliğinden Humanoid Açıklaması Al
game.Players:CreateHumanoidModelFromDescriptionAsync(
game.Players:GetHumanoidDescriptionFromUserIdAsync(1),
Enum.HumanoidRigType.R15
).Parent =
game.Workspace

GetNameFromUserIdAsync
Bekletir
Capabilities: Players
Players:GetNameFromUserIdAsync(userId:User):string
Parametreler
userId:User
Dönüşler
Kod Örnekleri
Kullanıcı Kimliğinden İsim Al
local Players = game:GetService("Players")
-- Örnek Veri:
-- Kullanıcı Kimliği: 118271 İsim: "RobloxRulez"
-- Kullanıcı Kimliği: 131963979 İsim: "docsRule"
local nameOne = Players:GetNameFromUserIdAsync(118271)
local nameTwo = Players:GetNameFromUserIdAsync(131963979)
print(nameOne, nameTwo)
-- yazdırır: "RobloxRulez docsRule"
Kullanıcı ID'sinden isim alarak önbellek kullanma
local Players = game:GetService("Players")
-- Bulunduğunda her 'Name'i saklamak için 'cache' adlı bir tablo oluşturun.
-- Eğer aynı 'UserId' kullanılarak bir 'Name' ararsak, 'Name' önbellekten
-- (hızlı) gelecektir, GetNameFromUserIdAsync()'dan (yield).
local cache = {}
function getNameFromUserId(userId)
-- İlk olarak, önbellekte 'userId'nin olup olmadığını kontrol et.
local nameFromCache = cache[userId]
if nameFromCache then
-- Eğer 'userId' anahtarında önbellekte bir değer saklanmışsa,
-- bu 'nameFromCache' doğru isimdir ve bunu dönebiliriz.
return nameFromCache
end
-- Buradaysa, 'userId' daha önce aranmamış ve önbellekte yok.
-- Şimdi ismi bulmak için GetNameFromUserIdAsync() kullanmalıyız.
local name
local success, _ = pcall(function()
name = Players:GetNameFromUserIdAsync(userId)
end)
if success then
-- Eğer 'success' true ise, GetNameFromUserIdAsync() ismi başarılı bir şekilde buldu.
-- Bu ismi 'userId' anahtarıyla önbelleğe kaydedelim, böylece
-- gelecekte bu ismi aramak zorunda kalmayız. Sonra ismi döndür.
cache[userId] = name
return name
end
-- Buradaysa, 'success' false oldu, bu da GetNameFromUserIdAsync()
-- belirtilen 'userId' için 'name'i bulamadığı anlamına gelir. Kullanıcıyı
-- bunun olduğunu uyarın ve ardından hiçbir şey, yani nil döndürün.
warn("UserId için isim bulunamadı:", userId)
return nil
end
-- Örnek Veri:
-- UserId: 118271 İsim: "RobloxRulez"
-- UserId: 131963979 İsim: "docsRule"
-- Bir UserId ilk kez kullanıldığında, GetNameFromUserIdAsync() çağrılacak.
local nameOne = getNameFromUserId(118271)
local nameTwo = getNameFromUserId(131963979)
-- 118271 daha önce kullanıldığı için, ismini önbellekten al.
local nameOneQuick = getNameFromUserId(118271)
print(nameOne, nameTwo, nameOneQuick)
-- yazdırır: "RobloxRulez docsRule RobloxRulez"

GetPlayerByUserId
Paralel yaz
Capabilities: Players
Players:GetPlayerByUserId(userId:User):Player
Parametreler
userId:User
Dönüşler
Kod Örnekleri
Oyuncular:GetPlayerByUserId
local Players = game:GetService("Players")
local player = Players:GetPlayerByUserId(1)
if player then
print("Kullanıcı ID'si 1 olan oyuncu bu sunucuda! Adı: " .. player.Name)
else
print("Kullanıcı ID'si 1 olan oyuncu bu sunucuda değil!")
end

GetPlayerFromCharacter
Capabilities: Players
Simulation Access
Players:GetPlayerFromCharacter(character:Model):Player
Parametreler
character:Model
Dönüşler
Kod Örnekleri
Oyuncular:KarakterdenOyuncuAl
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(`Oyuncu {player.Name} ({player.UserId}) oyunda`)
else
print(`Oyuncu {PLAYER_NAME} oyunda değil!`)
end

GetPlayers
Paralel yaz
Capabilities: Players
Players:GetPlayers():{Player}
Dönüşler
Kod Örnekleri
Herkese Işıklandırma Ver
local Players = game:GetService("Players")
local function onCharacterAdded(character)
-- Başlarında henüz ışıklandırma yoksa onlara ver
if not character:FindFirstChild("Sparkles") then
local sparkles = Instance.new("Sparkles")
sparkles.Parent = character:WaitForChild("Head")
end
end
local function onPlayerAdded(player)
-- Zaten doğmuşlarsa kontrol et
if player.Character then
onCharacterAdded(player.Character)
end
-- Oyuncunun (yeniden) doğmasını dinle
player.CharacterAdded:Connect(onCharacterAdded)
end
Players.PlayerAdded:Connect(onPlayerAdded)

getPlayers
Artık Kullanılmayan

GetUserIdFromNameAsync
Bekletir
Capabilities: Players
Players:GetUserIdFromNameAsync(userName:string):number
Parametreler
userName:string
Dönüşler
Kod Örnekleri
İsimden Kullanıcı Kimliği Al
local Players = game:GetService("Players")
-- Örnek Veri:
-- Kullanıcı Kimliği: 118271 İsim: "RobloxRulez"
-- Kullanıcı Kimliği: 131963979 İsim: "docsRule"
local userIdOne = Players:GetUserIdFromNameAsync("RobloxRulez")
local userIdTwo = Players:GetUserIdFromNameAsync("docsRule")
print(userIdOne, userIdTwo)
-- yazdırır: "118271 131963979"
İsimden UserId almak için bir önbellek kullanma
local Players = game:GetService("Players")
-- Her bulunduğunda 'UserId' değerini saklamak için 'cache' adında bir tablo oluştur.
-- Eğer aynı 'Name' kullanılarak bir 'UserId' sorgularsak, 'UserId' değeri
-- önbellekten (hızlı) gelecek ve GetUserIdFromNameAsync() (yield eder) çağrılmayacak.
local cache = {}
function getUserIdFromName(name)
-- Öncelikle, önbelleğin 'name' içerip içermediğini kontrol et.
local userIdFromCache = cache[name]
if userIdFromCache then
-- Eğer 'name' anahtarında önbellekte bir değer saklandıysa, bu 'userIdFromCache'
-- doğru UserId'dir ve bunu döndürebiliriz.
return userIdFromCache
end
-- Eğer buradaysa, 'name' daha önce sorgulanmamış ve
-- önbellek'te mevcut değil. Şimdi GetUserIdFromNameAsync()'i kullanarak userId'yi
-- sorgulamamız gerekiyor.
local userId
local success, _ = pcall(function()
userId = Players:GetUserIdFromNameAsync(name)
end)
if success then
-- Eğer 'success' doğruysa, GetUserIdFromNameAsync() başarıyla
-- userId'yi buldu. Bu userId'yi önbelleğe 'name' anahtarını kullanarak
-- saklayalım böylece gelecekte bu userId'yi tekrar sorgulamak zorunda kalmayız.
cache[name] = userId
return userId
end
-- Eğer buradaysa, 'success' yanlış demektir, bu da GetUserIdFromNameAsync()
-- sağlanan 'name' için 'userId'yi bulamadığı anlamına gelir. Kullanıcıyı
-- bu durumun gerçekleştiği konusunda uyarabiliriz ve ardından hiçbir şey,
-- veya nil döndürebiliriz.
warn("İsim için UserId bulunamadı:", name)
return nil
end
-- Örnek Veri:
-- UserId: 118271 İsim: "RobloxRulez"
-- UserId: 131963979 İsim: "docsRule"
-- Bir İsim ilk kez kullanıldığında, GetUserIdFromNameAsync() çağrılacaktır.
local userIdOne = getUserIdFromName("RobloxRulez")
local userIdTwo = getUserIdFromName("docsRule")
-- "RobloxRulez" daha önce kullanıldığı için, cachesinden UserId'sini al
local userIdOneQuick = getUserIdFromName("RobloxRulez")
print(userIdOne, userIdTwo, userIdOneQuick)
-- çıktısı: "118271 131963979 118271"

GetUserThumbnailAsync
Bekletir
Capabilities: Players
Players:GetUserThumbnailAsync(
userId:User, thumbnailType:Enum.ThumbnailType, thumbnailSize:Enum.ThumbnailSize
Parametreler
userId:User
thumbnailType:Enum.ThumbnailType
thumbnailSize:Enum.ThumbnailSize
Dönüşler
Kod Örnekleri
Oyuncu Küçültmesi Göster
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local PLACEHOLDER_IMAGE = "rbxassetid://0" -- yer tutucu resmiyle değiştirin
-- küçültmeyi al
local userId = player.UserId
local thumbType = Enum.ThumbnailType.HeadShot
local thumbSize = Enum.ThumbnailSize.Size420x420
local content, isReady = Players:GetUserThumbnailAsync(userId, thumbType, thumbSize)
-- ImageLabel'in içeriğini kullanıcı küçültmesiyle ayarlayın
local imageLabel = script.Parent
imageLabel.Image = (isReady and content) or PLACEHOLDER_IMAGE
imageLabel.Size = UDim2.new(0, 420, 0, 420)

playerFromCharacter
Artık Kullanılmayan

players
Artık Kullanılmayan

SetChatStyle
Eklenti Güvenliği
Capabilities: Players
Players:SetChatStyle(style:Enum.ChatStyle):()
Parametreler
Varsayılan değer: "Classic"
Dönüşler
()
Kod Örnekleri
Bir Oyuncunun Sohbet Stilini Ayarlama
-- Komut çubuğu
game.Players:SetChatStyle(Enum.ChatStyle.Classic) -- Sohbet stilini Classic olarak ayarlıyor
-- LocalScript
local Players = game:GetService("Players")
Players:SetChatStyle(Enum.ChatStyle.Classic) -- Hata verir

TeamChat
Eklenti Güvenliği
Capabilities: Players
Players:TeamChat(message:string):()
Parametreler
message:string
Dönüşler
()
Kod Örnekleri
Takım Sohbeti Gönderme
-- Komut çubuğu
game.Players:TeamChat("Merhaba Dünya") -- Yerel oyuncunun takımındaki tüm oyunculara "Merhaba Dünya" mesajı gönderir
-- LocalScript
local Players = game:GetService("Players")
Players:TeamChat("Merhaba Dünya") -- Hata verir

UnbanAsync
Bekletir
Capabilities: Players, Consequences
Players:UnbanAsync(config:Dictionary):()
Parametreler
config:Dictionary
Dönüşler
()
Kod Örnekleri
Kullanıcıları Yasağı Kaldırma
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

Olaylar
PlayerAdded
Capabilities: Players
Players.PlayerAdded(player:Player):RBXScriptSignal
Parametreler
player:Player
Kod Örnekleri
Oyuncular.PlayerAdded
local Players = game:GetService("Players")
local function onPlayerAdded(player)
print("Bir oyuncu katıldı: " .. player.Name)
end
Players.PlayerAdded:Connect(onPlayerAdded)

PlayerMembershipChanged
Capabilities: Players
Players.PlayerMembershipChanged(player:Player):RBXScriptSignal
Parametreler
player:Player
Kod Örnekleri
Premium Üyelik Değişikliklerini Yönetme
local Players = game:GetService("Players")
local function grantPremiumBenefits(player)
-- Oyuncuya sadece Premium'a özel bölgelere, eşyalara veya hayal edebileceğiniz her şeye erişim verin!
print("Veriliyor", player, "premium avantajlar!")
end
local function playerAdded(player)
if player.MembershipType == Enum.MembershipType.Premium then
grantPremiumBenefits(player)
end
end
local function playerMembershipChanged(player)
print("PlayerMembershipChanged olayı alındı. Yeni üyelik = " .. tostring(player.MembershipType))
if player.MembershipType == Enum.MembershipType.Premium then
grantPremiumBenefits(player)
end
end
Players.PlayerAdded:Connect(playerAdded)
Players.PlayerMembershipChanged:Connect(playerMembershipChanged)

PlayerRemoving
Capabilities: Players
Players.PlayerRemoving(
Parametreler
player:Player
Kod Örnekleri
Oyuncular.PlayerRemoving
local Players = game:GetService("Players")
local function onPlayerRemoving(player)
print("Bir oyuncu ayrıldı: " .. player.Name)
end
Players.PlayerRemoving:Connect(onPlayerRemoving)

UserSubscriptionStatusChanged
Capabilities: Players, Monetization
Players.UserSubscriptionStatusChanged(
user:Player, subscriptionId:string
Parametreler
user:Player
subscriptionId:string

©2026 Roblox Corporation. Roblox, the Roblox logo and Powering Imagination are among our registered and unregistered trademarks in the U.S. and other countries.