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()
-- 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
このプロパティは、カメラがデフォルトのカメラからキャラクターまでの最大距離をスタッドで設定します。
このプロパティは、ゲームに参加する各プレイヤーのデフォルト値を Player.CameraMaxZoomDistance に設定します。この値が StarterPlayer.CameraMinZoomDistance より低い値に設定されると、CameraMinZoomDistanceに増加します。
コードサンプル
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75
CameraMinZoomDistance
このプロパティは、カメラがデフォルトのカメラからキャラクターまでの最小距離をスタッドで設定します。
このプロパティは、ゲームに参加する各プレイヤーのデフォルト値を Player.CameraMinZoomDistance に設定します。この値が StarterPlayer.CameraMaxZoomDistance より高い値に設定されると、CameraMaxZoomDistanceに減少します。
コードサンプル
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75
CameraMode
ゲーム中の各プレイヤーのデフォルト値を Player.CameraMode に設定します。カメラには 2つのモードがあります:
最初の人
1人目のプレイヤーモードでは、プレイヤーのカメラが全方位でズームされます。 プロパティが に設定されている ビジブルGUIが存在しない限り、マウスがロックされ、ユーザーのカメラはマウスが移動すると回転します。
3人称
第三者モード (デフォルト) では、キャラクターはカメラに表示されます。Roblox の第三者モードで:
- 右クリックしてドラッグしてカメラを回転させたり、画面右下の矢印キーを使って回転させることができます。
- マウスを移動すると、カメラは変更されません (マウスを画面の端に移動させない限り)。
- 矢印キーのいずれかを押すと、ユーザーのキャラクターが対応する矢印キーの方向に向きます。
- 自由に拡大し縮小できます。
コードサンプル
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMode = Enum.CameraMode.LockFirstPerson
CharacterJumpHeight
このプロパティは、プレイヤーの 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 を参照してください。
このプロパティは、コンピュータ上にないプレイヤーには影響しません。
コードサンプル
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
このプロパティは、プレイヤーがコンピュータ上にいる場合、開発者がプレイヤーの移動モードを上書きできるようにします。
これは、ゲームに参加するプレイヤーのデフォルトプロパティです。Player.DevComputerMovementMode を設定して、個々のプレイヤーに変更できます。
UserChoice に設定すると、プレイヤーの移動モードはゲーム設定で設定されたプレイヤーによって決まります。そうでないと、モードはこのプロパティに基づいて設定されます。
利用可能な異なる移動モードについては、Enum.DevComputerMovementMode を参照してください。プレイヤーがコンピュータ上にいる場合、開発者がプレイヤーの移動モードを上書きするようにします。
このプロパティは、コンピュータ上にないプレイヤーには影響しません。
コードサンプル
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
このプロパティは、プレイヤーがタッチデバイスにある場合、開発者がプレイヤーのカメラモードを上書きできるようにします。
これは、ゲームに参加するプレイヤーのデフォルトプロパティです。Player.DevTouchCameraMode を設定して、個々のプレイヤーに変更できます。
UserChoice に設定すると、プレイヤーのカメラ移動モードは、ゲーム設定でプレイヤーが設定したものによって決まります。そうでないと、モードはこのプロパティに基づいて設定されます。
利用可能な異なるカメラモードについては、Enum.DevTouchCameraMovementMode を参照してください。
このプロパティは、モバイルデバイス上ではないプレイヤーには影響しません。
コードサンプル
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
このプロパティでは、プレイヤーがタッチデバイスにいる場合、開発者がプレイヤーの移動モードを上書きできます。
これは、ゲームに参加するプレイヤーのデフォルトプロパティです。Player.DevTouchMovementMode を設定して、個々のプレイヤーに変更できます。
UserChoice に設定すると、プレイヤーの移動モードはゲーム設定で設定されたプレイヤーによって決まります。そうでないと、モードはこのプロパティに基づいて設定されます。
利用可能な異なる移動モードについては、Enum.DevTouchMovementMode を参照してください。プレイヤーがタッチデバイスにいる場合、開発者がプレイヤーの移動モードを上書きするようにします。
このプロパティは、タッチ可能のデバイスにいないプレイヤーには影響しません。
コードサンプル
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
このプロパティは、プレイヤーがデフォルトでマウスロックを切り替えられるかどうかを決定します。
マウスロックは、プレイヤーのカーソルを画面の中央にロックします。マウスを移動すると、Camera と Player が回転し、カメラの現在の回転に対して移動します。
このプロパティは、Player.DevEnableMouseLock の値を設定します。
シフトロック関連の API が廃止プロセスにあるため、マウスをロックするために UserInputService.MouseBehavior を使用することをお勧めします。
コードサンプル
local Players = game:GetService("Players")
local player = Players.LocalPlayer
while true do
player.DevEnableMouseLock = not player.DevEnableMouseLock
task.wait(5)
end
HealthDisplayDistance
このプロパティは、このプレイヤーが他の Humanoid ヘルスバーを見る距離をスタッドで設定します。0に設定すると、ヘルスバーは表示されません。このプロパティは、デフォルトで 100 スタッドに設定されます。
ゲームに参加すると、プレイヤーの表示距離を変更するには、Player.HealthDisplayDistance プロパティを設定できます。
Humanoid 健康バーが表示されている場合、Humanoid.DisplayDistanceType を使用して表示タイプを設定できます。
コードサンプル
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0
LoadCharacterAppearance
このプロパティは、プレイヤーのキャラクターの外観をロードするかどうかを設定します。
これを false に設定すると、プレイヤーに衣服 (帽子を含む)、ボディカラー、ボディパッケージ、またはプレイヤーのアバターの外観に関連するその他のものがないことになります。デフォルトでは、このプロパティは true に設定されます。
これを true に設定すると、プレイヤーがプレイヤーの Player.CharacterAppearanceId に対応する外観をロードします。
Player:LoadCharacterWithHumanoidDescription() を使用すると、プレイヤーのアバターが必要ではないため、StarterPlayer.LoadCharacterAppearance を偽に設定すると、すべてのアセットIDをキャラクターに装備するためにパスされた HumanoidDescription から来ることが有益になります。
コードサンプル
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CanLoadCharacterAppearance = false
LoadCharacterLayeredClothing
エクスペリエンスに生成されるキャラクターにレイヤーの衣装アクセサリが装備されるかどうかを示します(Workspace.MeshPartHeadsAndAccessories、Workspaceが有効になる必要があります)。
LuaCharacterController
NameDisplayDistance
このプレイヤーが他の Humanoid 名を見る距離を設定します。0 に設定されると、名前は非表示になります。このプロパティはデフォルトで 100 スタッドに設定されます。
ゲームに参加すると、プレイヤーの表示距離を変更するには、Player.NameDisplayDistance プロパティを設定できます。
Humanoid 名が表示される場合、Humanoid.DisplayDistanceType を使用して表示タイプを設定できます。
コードサンプル
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0