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 インスタンス。

概要

プロパティ

プロパティ

AllowCustomAnimations

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

このプロパティは、ウェブサイトからのカスタムアバターに関する現在のゲームの許可レベルを説明します。 Animations

そのため、この値はゲーム内から変更することはできません。Web サイトのゲーム設定ページ内でゲームの許可レベルを変更することにより変更できるだけです。

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

AutoJumpEnabled

並列読み取り

このプロパティは、キャラクタがモバイルデバイスで障害物に当たったときに自動的にジャンプするかどうかを設定します。

このプロパティは、StarterPlayer からゲームに参加するときに Player にコピーされます。その後。このプロパティの値は、スポーン時にキャラクターの Humanoid.AutoJumpEnabledHumanoid プロパティにコピーされます。言い換えれば、これらの 3 つのプロパティを使用して、文字ごと、プレイヤーごと、ゲームごとの自動ジャンプ動作を設定できます。

コードサンプル

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

並列読み取り

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

このプロパティは、ゲームに参加する各プレイヤーのデフォルト値を Player.CameraMaxZoomDistance に設定します。この値が StarterPlayer.CameraMinZoomDistance より低い値に設定されると、CameraMinZoomDistanceに増加します。

コードサンプル

Setting Camera Zoom Distance

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

CameraMinZoomDistance

並列読み取り

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

このプロパティは、ゲームに参加する各プレイヤーのデフォルト値を Player.CameraMinZoomDistance に設定します。この値が StarterPlayer.CameraMaxZoomDistance より高い値に設定されると、CameraMaxZoomDistanceに減少します。

コードサンプル

Setting Camera Zoom Distance

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

CameraMode

並列読み取り

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

最初の人

1人目のプレイヤーモードでは、プレイヤーのカメラが全方位でズームされます。 プロパティが に設定されている ビジブルGUIが存在しない限り、マウスがロックされ、ユーザーのカメラはマウスが移動すると回転します。

3人称

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

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

コードサンプル

Playing in First Person

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

CharacterJumpHeight

並列読み取り

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

このプロパティは、そうでなければ関連しないため、プロパティウィンドウにのみ表示されます StarterPlayer.CharacterUseJumpPowerfalse に設定されている場合、そうでないと関連しないため。

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

CharacterJumpPower

並列読み取り

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

このプロパティは、そうでなければ関連しないため、プロパティウィンドウにのみ表示されます StarterPlayer.CharacterUseJumpPowertrue に設定されている場合、そうでないと関連しないため。

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

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 を参照してください。

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

コードサンプル

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

並列読み取り

このプロパティは、プレイヤーがコンピュータ上にいる場合、開発者がプレイヤーの移動モードを上書きできるようにします。

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

UserChoice に設定すると、プレイヤーの移動モードはゲーム設定で設定されたプレイヤーによって決まります。そうでないと、モードはこのプロパティに基づいて設定されます。

利用可能な異なる移動モードについては、Enum.DevComputerMovementMode を参照してください。プレイヤーがコンピュータ上にいる場合、開発者がプレイヤーの移動モードを上書きするようにします。

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

コードサンプル

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

並列読み取り

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

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

UserChoice に設定すると、プレイヤーのカメラ移動モードは、ゲーム設定でプレイヤーが設定したものによって決まります。そうでないと、モードはこのプロパティに基づいて設定されます。

利用可能な異なるカメラモードについては、Enum.DevTouchCameraMovementMode を参照してください。

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

コードサンプル

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

並列読み取り

このプロパティでは、プレイヤーがタッチデバイスにいる場合、開発者がプレイヤーの移動モードを上書きできます。

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

UserChoice に設定すると、プレイヤーの移動モードはゲーム設定で設定されたプレイヤーによって決まります。そうでないと、モードはこのプロパティに基づいて設定されます。

利用可能な異なる移動モードについては、Enum.DevTouchMovementMode を参照してください。プレイヤーがタッチデバイスにいる場合、開発者がプレイヤーの移動モードを上書きするようにします。

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

コードサンプル

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

並列読み取り

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

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

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

シフトロック関連の API が廃止プロセスにあるため、マウスをロックするために UserInputService.MouseBehavior を使用することをお勧めします。

コードサンプル

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

並列読み取り

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

ゲームに参加すると、プレイヤーの表示距離を変更するには、Player.HealthDisplayDistance プロパティを設定できます。

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

コードサンプル

Hiding Player Health and Names

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 から来ることが有益になります。

コードサンプル

Disabling a Player's Appearance

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

LoadCharacterLayeredClothing

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

エクスペリエンスに生成されるキャラクターにレイヤーの衣装アクセサリが装備されるかどうかを示します(Workspace.MeshPartHeadsAndAccessoriesWorkspaceが有効になる必要があります)。

LuaCharacterController

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

NameDisplayDistance

並列読み取り

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

ゲームに参加すると、プレイヤーの表示距離を変更するには、Player.NameDisplayDistance プロパティを設定できます。

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

コードサンプル

Hiding Player Health and Names

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

RagdollDeath

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

UserEmotesEnabled

並列読み取り

このプロパティは、アバターのロード中にユーザーが所有するエモートがロードされるかどうかを決定します。このプロパティを false に設定すると、ロードが無効になります。開発者は、Studio で直接または ゲーム設定メニュー を通じてプロパティを設定できます。

エモートロードが無効になっている場合、開発者がゲーム内でエモート機能を使用することを選択する限り、エモート UI は引き続き機能します。

参照してください アバターエモート、アバターエモートを制御、カスタマイズ、プレイする方法を説明する記事。

方法

イベント