StarterPlayer
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
Class.Player オブジェクトのデフォルトを設定するサービス。当サーバーに入ると、プレイヤーのオブジェクトの各プロパティが StarterPlayer の相応するプロパティの現在の値に設定されます。
さらに、このサービスに 4つのオブジェクトを追加できます:
- 各プレイヤーのために 1 回実行するスクリプトを含む StarterPlayerScripts インスタンス。
- スクリプトを毎回プレイヤーのキャラクターに追加する StarterCharacterScripts インスタンス。
- Class.Humanoid インスタンス、名前は StarterHumanoid 、各プレイヤーのキャラクターのデフォルトのヒューマノイドとして使用されます。
- すべてのプレイヤーに使用するキャラクターモデルとして使用される Model インスタンス。
概要
プロパティ
ウェブサイトからのカスタムアバターアニメーションに関する現在のゲームの許可レベルを説明します。
モバイルデバイスの障害物をヒットすると、キャラクターが自動的にジャンプするかどうかを設定します。
プレイヤーのデフォルトカメラがスタッドでズームアウトできる最大距離。
プレイヤーのデフォルトカメラのスタッドで最小限の距離をスタッドでズームすることができます。
デフォルトのカメラのモードを「最初」または「3人目」に変更します。
Class.Player.Character の開始値を Player.Character に設定します。
Class.Player.Character の開始値を Player.Character に設定します。
Class.Player.Character の Class.Humanoid.MaxSlopeAngle の開始値を決定します。
Class.Humanoid.UseJumpPower の開始状態を Player.Character に決定します。
Class.Player.Character の Class.Humanoid.WalkSpeed の開始値を決定します。
カメラとプレイヤーの間のオブジェクトを扱うデフォルトのカメラハンドラーを設定します。
プレイヤーがコンピューターにいる場合、デベロッパーがプレイヤーのカメラモードをデフォルトでオーバーライドします。
プレイヤーがコンピューターにいる場合、開発者はプレイヤーの移動モードを上書きします。
プレイヤーがモバイルデバイスにいる場合、デベロッパーはデフォルトのカメラの移動モードをオーバーライドします。
プレイヤーがタッチデバイスにある場合、開発者がプレイヤーの移動モードを上書きします。
プレイヤーがデフォルトでマウスロックを切り替えることができるかどうかを決定します。
このプレイヤーが他の Humanoid ヘルスバーを見る距離を設定します。如果0、ヘルスバーは表示されません。
プレイヤーのキャラクターの外観をロードするかどうか。
キャラクターがエクスペリエンスにスポーンするかどうかにレイヤー付きの服装アクセサリーを装備しているかどうかを示します。
このプレイヤーが他の Humanoid 名前を見る距離を設定します。0 に設定されていると、名前は非表示になります。
アバターを読み込むときにユーザーが所有するエモートを読み込むかどうかを決めます。
プロパティ
AllowCustomAnimations
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.
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.
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.
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.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMode = Enum.CameraMode.LockFirstPerson
CharacterJumpHeight
CharacterJumpHeight は、プレイヤーの Humanoid.JumpHeight の開始値に Character を決定します。このプロパティのデフォルト値は 7.2 スタッドです。
このプロパティは、StarterPlayer.CharacterUseJumpPower が false に設定されている場合にのみ、プロパティウィンドウに表示されます。
このプロパティは、現在のキャラクターのみに関連するので、変更すると、既存のプレイヤーキャラクターは変更されません。このプロパティの変更は、プレイヤーがリスポーンするときにのみ有効になります。
CharacterJumpPower
CharacterJumpPower は、プレイヤーの Humanoid.JumpPower のスタート値を決定します。このプロパティのデフォルト値は 50 ですが、プレイヤーの Character に適用すると、0 から 1000 の間に制限されます。
このプロパティは、StarterPlayer.CharacterUseJumpPower が true に設定されている場合にのみ、プロパティウィンドウに表示されます。
このプロパティは、現在のキャラクターのみに関連するので、変更すると、既存のプレイヤーキャラクターは変更されません。このプロパティの変更は、プレイヤーがリスポーンするときにのみ有効になります。
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.
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.
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.
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.
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 は、プレイヤーのカーソルを画面の中央にロックします。マウスを移動すると、Camera と Player がカメラの現在の回転に対して回転します。
このプロパティは 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.
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.
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.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CanLoadCharacterAppearance = false
LoadCharacterLayeredClothing
エクスペリエンスにスポーンするキャラクターにレイヤード衣装アクセサリーを装備しているかどうかを指します (ただし、Workspace.MeshPartHeadsAndAccessories も Workspace も、エクスペリエンス内で有効にする必要があります)。
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.
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0