学ぶ
エンジンクラス
Players
作成できません
サービス

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。


概要
方法
BanAsync(config: Dictionary):()
Chat(message: string):()
getPlayers():{Player}
非推奨
playerFromCharacter(character: Model):Player
非推奨
players():{Player}
非推奨
TeamChat(message: string):()
継承されたメンバー

APIリファレンス
プロパティ
BanningEnabled
スクリプト作成できません
並列読み取り
機能: Players
Players.BanningEnabled:boolean

BubbleChat
読み取り専用
複製されていません
並列読み取り
機能: Chat, Players
Players.BubbleChat:boolean

CharacterAutoLoads
複製されていません
並列読み取り
機能: Players
Players.CharacterAutoLoads:boolean
コードサンプル
プレイヤーリスポーンタイマー
local Players = game:GetService("Players")
-- CharacterAutoLoadsをfalseに設定
Players.CharacterAutoLoads = false
-- 死亡時にWorkspaceからプレイヤーのキャラクターを削除
Players.PlayerAdded:Connect(function(player)
while true do
local char = player.CharacterAdded:Wait()
char.Humanoid.Died:Connect(function()
char:Destroy()
end)
end
end)
-- すべての死亡プレイヤーを10秒ごとにリスポーン
while true do
local players = Players:GetChildren()
-- 各プレイヤーが死亡しているかをキャラクターがないことをチェックして確認し、死亡している場合はそのプレイヤーのキャラクターをロード
for _, player in pairs(players) do
if not workspace:FindFirstChild(player.Name) then
player:LoadCharacterAsync()
end
end
-- 次のリスポーンチェックまで10秒待機
task.wait(10)
end

ClassicChat
読み取り専用
複製されていません
並列読み取り
機能: Chat, Players
Players.ClassicChat:boolean

LocalPlayer
読み取り専用
複製されていません
並列読み取り
機能: Players
Players.LocalPlayer:Player

localPlayer
非推奨

MaxPlayers
読み取り専用
複製されていません
並列読み取り
機能: Players
Players.MaxPlayers:number

NumPlayers
非推奨

numPlayers
非推奨

PreferredPlayers
読み取り専用
複製されていません
並列読み取り
機能: Players
Players.PreferredPlayers:number

RespawnTime
並列読み取り
機能: Players
Players.RespawnTime:number

UseStrafingAnimations
スクリプト作成できません
並列読み取り
機能: Players
Players.UseStrafingAnimations:boolean

方法
BanAsync
イールド
機能: Players, Consequences
Players:BanAsync(config:Dictionary):()
パラメータ
config:Dictionary
戻り値
()
コードサンプル
ユーザーの禁止
local Players = game:GetService("Players")
if shouldBeBanned(player) then
local banHistoryPages = Players:GetBanHistoryAsync(player.UserId)
local duration = 86400 -- 24時間を秒で表したものです。推奨: ユーザーのBanHistoryに基づいた独自のロジックを使用してください
local config: BanConfigType = {
UserIds = { player.UserId },
Duration = duration,
DisplayReason = "コミュニティガイドライン#5に違反しました",
PrivateReason = "ユーザーに知られるべきではないが、記録に役立つものをここに記入してください",
ExcludeAltAccounts = false,
ApplyToUniverse = true,
}
local success, err = pcall(function()
return Players:BanAsync(config)
end)
print(success, err)
end

Chat
プラグインのセキュリティ
機能: Players
Players:Chat(message:string):()
パラメータ
message:string
戻り値
()
コードサンプル
プレイヤー:チャット
-- コマンドバー
game:GetService("Players"):Chat("こんにちは、世界!") --プレイヤーの名前のチャットログに「こんにちは、世界!」と表示されます。
-- スクリプト
local Players = game:GetService("Players")
Players:Chat("こんにちは、世界!") --エラー

CreateHumanoidModelFromDescription
非推奨

CreateHumanoidModelFromDescriptionAsync
イールド
機能: AvatarAppearance, Players
Players:CreateHumanoidModelFromDescriptionAsync(
description:HumanoidDescription, rigType:Enum.HumanoidRigType, assetTypeVerification:Enum.AssetTypeVerification
パラメータ
assetTypeVerification:Enum.AssetTypeVerification
既定値: "Default"
戻り値
コードサンプル
説明からヒューマノイドモデルを作成
game.Players:CreateHumanoidModelFromDescriptionAsync(Instance.new("HumanoidDescription"), Enum.HumanoidRigType.R15).Parent =
game.Workspace

CreateHumanoidModelFromUserId
非推奨

CreateHumanoidModelFromUserIdAsync
イールド
機能: Players
Players:CreateHumanoidModelFromUserIdAsync(userId:User):Model
パラメータ
userId:User
戻り値
コードサンプル
ユーザーIDからヒューマノイドモデルを作成する
game.Players:CreateHumanoidModelFromUserIdAsync(1).Parent = game.Workspace

GetBanHistoryAsync
イールド
機能: Players, Consequences
Players:GetBanHistoryAsync(userId:User):BanHistoryPages
パラメータ
userId:User

GetCharacterAppearanceAsync
非推奨

GetCharacterAppearanceInfoAsync
イールド
機能: Players
Players:GetCharacterAppearanceInfoAsync(userId:User):Dictionary
パラメータ
userId:User
戻り値
コードサンプル
キャラクター外見辞書の例
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 = "帽子",
id = 8,
},
name = "ストライプの帽子",
},
{
id = 13062491,
assetType = {
name = "顔のアクセサリー",
id = 42,
},
name = "ビジョン・フランセーズ",
},
{
id = 16598440,
assetType = {
name = "首のアクセサリー",
id = 43,
},
name = "赤い蝶ネクタイ",
},
{
id = 28999228,
assetType = {
name = "顔",
id = 18,
},
name = "喜びのサプライズ",
},
{
id = 86896488,
assetType = {
name = "シャツ",
id = 11,
},
name = "高価な赤いタキシードジャケット",
},
{
id = 86896502,
assetType = {
name = "パンツ",
id = 12,
},
name = "高価な赤いタキシードパンツ",
},
{
id = 376530220,
assetType = {
name = "左腕",
id = 29,
},
name = "ROBLOX ボーイ左腕",
},
{
id = 376531012,
assetType = {
name = "右腕",
id = 28,
},
name = "ROBLOX ボーイ右腕",
},
{
id = 376531300,
assetType = {
name = "左足",
id = 30,
},
name = "ROBLOX ボーイ左足",
},
{
id = 376531703,
assetType = {
name = "右足",
id = 31,
},
name = "ROBLOX ボーイ右足",
},
{
id = 376532000,
assetType = {
name = "胴体",
id = 27,
},
name = "ROBLOX ボーイ胴体",
},
},
}
print(result)

GetFriendsAsync
イールド
機能: Players, Social
Players:GetFriendsAsync(userId:User):FriendPages
パラメータ
userId:User
戻り値
コードサンプル
ロブロックスの友達を表示
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
-- 最初にプレイヤーのユーザーIDを取得します
local userId = Players:GetUserIdFromNameAsync(USERNAME)
-- 次に、彼らのフレンドのためのFriendPagesオブジェクトを取得します
local friendPages = Players:GetFriendsAsync(userId)
-- 各ページのアイテムを反復処理します。FriendPagesの場合、これらは
-- ユーザー名を含む友人に関する情報のテーブルです。
-- 各ユーザー名をテーブルに収集します
local usernames = {}
for item, _pageNo in iterPageItems(friendPages) do
table.insert(usernames, item.Username)
end
print("" .. USERNAME .. "の接続: " .. table.concat(usernames, ", "))

GetHumanoidDescriptionFromOutfitId
非推奨

GetHumanoidDescriptionFromOutfitIdAsync
イールド
機能: AvatarAppearance, Players
Players:GetHumanoidDescriptionFromOutfitIdAsync(outfitId:number):HumanoidDescription
パラメータ
outfitId:number
コードサンプル
アウトフィットIDからHumanoidDescriptionを取得する
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
非推奨

GetHumanoidDescriptionFromUserIdAsync
イールド
機能: AvatarAppearance, Players
Players:GetHumanoidDescriptionFromUserIdAsync(userId:User):HumanoidDescription
パラメータ
userId:User
コードサンプル
ユーザーIDからHumanoidDescriptionを取得
game.Players:CreateHumanoidModelFromDescriptionAsync(
game.Players:GetHumanoidDescriptionFromUserIdAsync(1),
Enum.HumanoidRigType.R15
).Parent =
game.Workspace

GetNameFromUserIdAsync
イールド
機能: Players
Players:GetNameFromUserIdAsync(userId:User):string
パラメータ
userId:User
戻り値
コードサンプル
ユーザーIDから名前を取得
local Players = game:GetService("Players")
-- 例のデータ:
-- UserId: 118271 名前: "RobloxRulez"
-- UserId: 131963979 名前: "docsRule"
local nameOne = Players:GetNameFromUserIdAsync(118271)
local nameTwo = Players:GetNameFromUserIdAsync(131963979)
print(nameOne, nameTwo)
-- 出力: "RobloxRulez docsRule"
キャッシュを使用してUserIdから名前を取得
local Players = game:GetService("Players")
-- 見つかった各 'Name' を保存するために 'cache' と呼ばれるテーブルを作成します。
-- 同じ 'UserId' を使用して 'Name' を検索する場合、'Name' はキャッシュから取得されます(速い)
-- GetNameFromUserIdAsync() からではなく(継続します)。
local cache = {}
function getNameFromUserId(userId)
-- 最初に、キャッシュに 'userId' が含まれているか確認します。
local nameFromCache = cache[userId]
if nameFromCache then
-- 'userId' のキーでキャッシュに値が保存されている場合、'nameFromCache' は
-- 正しい名前であり、それを返すことができます。
return nameFromCache
end
-- ここにきた場合、'userId' は以前に検索されておらず、
-- キャッシュにも存在しません。ここで、GetNameFromUserIdAsync() を使用して名前を検索する必要があります。
local name
local success, _ = pcall(function()
name = Players:GetNameFromUserIdAsync(userId)
end)
if success then
-- 'success' が真であれば、GetNameFromUserIdAsync() が
-- 名前を正常に見つけました。この名前をキャッシュに保存し、
-- 'userId' をキーとして、今後この名前を検索する必要がないようにします。
cache[userId] = name
return name
end
-- ここにきた場合、'success' が偽であり、
-- GetNameFromUserIdAsync() が提供された 'userId' に対して 'name' を見つけられなかったことを意味します。
-- これが起こったことをユーザーに警告し、その後何も返さずに nil を返します。
warn("UserId の名前を見つけられませんでした:", userId)
return nil
end
-- 例データ:
-- UserId: 118271 Name: "RobloxRulez"
-- UserId: 131963979 Name: "docsRule"
-- UserId が初めて使用されると、GetNameFromUserIdAsync() が呼ばれます。
local nameOne = getNameFromUserId(118271)
local nameTwo = getNameFromUserId(131963979)
-- 118271 は以前に使用されたため、キャッシュから名前を取得します。
local nameOneQuick = getNameFromUserId(118271)
print(nameOne, nameTwo, nameOneQuick)
-- 印刷: "RobloxRulez docsRule RobloxRulez"

GetPlayerByUserId
並列書き込み
機能: Players
Players:GetPlayerByUserId(userId:User):Player
パラメータ
userId:User
戻り値
コードサンプル
Players:GetPlayerByUserId
local Players = game:GetService("Players")
local player = Players:GetPlayerByUserId(1)
if player then
print("ユーザーID 1 のプレイヤーはこのサーバーにいます! 彼らの名前は: " .. player.Name)
else
print("ユーザーID 1 のプレイヤーはこのサーバーにはいません!")
end

GetPlayerFromCharacter
機能: Players
シミュレーションへのアクセス
Players:GetPlayerFromCharacter(character:Model):Player
パラメータ
character:Model
戻り値
コードサンプル
プレイヤー: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(`プレイヤー {player.Name} ({player.UserId}) がゲームに参加しています`)
else
print(`プレイヤー {PLAYER_NAME} はゲームに参加していません!`)
end

GetPlayers
並列書き込み
機能: Players
Players:GetPlayers():{Player}
戻り値
コードサンプル
全員にスパークルを付ける
local Players = game:GetService("Players")
local function onCharacterAdded(character)
-- もし彼らの頭にスパークルがまだなければ、スパークルを付ける
if not character:FindFirstChild("Sparkles") then
local sparkles = Instance.new("Sparkles")
sparkles.Parent = character:WaitForChild("Head")
end
end
local function onPlayerAdded(player)
-- 彼らがすでに出現しているか確認する
if player.Character then
onCharacterAdded(player.Character)
end
-- プレイヤーが(再)出現するのをリスンする
player.CharacterAdded:Connect(onCharacterAdded)
end
Players.PlayerAdded:Connect(onPlayerAdded)

getPlayers
非推奨

GetUserIdFromNameAsync
イールド
機能: Players
Players:GetUserIdFromNameAsync(userName:string):number
パラメータ
userName:string
戻り値
コードサンプル
名前からUserIdを取得
local Players = game:GetService("Players")
-- 例のデータ:
-- UserId: 118271 名前: "RobloxRulez"
-- UserId: 131963979 名前: "docsRule"
local userIdOne = Players:GetUserIdFromNameAsync("RobloxRulez")
local userIdTwo = Players:GetUserIdFromNameAsync("docsRule")
print(userIdOne, userIdTwo)
-- prints: "118271 131963979"
キャッシュを使用して名前からUserIdを取得
local Players = game:GetService("Players")
-- 見つかった各 'UserId' を格納するために 'cache' というテーブルを作成します。
-- 同じ 'Name' を使って 'UserId' を検索する場合、'UserId' はキャッシュから
-- (速い) 取得され、GetUserIdFromNameAsync() (イールド) からは取得されません。
local cache = {}
function getUserIdFromName(name)
-- 最初に、キャッシュに 'name' が含まれているかを確認します
local userIdFromCache = cache[name]
if userIdFromCache then
-- キャッシュに 'name' のキーで値が保存されている場合、この 'userIdFromCache'
-- は正しい UserId であり、これを返すことができます。
return userIdFromCache
end
-- ここにいる場合、'name' は以前に検索されておらず、キャッシュには存在しません。
-- さて、GetUserIdFromNameAsync() を使って userId を検索する必要があります
local userId
local success, _ = pcall(function()
userId = Players:GetUserIdFromNameAsync(name)
end)
if success then
-- 'success' が true の場合、GetUserIdFromNameAsync() が userId を正常に見つけました。
-- この userId をキャッシュに 'name' をキーとして保存して、
-- 将来的にこの userId を再度検索する必要がないようにします。この後、userId を返します。
cache[name] = userId
return userId
end
-- ここにいる場合、'success' が false だったことを意味し、
-- GetUserIdFromNameAsync() は提供された 'name' に対して 'userId' を見つけることができませんでした。この場合、
-- ユーザーにこれが発生したことを警告し、何も返さないか、nilを返します。
warn("ユーザーIDを見つけられませんでした Name:", name)
return nil
end
-- サンプルデータ:
-- UserId: 118271 Name: "RobloxRulez"
-- UserId: 131963979 Name: "docsRule"
-- 名前が最初に使用されるとき、GetUserIdFromNameAsync() が呼び出されます
local userIdOne = getUserIdFromName("RobloxRulez")
local userIdTwo = getUserIdFromName("docsRule")
-- "RobloxRulez" が以前に使用されたため、キャッシュから UserId を取得します
local userIdOneQuick = getUserIdFromName("RobloxRulez")
print(userIdOne, userIdTwo, userIdOneQuick)
-- 出力: "118271 131963979 118271"

GetUserThumbnailAsync
イールド
機能: Players
Players:GetUserThumbnailAsync(
userId:User, thumbnailType:Enum.ThumbnailType, thumbnailSize:Enum.ThumbnailSize
パラメータ
userId:User
thumbnailType:Enum.ThumbnailType
thumbnailSize:Enum.ThumbnailSize
戻り値
コードサンプル
プレイヤーのサムネイルを表示
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local PLACEHOLDER_IMAGE = "rbxassetid://0" -- プレースホルダー画像に置き換えます
-- サムネイルを取得
local userId = player.UserId
local thumbType = Enum.ThumbnailType.HeadShot
local thumbSize = Enum.ThumbnailSize.Size420x420
local content, isReady = Players:GetUserThumbnailAsync(userId, thumbType, thumbSize)
-- ImageLabelのコンテンツをユーザーのサムネイルに設定
local imageLabel = script.Parent
imageLabel.Image = (isReady and content) or PLACEHOLDER_IMAGE
imageLabel.Size = UDim2.new(0, 420, 0, 420)

playerFromCharacter
非推奨

players
非推奨

SetChatStyle
プラグインのセキュリティ
機能: Players
Players:SetChatStyle(style:Enum.ChatStyle):()
パラメータ
既定値: "Classic"
戻り値
()
コードサンプル
プレイヤーのチャットスタイルの設定
-- コマンドバー
game.Players:SetChatStyle(Enum.ChatStyle.Classic) -- チャットスタイルをクラシックに設定
-- LocalScript
local Players = game:GetService("Players")
Players:SetChatStyle(Enum.ChatStyle.Classic) -- エラー発生

TeamChat
プラグインのセキュリティ
機能: Players
Players:TeamChat(message:string):()
パラメータ
message:string
戻り値
()
コードサンプル
チームチャットの送信
-- コマンドバー
game.Players:TeamChat("こんにちは世界") -- ローカルプレイヤーのチームのすべてのプレイヤーに「こんにちは世界」というメッセージを送信します
-- LocalScript
local Players = game:GetService("Players")
Players:TeamChat("こんにちは世界") -- エラーになります

UnbanAsync
イールド
機能: Players, Consequences
Players:UnbanAsync(config:Dictionary):()
パラメータ
config:Dictionary
戻り値
()
コードサンプル
ユーザーの禁止解除
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

イベント
PlayerAdded
機能: Players
Players.PlayerAdded(player:Player):RBXScriptSignal
パラメータ
player:Player
コードサンプル
Players.PlayerAdded
local Players = game:GetService("Players")
local function onPlayerAdded(player)
print("プレイヤーが参加しました: " .. player.Name)
end
Players.PlayerAdded:Connect(onPlayerAdded)

PlayerMembershipChanged
機能: Players
Players.PlayerMembershipChanged(player:Player):RBXScriptSignal
パラメータ
player:Player
コードサンプル
プレミアムメンバーシップの変更の処理
local Players = game:GetService("Players")
local function grantPremiumBenefits(player)
-- プレイヤーにプレミアム専用エリア、アイテム、または想像できる全てのものへのアクセスを付与します!
print("Giving", player, "premium benefits!")
end
local function playerAdded(player)
if player.MembershipType == Enum.MembershipType.Premium then
grantPremiumBenefits(player)
end
end
local function playerMembershipChanged(player)
print("Received event PlayerMembershipChanged. New membership = " .. tostring(player.MembershipType))
if player.MembershipType == Enum.MembershipType.Premium then
grantPremiumBenefits(player)
end
end
Players.PlayerAdded:Connect(playerAdded)
Players.PlayerMembershipChanged:Connect(playerMembershipChanged)

PlayerRemoving
機能: Players
Players.PlayerRemoving(
パラメータ
player:Player
コードサンプル
Players.PlayerRemoving
local Players = game:GetService("Players")
local function onPlayerRemoving(player)
print("プレイヤーが退室しました: " .. player.Name)
end
Players.PlayerRemoving:Connect(onPlayerRemoving)

UserSubscriptionStatusChanged
機能: Players, Monetization
Players.UserSubscriptionStatusChanged(
user:Player, subscriptionId:string
パラメータ
user:Player
subscriptionId:string

©2026 Roblox Corporation。Roblox(ロブロックス)、RobloxロゴおよびPowering Imaginationは、米国並びにその他の国における登録商標および非登録商標です。