StarterPlayer
*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
Player オブジェクトのプロパティのデフォルトを設設定するできるサービス。プレイヤーがサーバーに入ると、プレイヤーオブジェクトの各プロパティは、対応するプロパティの現在の値に設定されます StarterPlayer 。
さらに、このサービスに4つのオブジェクトを追加できます：
- 各プレイヤーに一度実行されるスクリプトを持つ StarterPlayerScripts インスタンス。
- スクリプトを使用して、各プレイヤーのキャラクターに毎回追加する StarterCharacterScripts インスタンス。
- それぞれのプレイヤーのキャラクターのデフォルトのヒューマノイドとして使用される名前付き Humanoid インスタンス StarterHumanoid が、A です。A instance named which will be used as the default humanoid for each player's character.
- すべてのプレイヤーのキャラクターモデルとして使用される名前の Model インスタンス StarterCharacter が指定された A インスタンス。
概要
プロパティ
ウェブサイトからのカスタムアバターアニメーションに関する現在のゲームの許可レベルを説明します。
キャラクターがモバイルデバイスで障害物に当たったときに自動的にジャンプするかどうかを設定します。
プレイヤーのデフォルトカメラがスタッドで拡大できる最大距離。
プレイヤーのデフォルトカメラがズームできる最小距離（スタッド）。
デフォルトのカメラのモードを第一または第三人称に変更します。
開始値 Humanoid.JumpHeight を Player.Character に設定します。
開始値 Humanoid.JumpPower を Player.Character に設定します。
開始値 Humanoid.MaxSlopeAngle を Player.Character に設定します。
開始状態の Humanoid.UseJumpPower を Player.Character に決定します。
開始値 Humanoid.WalkSpeed を Player.Character に設定します。
カメラとプレイヤーの間のオブジェクトをデフォルトカメラが処理する方法を設定します。
プレイヤーがコンピュータ上にいる場合、開発者が各プレイヤーのデフォルトカメラモードを上書きするようにします。
プレイヤーがコンピュータ上にいる場合、開発者がプレイヤーの移動モードを上書きするようにします。
プレイヤーがモバイルデバイス上にいる場合、開発者が各プレイヤーのデフォルトのカメラ移動モードを上書きするようにします。
プレイヤーがタッチデバイスにいる場合、開発者がプレイヤーの移動モードを上書きするようにします。
プレイヤーがデフォルトでマウスロックを切り替えることができるかどうかを決定します。
このプレイヤーが他の Humanoid ヘルスバーを見る距離を設定します。0に設定すると、ヘルスバーは表示されません。
プレイヤーのキャラクターの外観をロードするかどうか。
エクスペリエンスに生成されるキャラクターにレイヤーの衣装アクセサリが装備されるかどうかを示します。
このプレイヤーが他の Humanoid 名を見る距離を設定します。
アバターのロード中にユーザーが所有するエモートがロードされるかどうかを決定します。
プロパティ
AllowCustomAnimations
このプロパティは、ウェブサイトからのカスタムアバターに関する現在のゲームの許可レベルを説明します。 Animations
そのため、この値はゲーム内から変更することはできません。Web サイトのゲーム設定ページ内でゲームの許可レベルを変更することにより変更できるだけです。
このプロパティは、ゲームで使用することはありません。
AutoJumpEnabled
このプロパティは、キャラクタがモバイルデバイスで障害物に当たったときに自動的にジャンプするかどうかを設定します。
このプロパティは、StarterPlayer からゲームに参加するときに Player にコピーされます。その後。このプロパティの値は、スポーン時にキャラクターの Humanoid.AutoJumpEnabled の Humanoid プロパティにコピーされます。言い換えれば、これらの 3 つのプロパティを使用して、文字ごと、プレイヤーごと、ゲームごとの自動ジャンプ動作を設定できます。
コードサンプル
このコードサンプルは、テキストボタン用です。モバイルデバイス上で自動ジャンプ行動を切り替えることができます。
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local button = script.Parent
local function update()
-- 更新ボタンのテキストを変更
if player.AutoJumpEnabled then
button.Text = "Auto-Jump is ON"
else
button.Text = "Auto-Jump is OFF"
end
-- プレイヤーのキャラクターに属性を反映する、もし持っていれば
if player.Character then
local human = player.Character:FindFirstChild("Humanoid")
if human then
human.AutoJumpEnabled = player.AutoJumpEnabled
end
end
end
local function onActivated()
-- 自動ジャンプを切り替え
player.AutoJumpEnabled = not player.AutoJumpEnabled
-- その他のすべてを更新する
update()
end
button.Activated:Connect(onActivated)
update()AvatarJointUpgrade
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 = 75CameraMinZoomDistance
このプロパティは、カメラがデフォルトのカメラからキャラクターまでの最小距離をスタッドで設定します。
このプロパティは、ゲームに参加する各プレイヤーのデフォルト値を Player.CameraMinZoomDistance に設定します。この値が StarterPlayer.CameraMaxZoomDistance より高い値に設定されると、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 = 75CameraMode
ゲーム中の各プレイヤーのデフォルト値を Player.CameraMode に設定します。カメラには 2つのモードがあります：
最初の人
1人目のプレイヤーモードでは、プレイヤーのカメラが全方位でズームされます。 プロパティが に設定されている ビジブルGUIが存在しない限り、マウスがロックされ、ユーザーのカメラはマウスが移動すると回転します。
3人称
第三者モード (デフォルト) では、キャラクターはカメラに表示されます。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.LockFirstPersonCharacterJumpHeight
このプロパティは、プレイヤーの Player.Character の開始値を Humanoid.JumpHeight に設定します。このプロパティの値は、7.2スタッドにデフォルトで設定されます。
このプロパティは、そうでなければ関連しないため、プロパティウィンドウにのみ表示されます StarterPlayer.CharacterUseJumpPower が false に設定されている場合、そうでないと関連しないため。
このプロパティは、将来スポーンされるキャラクターに関連するものであるため、変更すると既存のプレイヤーキャラクターは変更されません。このプロパティの変更は、プレイヤーがリスポーンするときにのみ有効になります。
CharacterJumpPower
このプロパティは、プレイヤーの Player.Character の開始値を Humanoid.JumpPower に設定します。このプロパティの値は 50 にデフォルトで設定され、プレイヤーの Humanoid に適用すると、0から1000の間に制限されます。
このプロパティは、そうでなければ関連しないため、プロパティウィンドウにのみ表示されます StarterPlayer.CharacterUseJumpPower が true に設定されている場合、そうでないと関連しないため。
このプロパティは、将来スポーンされるキャラクターに関連するものであるため、変更すると既存のプレイヤーキャラクターは変更されません。このプロパティの変更は、プレイヤーがリスポーンするときにのみ有効になります。
CharacterMaxSlopeAngle
このプロパティは、プレイヤーの Player.Character の開始値を Humanoid.MaxSlopeAngle に設定します。デフォルトで 89° になるので、ヒューマノイドはデフォルトで望むほぼどんな坂を登ることができます。プレイヤーの Humanoid に適用すると、0から 89 の間に制限されます。
このプロパティは、将来スポーンされるキャラクターに関連するものであるため、変更すると既存のプレイヤーキャラクターは変更されません。このプロパティの変更は、プレイヤーがリスポーンするときにのみ有効になります。
CharacterUseJumpPower
は、プレイヤーの の開始値を決定します。切り替えると、プロパティウィンドウに表示されるプロパティが CharacterJumpHeight (ファル) または StarterPlayer.CharacterJumpPower (真) に変更されます。デフォルトは true です。
このプロパティは、将来スポーンされるキャラクターに関連するものであるため、変更すると既存のプレイヤーキャラクターは変更されません。このプロパティの変更は、プレイヤーがリスポーンするときにのみ有効になります。
CharacterWalkSpeed
このプロパティは、プレイヤーの Player.Character の開始値を Humanoid.WalkSpeed に設定します。このプロパティは、デフォルトで 16 に設定されます。
このプロパティは、将来スポーンされるキャラクターに関連するものであるため、変更すると既存のプレイヤーキャラクターは変更されません。このプロパティの変更は、プレイヤーがリスポーンするときにのみ有効になります。
ClassicDeath
DevCameraOcclusionMode
カメラとカメラの主題の間のオブジェクトを処理するデフォルトカメラスクリプトの方法を定義します。経験に参加するすべてのプレイヤーに適用され、個々のプレイヤーに変更することはできません。
デフォルト値は Zoom (0) です。利用可能なモードのリストについては、Enum.DevCameraOcclusionMode を参照してください。
DevComputerCameraMovementMode
このプロパティは、プレイヤーがコンピュータ上にいる場合、開発者がプレイヤーのカメラモードを上書きできるようにします。
これは、ゲームに参加するプレイヤーのデフォルトプロパティです。Player.DevComputerCameraMode を設定して、個々のプレイヤーに変更できます。
UserChoice に設定すると、プレイヤーのカメラ移動モードは、ゲーム設定でプレイヤーが設定したものによって決まります。そうでないと、モードはこのプロパティに基づいて設定されます。
利用可能な異なるカメラモードについては、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.ClassicDevComputerMovementMode
このプロパティは、プレイヤーがコンピュータ上にいる場合、開発者がプレイヤーの移動モードを上書きできるようにします。
これは、ゲームに参加するプレイヤーのデフォルトプロパティです。Player.DevComputerMovementMode を設定して、個々のプレイヤーに変更できます。
UserChoice に設定すると、プレイヤーの移動モードはゲーム設定で設定されたプレイヤーによって決まります。そうでないと、モードはこのプロパティに基づいて設定されます。
利用可能な異なる移動モードについては、Enum.DevComputerMovementMode を参照してください。プレイヤーがコンピュータ上にいる場合、開発者がプレイヤーの移動モードを上書きするようにします。
このプロパティは、コンピュータ上にないプレイヤーには影響しません。
DevTouchCameraMovementMode
このプロパティは、プレイヤーがタッチデバイスにある場合、開発者がプレイヤーのカメラモードを上書きできるようにします。
これは、ゲームに参加するプレイヤーのデフォルトプロパティです。Player.DevTouchCameraMode を設定して、個々のプレイヤーに変更できます。
UserChoice に設定すると、プレイヤーのカメラ移動モードは、ゲーム設定でプレイヤーが設定したものによって決まります。そうでないと、モードはこのプロパティに基づいて設定されます。
利用可能な異なるカメラモードについては、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.ClassicDevTouchMovementMode
このプロパティでは、プレイヤーがタッチデバイスにいる場合、開発者がプレイヤーの移動モードを上書きできます。
これは、ゲームに参加するプレイヤーのデフォルトプロパティです。Player.DevTouchMovementMode を設定して、個々のプレイヤーに変更できます。
UserChoice に設定すると、プレイヤーの移動モードはゲーム設定で設定されたプレイヤーによって決まります。そうでないと、モードはこのプロパティに基づいて設定されます。
利用可能な異なる移動モードについては、Enum.DevTouchMovementMode を参照してください。プレイヤーがタッチデバイスにいる場合、開発者がプレイヤーの移動モードを上書きするようにします。
このプロパティは、タッチ可能のデバイスにいないプレイヤーには影響しません。
EnableDynamicHeads
EnableMouseLockOption
このプロパティは、プレイヤーがデフォルトでマウスロックを切り替えられるかどうかを決定します。
マウスロックは、プレイヤーのカーソルを画面の中央にロックします。マウスを移動すると、Camera と Player が回転し、カメラの現在の回転に対して移動します。
このプロパティは、Player.DevEnableMouseLock の値を設定します。
シフトロック関連の 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)
endHealthDisplayDistance
このプロパティは、このプレイヤーが他の Humanoid ヘルスバーを見る距離をスタッドで設定します。0に設定すると、ヘルスバーは表示されません。このプロパティは、デフォルトで 100 スタッドに設定されます。
ゲームに参加すると、プレイヤーの表示距離を変更するには、Player.HealthDisplayDistance プロパティを設定できます。
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 = 0LoadCharacterAppearance
このプロパティは、プレイヤーのキャラクターの外観をロードするかどうかを設定します。
これを false に設定すると、プレイヤーに衣服 (帽子を含む)、ボディカラー、ボディパッケージ、またはプレイヤーのアバターの外観に関連するその他のものがないことになります。デフォルトでは、このプロパティは true に設定されます。
これを true に設定すると、プレイヤーがプレイヤーの Player.CharacterAppearanceId に対応する外観をロードします。
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 = falseLoadCharacterLayeredClothing
エクスペリエンスに生成されるキャラクターにレイヤーの衣装アクセサリが装備されるかどうかを示します(Workspace.MeshPartHeadsAndAccessories、Workspaceが有効になる必要があります)。
LuaCharacterController
NameDisplayDistance
このプレイヤーが他の Humanoid 名を見る距離を設定します。0 に設定されると、名前は非表示になります。このプロパティはデフォルトで 100 スタッドに設定されます。
ゲームに参加すると、プレイヤーの表示距離を変更するには、Player.NameDisplayDistance プロパティを設定できます。
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