キャラクターの外観 | 文書 - Roblox クリエーターハブ

ほとんどのエクスペリエンスは、プレイヤーが自分の Roblox アバターを使用できるようにしますが、一部のエクスペリエンスは、マーチボットモジュールなど、ゲーム内のカスタマイズシステムを実装しています。他のエクスペリエンスは、ジャンルに一致するヘルメット、翼、またはアクセサリーを含む、プレイヤーのアバタ

ユーザーの外観を変更するユニークなエクスペリエンスを作成するには、フォロー中のコンポーネントを使用してデフォルトのキャラクタープロパティをカスタマイズできます：

アバターゲーム設定を設定して、すべてのユーザーに基本的なグローバルアバターの外観を設定します。
エクスペリエンスでユーザーにヒューマノイドの説明を適用するために、Any point to apply a wide-範囲 of specific character customizations to one or more users in your experience で使用します。

ゲーム設定

[ゲーム設定] メニューのアバターセクションでは、エクスペリエンス内の複数のグローバルキャラクタープロパティを素早く設定できます。アバターゲーム設定を編集すると、アバターがワークスペースでビジュアルプレビューとして表示されます。

アバターゲーム設定を使用して、エクスペリエンス中の次のキャラクタープロパティを調整できます：

設定	説明
プリセット	一般的なセットの BodyTypeScale と ProportionScale の組み合わせを適用します。HumanoidDescription を選択した後にこれらのプロパティをさらに調整することはできます。
アバターのタイプ	デフォルトのアバタータイプを R15 または R6 に設定します。
アニメーション	ユーザーがアクセスできる Animations のセット。
衝突	エクスペリエンス内のキャラクターの衝突ボーダーを設定します。
ボディパーツ	Class.HumanoidDescription.Face\|Face 、Head、Torso、1>Class
衣装	クラシック Shirt 、 Pants 、および ShirtGraphic 画像テクスチャを含む、キャラクターに適用できるアセット ID。

アバターの種類

アバタータイプ設定は、エクスペリエンスを R15 または R6 キャラクターモデルのみをロードするように設定します。

R15 は、15個のリンプスで構成されたデフォルトのモダンアバターです。このアバターは、より柔軟なカスタマイズ、アクセサリーオプション、およびアニメーションを可能にします。
R6 は、6本の腕と 1本の頭のクラシックな単純なアバターです。このアバタータイプは、レトロな感じを提供しますが、アニメーションと追加のカスタマイズには限界があります。ボディスケールプロパティに変更はありません。R6 キャラクターには影響しません。

R15 キャラクターモデル。

R6 キャラクターモデル。

衝突の境界

衝突設定は、エクスペリエンス内のキャラクターの衝突ボーダーを設定します。これにより、エクスペリエンス内のキャラクターの物理的外観に影響しません。

このオプションを外箱に設定すると、キャラクターのコリジョンボックスのサイズが個々のモデルに基づいてダイナミックにサイズ変更されます。これは、ほとんどのエクスペリエンスのデフォルトと推奨設定です。

このオプションを内側のボックスに設定すると、エクスペリエンス内のすべてのキャラクターに固定の衝突境界が提供されます。

ヒューマノイドの説明

プレイ可能なキャラクターモデルには、Humanoidオブジェクトが含まれており、モデルの特性、例えば歩行、ジャンプ、アイテム装備、および環境と対話することができます。キャラクターの外外見をカスタマイズするには、新しいHumanoidを�

エクスペリエンスで HumanoidDescription を使用して、次のキャラクタープロパティを調整できます：

キャラクタープロパティ	説明
スケール	物理的特徴の数値 height 、 width 、 head 、 1> Class.HumanoidDescription.BodyTypeScale\| body type> および
アクセサリー	装備されたキャラクターによるアセット ID のaccessories。
クラシック衣装	Class.Shirt 、Pants 、および ShirtGraphic のアセット ID は、キャラクターに適用できる 1>Class.ShirtGraphic1> 画像テクスチャです。
ボディパーツ	Class.HumanoidDescription.Face\|Face 、Head、Torso、1>Class
ボディカラー	キャラクターの個々のパーツの BodyColors 。
アニメーション	Class.Animation\|Animations のアセット ID は、キャラクターで使用できます。

次のステップを使用して、キャラクターをカスタマイズできます：HumanoidDescription

ユーザーのキャラクターから、特定のアウトフィット ID または特定のユーザー ID から、説明を作成します。
説明を変更して、Humanoid キャラクターに適用したいプロパティをカスタマイズします。
説明を適用する単一のキャラクター、すべてのプレイヤーキャラクター、またはすべてのスポーンキャラクターに。

Class.HumanoidDescription を使用して、特定の HumanoidDescription のプロパティを更新すると、Humanoid と 1>Class.Humanoid:GetAppliedDescription1> の両方を使用することが重要です。

ヒューマノイドの説明を作成中

エクスプローラー階層または HumanoidDescription 内の新しい Script インスタンスを直接作成できます。 You can create a new HumanoidDescription instance directly within the Explorer hierarchy or within a Script with the following codコード:


local humanoidDescription = Instance.new("HumanoidDescription")

ほとんどの場合、デフォルトの新しい HumanoidDescription の代わりに、既存の HumanoidDescription を使用する必要があります。デフォルトの新しい Class.HumanoidDescription に参照するか、2>playerCharacter2> 、5>avatarOutfit5> または 8>userID8> を参照してください。

プレイヤーキャラクターから

次のコードサンプルを使用して、プレイヤーのキャラクターの現在のプロパティに基づいて新しい HumanoidDescription を作成します：


local humanoid = player.Character and player.Character:FindFirstChildWhichIsA("Humanoid")

local humanoidDescription = Instance.new("HumanoidDescription")

if humanoid then
	humanoidDescription = humanoid:GetAppliedDescription()
end

既存の衣服から

次のサンプルコードを使用して、HumanoidDescription を作成する衣装 ID を使用して、Players.GetHumanoidDescriptionFromOutfitID を使用しています：


local Players = game:GetService("Players")

local outfitId = 480059254

local humanoidDescriptionFromOutfit = Players:GetHumanoidDescriptionFromOutfitId(outfitId)

特定のユーザーから

次のサンプルコードを使用して、HumanoidDescription をユーザーID 使用して作成します Players:GetHumanoidDescriptionFromUserId() :


local Players = game:GetService("Players")

local userId = 491243243

local humanoidDescriptionFromUser = Players:GetHumanoidDescriptionFromUserId(userId)

ヒューマノイドの説明を変更する

Class.HumanoidDescription プロパティをカスタマイズするには、HumanoidDescription に直接設定するか、HumanoidDescription を適用する前に指定されたメソッドを使用してください。

次のコードサンプルでは、HumanoidDescription プロパティの異なる種類を設定する方法の例を提供しています：


local humanoidDescription = Instance.new("HumanoidDescription")
humanoidDescription.HatAccessory = "2551510151,2535600138"
humanoidDescription.BodyTypeScale = 0.1
humanoidDescription.ClimbAnimation = 619521311
humanoidDescription.Face = 86487700
humanoidDescription.GraphicTShirt = 1711661
humanoidDescription.HeadColor = Color3.new(0, 1, 0)

複数のアクセサリーを設定する

レイヤー付きまたはバルクアクセサリーの変更には、HumanoidDescription:SetAccessories() を使用してアクセサリーに関連する更新を行うことができます。次のコードサンプルは、レイヤー付きのセーターとジャケットをその順序で追加します。次のコードサンプルは、HumanoidDescription にレイヤー付きのセーターとジャケットを追


local humanoidDescription = Instance.new("HumanoidDescription")
local accessoryTable = {
	{
		Order = 1,
		AssetId = 6984769289,
		AccessoryType = Enum.AccessoryType.Sweater
	},
	{
		Order = 2,
		AssetId = 6984767443,
		AccessoryType = Enum.AccessoryType.Jacket
	}
}

humanoidDescription:SetAccessories(accessoryTable, false)

Class.HumanoidDescription をエクスペリエンスに Humanoid 特定のキャラクターに適用するには、Humanoid:ApplyDescription() または 1>Class.Player:LoadCharacterWithHumanoidDescription()|Humanoid.LoadCharacterWithHumanoidDescription1> を通じて。

Class.HumanoidDescription を変更しながら、キャラクターのアセットを変更すると、未定義の動作が発生する可能性があります。

1人のキャラクター

ApplyDescription() は、任意の Humanoid をターゲットにすることができます。使用するコードは次のとおりです。新しいサングラスのペアと新しいトーラスをプレイヤーキャラクターに追加するためのコードは次のとおりです：


local humanoid = player.Character and player.Character:FindFirstChildWhichIsA("Humanoid")
if humanoid then
	local descriptionClone = humanoid:GetAppliedDescription()
	descriptionClone.Torso = 86500008
	-- 複数の顔アクセサリーアセットは、コマ-セパレートのストリングによって許可されていま文字列
	descriptionClone.FaceAccessory = descriptionClone.FaceAccessory .. ",2535420239"
	-- 「説明クローン」をヒューマノイドに適用
	humanoid:ApplyDescription(descriptionClone)
end

すべてのプレイヤーキャラクターに

次のサンプルコードを使用して、HumanoidDescription をゲームのすべての現在のプレイヤーに適用します：


local Players = game:GetService("Players")

for _, player in Players:GetPlayers() do
	local humanoid = player.Character and player.Character:FindFirstChildWhichIsA("Humanoid")
	if humanoid then
		-- ヒューマノイドの説明を作成
		local humanoidDescription = Instance.new("HumanoidDescription")
		humanoidDescription.HatAccessory = "2551510151,2535600138"
		humanoidDescription.BodyTypeScale = 0.1
		humanoidDescription.ClimbAnimation = 619521311
		humanoidDescription.Face = 86487700
		humanoidDescription.GraphicTShirt = 1711661
		humanoidDescription.HeadColor = Color3.new(0, 1, 0)
		humanoid:ApplyDescription(humanoidDescription)
	end
end

すべてのスポーンするキャラクターに

次のサンプルコードを使用して、すべてのスポーンプレイヤーキャラクターに対して特定の HumanoidDescription を設定します：


local Players = game:GetService("Players")

-- 「PlayerAdded」コールバックで自動スポーンを停止する
Players.CharacterAutoLoads = false

local function onPlayerAdded(player)
	-- ヒューマノイドの説明を作成
	local humanoidDescription = Instance.new("HumanoidDescription")
	humanoidDescription.HatAccessory = "2551510151,2535600138"
	humanoidDescription.BodyTypeScale = 0.1
	humanoidDescription.ClimbAnimation = 619521311
	humanoidDescription.Face = 86487700
	humanoidDescription.GraphicTShirt = 1711661
	humanoidDescription.HeadColor = Color3.new(0, 1, 0)

	-- ヒューマノイド説明と一緒にキャラクターをスポーンする
	player:LoadCharacterWithHumanoidDescription(humanoidDescription)
end

-- 「PlayerAdded」イベントを「onPlayerAdded()」関数に接続する
Players.PlayerAdded:Connect(onPlayerAdded)

Class.HumanoidDescription インスタンスが Explorer の下にある場合、Script を使用してワークスペースインスタンスにアクセスするには、次のサンプルコードを使用してください：


local Players = game:GetService("Players")

-- 「PlayerAdded」コールバックで自動スポーンを停止する
Players.CharacterAutoLoads = false

local function onPlayerAdded(player)
	-- 「workspace.StudioHumanoidDescription」でキャラクターをスポーン
	player:LoadCharacterWithHumanoidDescription(workspace.StudioHumanoidDescription)
end

-- 「PlayerAdded」イベントを「onPlayerAdded()」関数に接続する
Players.PlayerAdded:Connect(onPlayerAdded)