StarterPlayer

非推奨を表示

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

作成できません
サービス

Class.Player オブジェクトのデフォルトを設定するサービス。当サーバーに入ると、プレイヤーのオブジェクトの各プロパティが StarterPlayer の相応するプロパティの現在の値に設定されます。

さらに、このサービスに 4つのオブジェクトを追加できます:

  • 各プレイヤーのために 1 回実行するスクリプトを含む StarterPlayerScripts インスタンス。
  • スクリプトを毎回プレイヤーのキャラクターに追加する StarterCharacterScripts インスタンス。
  • Class.Humanoid インスタンス、名前は StarterHumanoid 、各プレイヤーのキャラクターのデフォルトのヒューマノイドとして使用されます。
  • すべてのプレイヤーに使用するキャラクターモデルとして使用される Model インスタンス。

概要

プロパティ

プロパティ

AllowCustomAnimations

非表示
Robloxのスクリプトセキュリティ
並列読み取り

The AllowCustomAnimations プロパティは、ウェブサイトからのカスタムアバター Animations について、現在のゲームのパーミッションレベルを説明します。

この値はゲーム内で変更できません。 ゲームの設定ページの [ゲームの権限レベル] を変更することによりのみ変更できます。

このプロパティは、ゲームで使用することはありません。

AutoJumpEnabled

並列読み取り

プロパティ AutoJumpEnabled は、モバイルデバイスの障害物にヒットすると、キャラクターが自動的にジャンプするかどうかを設定します。

このプロパティは、StarterPlayer から、ゲームに参加するときに、Player にコピーされます。その後、このプロパティの値は、Humanoid.AutoJumpEnabled のキャラクターの

コードサンプル

This code sample is meant for a TextButton. It allows the player to toggle the auto-jumping behavior while on a mobile device.

Auto-Jump Toggle

local Players = game:GetService("Players")
local player = Players.LocalPlayer
local button = script.Parent
local function update()
-- Update button text
if player.AutoJumpEnabled then
button.Text = "Auto-Jump is ON"
else
button.Text = "Auto-Jump is OFF"
end
-- Reflect the property in the player's character, if they have one
if player.Character then
local human = player.Character:FindFirstChild("Humanoid")
if human then
human.AutoJumpEnabled = player.AutoJumpEnabled
end
end
end
local function onActivated()
-- Toggle auto-jump
player.AutoJumpEnabled = not player.AutoJumpEnabled
-- Update everything else
update()
end
button.Activated:Connect(onActivated)
update()

AvatarJointUpgrade

複製されていません
スクリプト作成できません
閲覧できません
並列読み取り

CameraMaxZoomDistance

並列読み取り

プロパティ CameraMaxZoomDistance は、カメラがデフォルトのカメラからのキャラクターからの距離をスタッドで設定します。

このプロパティは、ゲームに参加するすべてのプレイヤーに対して Player.CameraMaxZoomDistance のデフォルト値を設定します。この値が StarterPlayer.CameraMinZoomDistance 以下に設定されている場合、CameraMinZoomDistance がカメラミニズーム距離に追加されます。

コードサンプル

The example demonstrates how to set a player's camera minimum and maximum zoom distance.

In this example, we set the Player.CameraMinZoomDistance and Player.CameraMaxZoomDistance to set the min and max distance in studs a player's camera can be from their character.

Note that since the example attempts to set the CameraMinZoomDistance to be greater than the CameraMaxZoomDistance, the CameraMinZoomDistance value will be decreased and set to the value of the max zoom distance.

To change the default min and max zoom distance values for a player when they first enter the game, you can change the StarterClass.Player.CameraMinZoomDistance and StarterClass.Player.CameraMaxZoomDistance properties.

Setting Camera Zoom Distance

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75

CameraMinZoomDistance

並列読み取り

プロパティ CameraMinZoonDistance は、カメラがデフォルトのカメラからのキャラクターからの最小距離をスタッドで設定します。

このプロパティは、ゲームに参加するすべてのプレイヤーに対して Player.CameraMinZoomDistance のデフォルト値を設定します。この値が StarterPlayer.CameraMaxZoomDistance より高い場合、カメラ最大ズーム距離が減少します。

コードサンプル

The example demonstrates how to set a player's camera minimum and maximum zoom distance.

In this example, we set the Player.CameraMinZoomDistance and Player.CameraMaxZoomDistance to set the min and max distance in studs a player's camera can be from their character.

Note that since the example attempts to set the CameraMinZoomDistance to be greater than the CameraMaxZoomDistance, the CameraMinZoomDistance value will be decreased and set to the value of the max zoom distance.

To change the default min and max zoom distance values for a player when they first enter the game, you can change the StarterClass.Player.CameraMinZoomDistance and StarterClass.Player.CameraMaxZoomDistance properties.

Setting Camera Zoom Distance

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75

CameraMode

並列読み取り

ゲーム中の各プレイヤーのためにデフォルトの値を設定します Player.CameraMode カメラは 2つのモードがあります:

1人称

1人称モードでは、プレイヤーのカメラが全体的にズームされます。GuiButton.Modal プロパティセットが true である場合を除き、マウスはロックされ、ユーザーのカメラはマウスが移動するときに変換されます。

第三者

第三者モード (デフォルト) では、キャラクターはカメラに表示されます。Roblox の第三者モードでは:

  • カメラを回転させるには、右クリックしてドラッグしたり、画面の右下隅にある矢印キーを使用したりできます。
  • マウスを移動すると、カメラは変わりません (マウスを画面の端に移動させることを除きます)。
  • 矢印キーのいずれかを押すと、ユーザーのキャラクターは、それに対応する矢印キーの方向に向くことがあります。
  • 自由に拡大/縮小できます。

コードサンプル

This example demonstrates how to change the character's CameraMode to first person using the LockFirstPerson value of the Enum.CameraMode enum.

Playing in First Person

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMode = Enum.CameraMode.LockFirstPerson

CharacterJumpHeight

並列読み取り

CharacterJumpHeight は、プレイヤーの Humanoid.JumpHeight の開始値に Character を決定します。このプロパティのデフォルト値は 7.2 スタッドです。

このプロパティは、StarterPlayer.CharacterUseJumpPowerfalse に設定されている場合にのみ、プロパティウィンドウに表示されます。

このプロパティは、現在のキャラクターのみに関連するので、変更すると、既存のプレイヤーキャラクターは変更されません。このプロパティの変更は、プレイヤーがリスポーンするときにのみ有効になります。

CharacterJumpPower

並列読み取り

CharacterJumpPower は、プレイヤーの Humanoid.JumpPower のスタート値を決定します。このプロパティのデフォルト値は 50 ですが、プレイヤーの Character に適用すると、0 から 1000 の間に制限されます。

このプロパティは、StarterPlayer.CharacterUseJumpPowertrue に設定されている場合にのみ、プロパティウィンドウに表示されます。

このプロパティは、現在のキャラクターのみに関連するので、変更すると、既存のプレイヤーキャラクターは変更されません。このプロパティの変更は、プレイヤーがリスポーンするときにのみ有効になります。

CharacterMaxSlopeAngle

並列読み取り

CharacterMaxSlopeAngle は、プレイヤーの Humanoid.MaxSlopeAngle のスタート値を決定します。デフォルトは 89° なので、人形はデフォルトで任意のスロープを登ります。Character に適用される

このプロパティは、現在のキャラクターのみに関連するので、変更すると、既存のプレイヤーキャラクターは変更されません。このプロパティの変更は、プレイヤーがリスポーンするときにのみ有効になります。

CharacterUseJumpPower

並列読み取り

CharacterUseJumpPower は、プレイヤーの Humanoid.UseJumpPower の開始値を変更します。これを切り替えると、プロパティウィンドウに表示されるプロパティの表示が変更されます:

このプロパティは、現在のキャラクターのみに関連するので、変更すると、既存のプレイヤーキャラクターは変更されません。このプロパティの変更は、プレイヤーがリスポーンするときにのみ有効になります。

CharacterWalkSpeed

並列読み取り

CharacterWalkSpeed は、プレイヤーの Humanoid.WalkSpeed のスタート値を決定します。このプロパティはデフォルトで 16 に設定されています。

このプロパティは、現在のキャラクターのみに関連するので、変更すると、既存のプレイヤーキャラクターは変更されません。このプロパティの変更は、プレイヤーがリスポーンするときにのみ有効になります。

DevCameraOcclusionMode

並列読み取り

デフォルトのカメラスクリプトがカメラとカメラの対象の間でオブジェクトを処理する方法を定義します。エクスペリエンスに参加するすべてのプレイヤーに適用され、個々のプレイヤーには変更できません。

デフォルトの値は Zoom (0) です。Enum.DevCameraOcclusionMode については、利用可能なモードのリスト を参照してください。

DevComputerCameraMovementMode

並列読み取り

プロパティ DevComputerCameraMovementMode は、プレイヤーがコンピューターにいる場合、またはプレイヤーがプレイヤーのカメラモードを上書きすることができます。

これはゲームに参加するプレイヤーのデフォルトプロパティです。 Player.DevComputerCameraMode を設定することで、個々のプレイヤーに変更できます。

GameSettings で Player.MoveCamera を設定している場合、プレイヤーのカメラの移動モードは、プレイヤーがゲーム設定で設定したようになります。そうでない場合、モードはこのプロパティに基づいて設定されます。

enum.devcomputercameraMovementMode については、異なるカメラモードが提供されている。

このプロパティは、コンピューター上のプレイヤーには影響しません。

コードサンプル

The example demonstrates how to set a player's camera movement mode for players on a computer.

In this example, we set the camera movement mode to Classic via the Enum.DevComputerCameraMovementMode enum. This means that the camera of players on touch enabled devices will track the player but will not automatically rotate if the player walks left or right.

Setting a Player's Camera Movement Mode (Desktop)

local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Set the player's camera movement mode on computers to classic
player.DevComputerCameraMode = Enum.DevComputerCameraMovementMode.Classic

DevComputerMovementMode

並列読み取り

プロパティ DevComputerMovementMove は、プレイヤーがコンピューターにある場合、プレイヤーの移動モードを上書きできます。

これはゲームに参加するプレイヤーのデフォルトプロパティです。 Player.DevComputerMovementMode を設定することで、個々のプレイヤーに変更できます。

енью.DevComputerMovementMode|UserChoice に設定されている場合、プレイヤーの移動モードは、ゲーム設定でプレイヤーが設定したものによって決まります。そうでない場合、モードはこのプロパティに基づいて設定されます。

enum.devcomputerMovementMode を参照して、利用可能なさまざまな移動モードを見てください。プレイヤーがコンピューターにいる場合、プレイヤーの移動モードを上書きして開発者がプレイヤーのコンピューターから移動モードをオーバーライドします。

このプロパティは、コンピューター上のプレイヤーには影響しません。

コードサンプル

Demonstrates how to set the movement mode for players on computers using the Player.DevComputerMovementMode property.

Setting a Player's Movement Mode (Desktop)

local Players = game:GetService("Players")
local function onPlayerAdded(player: Player)
-- Set the player's movement mode on desktop devices to click-to-move
-- Once set, the player can right click in the game world and the character will move there.
player.DevComputerMovementMode = Enum.DevComputerMovementMode.ClickToMove
end
Players.PlayerAdded:Connect(onPlayerAdded)

DevTouchCameraMovementMode

並列読み取り

プロパティ DevTouchCameraMovementMode は、プレイヤーがタッチデバイスにある場合、プレイヤーのカメラモードを上書きできます。

これはゲームに参加するプレイヤーのデフォルトプロパティです。 Player.DevTouchCameraMode を設定することで、個々のプレイヤーに変更できます。

GameSettings で Player.DevTouchCameraMovementMode|UserChoice に設定されている場合、プレイヤーのカメラの移動モードは、プレイヤーがゲーム設定で設定したようになります。

enum.dev触れるカメラモード については、「Enum.DevTouchCameraMovementMode」を参照してください。

このプロパティは、モバイルデバイスのプレイヤーには影響しません。

コードサンプル

The example demonstrates how to set a player's camera movement mode.

In this example, we set the camera movement mode to Classic via the Enum.DevTouchCameraMovementMode enum. This means that the camera of players on touch enabled devices will track the player but will not automatically rotate if the player walks left or right.

Setting a Player's Camera Movement Mode (Touch)

local Players = game:GetService("Players")
local player = Players.LocalPlayer
-- Set the player's camera movement mode on mobile devices to classic
player.DevTouchCameraMovementMode = Enum.DevTouchCameraMovementMode.Classic

DevTouchMovementMode

並列読み取り

プロパティ DevTouchMovementMode は、タッチデバイスの上にあるプレイヤーのモードを上書きできるようにします。

これはゲームに参加するプレイヤーのデフォルトプロパティです。 Player.DevTouchMovementMode を設定することで、個々のプレイヤーに変更できます。

枚数.DevTouchMovementMode|ユーザーの選択 に設定されている場合、プレイヤーの移動モードは、ゲーム設定に設定されたプレイヤーのモードによって決定されます。そうでない場合、モードはこのプロパティに基づいて設定されます。

枚数.DevTouchMovementMode を参照して、利用可能なさまざまな移動モードを見てください。タッチデバイスの場合、プレイヤーがモードをオーバーライドするように開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発者に開発

このプロパティは、タッチデバイスを有効にしていないプレイヤーには影響しません。

コードサンプル

The example demonstrates how to set the movement mode for players on touch enabled devices.

In this example, we set the movement mode to Thumbstick via the Enum.DevTouchMovementMode enum. This means that players on touch enabled devices are able to move via a virtual thumbstick on their screen.

Setting a Player's Movement Mode (Touch)

local Players = game:GetService("Players")
game.Players.PlayerAdded:Connect(function(player)
-- Set the player's movement mode on mobile devices to a dynamic thumbstick
player.DevTouchMovementMode = Enum.DevTouchMovementMode.DynamicThumbstick
end)

EnableDynamicHeads

スクリプト作成できません
並列読み取り

EnableMouseLockOption

並列読み取り

EnableMouseLockOption プロパティは、プレイヤーがデフォルトでマウスロックを切り替えるかどうかを決定します。

Mouse Lock は、プレイヤーのカーソルを画面の中央にロックします。マウスを移動すると、CameraPlayer がカメラの現在の回転に対して回転します。

このプロパティは Player.DevEnableMouseLock の値を設定します。

Shift-lock 関連の API は淘汰プロセスにあるため、マウスをロックする代わりに UserInputService.MouseBehavior

コードサンプル

The example demonstrates how to enable and disabled whether a player can lock their mouse.

In this example, we set the use a while true loop to toggle the state of the DevEnabledMouseLock property between true and false every 5 seconds. While this example has little practical use, it demos how to change the property via a LocalScript.

Enabling a Player's Mouse Lock

local Players = game:GetService("Players")
local player = Players.LocalPlayer
while true do
player.DevEnableMouseLock = not player.DevEnableMouseLock
task.wait(5)
end

HealthDisplayDistance

並列読み取り

プロパティ HealthDisplayDistance は、このプレイヤーが他の Humanoid ヘルスバーを見る距離をスタッドで設定します。0 でデフォルトでは健康バーは表示されません。このプロパティは、デフォルトで 100 スタッドに設定されています。

プレイヤーがゲームに参加すると、Player.HealthDisplayDistance プロパティを設定して、ディスプレイ距離を変更できます。

Class.Humanoid ヘルスバーが表示される場合、Humanoid.DisplayDistanceType を使用して表示タイプを設定できます。

コードサンプル

This example demonstrates how to hide other Humanoid's (Player and NPC) health bars and names.

This is done by setting the player's Player.HealthDisplayDistance and Player.NameDisplayDistance properties to 0.

If you would like to display health bars and names, you set the properties to a value greater than 0. For instance, setting the properties to 100 means that the player will see other player's health and names up to 100 studs away.

To modify the default values for players, you can change the values of the StarterClass.Player.HealthDisplayDistance and StarterClass.Player.NameDisplayDistance properties.

Hiding Player Health and Names

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0

LoadCharacterAppearance

並列読み取り

LoadCharacterAppearance プロパティは、プレイヤーのキャラクターの外観が読み込まれるかどかどかで設定します。

これを false に設定すると、プレイヤーに服がない (帽子を含む)、ボディの色、ボディパックなど、プレイヤーのアバターの外観に関連するものがありません。デフォルトでは、このプロパティは true に設定されています。

これを true に設定すると、プレイヤーがプレイヤーの Player.CharacterAppearanceId に対応する外観をロードします。

Class.Player:LoadCharacterWithHumanoidDescription() が使用されると、 StarterPlayer.LoadCharacterAppearance を偽に設定することができます。アセット ID がすべて、キャラクターを装備するための HumanoidDescription から来るようになります。

コードサンプル

This example demonstrates how to disable loading a player's character appearance. Instead, the player loads as a grey model without any hats, shirts, pants, etc.

This is useful for games using custom clothing and accessories.

Note that if the character has already spawned, this change will not take affect until the player respawns or the Player:LoadCharacter() function is called.

Disabling a Player's Appearance

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CanLoadCharacterAppearance = false

LoadCharacterLayeredClothing

複製されていません
スクリプト作成できません
並列読み取り

エクスペリエンスにスポーンするキャラクターにレイヤード衣装アクセサリーを装備しているかどうかを指します (ただし、Workspace.MeshPartHeadsAndAccessoriesWorkspace も、エクスペリエンス内で有効にする必要があります)。

LuaCharacterController

閲覧できません
並列読み取り

NameDisplayDistance

並列読み取り

このプレイヤーが他の Humanoid 名前を見る距離を設定します。0 に設定されていると、名前は非表示になります。

NameDisplayDistance StarterPlayer プロパティは、このプレイヤーが他の Humanoid 名を見る距離をスタッドで設定します。デフォルトでは、名前は非表示になります。このプロパティは、100スタッドでデフォルトで設定されています。

プレイヤーがゲームに参加すると、Player.NameDisplayDistance プロパティを設定して、ディスプレイ距離を変更できます。

Class.Humanoid 名前が表示される場合、Humanoid.DisplayDistanceType を使用して表示タイプを設定できます。

コードサンプル

This example demonstrates how to hide other Humanoid's (Player and NPC) health bars and names.

This is done by setting the player's Player.HealthDisplayDistance and Player.NameDisplayDistance properties to 0.

If you would like to display health bars and names, you set the properties to a value greater than 0. For instance, setting the properties to 100 means that the player will see other player's health and names up to 100 studs away.

To modify the default values for players, you can change the values of the StarterClass.Player.HealthDisplayDistance and StarterClass.Player.NameDisplayDistance properties.

Hiding Player Health and Names

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0

UserEmotesEnabled

並列読み取り

このプロパティは、アバターを読み込むときにユーザーが所有するエモートを読み込むかどうかを決定します。このプロパティを偽に設定すると、読み込みが無効になります。開発者は、ゲーム設定メニュー から直接または通過できます。

エモート読み込みが無効になっているときは、エモート UI は、ディベロッパーがゲーム内のエモート機能を使用することを選択した限り、機能します。

また、アバターエモート 、アバターエモートのコントロール、カスタマイズ、プレイ方法に関する記事を参照してください。

方法

イベント