StarterPlayer

顯示已棄用項目

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡

無法建立
服務

允許玩家在 Player 對象中設定積分的預設值。當玩家進入伺服器時,每個玩家對象的積分都會設置為對應的積分的當前值在 StarterPlayer

此服務的四個對象可以加入到此服務中:

  • Class.StarterPlayerScripts 實例,課程碼會在每個玩家執行一次。
  • Class.StarterCharacterScripts 實例,每次玩家生成時都會添加到他們的角色。
  • 名為 Humanoid 的一個名為 StarterHumanoid 的實例,這將是每個玩家的角色的預設人形。
  • 名為 Model 的一個 StarterCharacter 實例,將作為所有玩家的角色模型使用。

概要

屬性

屬性

AllowCustomAnimations

隱藏
Roblox 指令碼安全性
平行讀取

AllowCustomAnimations 屬性描述當前遊戲的許可等級,關於自訂虛擬人偶 Animations 從網站。

因此,此值無法在遊戲中變更。它只能通過變更遊戲的許可等級在網站的設定頁面來變更。

此屬性不適用於遊戲。

AutoJumpEnabled

平行讀取

AutoJumpEnabled 屬性設定角色在移動設裝置上擊中障礙時是否會自動跳躍。

這個屬性是從 StarterPlayer 複製到 Player 當他們加入遊戲時。 在那之後,這個屬性的值會被複製到 Humanoid.AutoJumpEnabled 角色的 1>Class.Humanoid</

範例程式碼

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。

範例程式碼

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 的值,它將被減少至 CameraMaxZoomDistance。

範例程式碼

Setting Camera Zoom Distance

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

CameraMode

平行讀取

為每個遊戲中的玩家設定預設值 Player.CameraMode 。 攝影機有兩種模式:

第一人稱

在第一人稱模式中,玩家的相機會將全方位盤入。除非有可見的 GUI 現象,否則會有 GuiButton.Modal 屬性設定為 true ,否則滑鼠將鎖定,使用者的相機將會跟隨滑鼠移動。

第三人稱

在第三人稱模式 (預設) 中,角色可以在攝影機中查看。在 Roblox 的第三人稱模式中:

  • 您可以按一下滑鼠右鍵並拖曳以旋轉相攝影機,或使用箭頭鍵在屏幕右下角。
  • 當您移動鼠滑鼠時,您的相機不會改變 (除非您將鼠標移動到畫面端)。
  • 當您按下任何箭頭按鍵時,使用者的角色將會面向相應的箭頭按鍵的方向。
  • 您可以自由放大和縮小。

範例程式碼

Playing in First Person

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

CharacterJumpHeight

平行讀取

CharacterJumpHeight 決定玩家的 Humanoid.JumpHeight 的起始值。值此屬性預設為 7.2 格。

此屬性只在 StarterPlayer.CharacterUseJumpPower 設為 false 時可見,因為它不相關。

這個屬性只適用於未來生成的角色,因此變更它不會改變任何現有角色。變更此屬性只會在玩家重生時生效。

CharacterJumpPower

平行讀取

CharacterJumpPower 決定玩家的 Humanoid.JumpPower 的起始值 。 值此屬性預設為 50 ,當應用到玩家的 Character 時 ,它將被限制在 0 和 1000 之間。

此屬性只在 StarterPlayer.CharacterUseJumpPower 設為 true 時可見,因為它不相關。

這個屬性只適用於未來生成的角色,因此變更它不會改變任何現有角色。變更此屬性只會在玩家重生時生效。

CharacterMaxSlopeAngle

平行讀取

CharacterMaxSlopeAngle 決定玩家的 Humanoid.MaxSlopeAngle 的起始值為 Character 。它預設為 89°,因此人類可以爬攀任何他們想要的斜坡,而不會受到任何限制。當應用於

這個屬性只適用於未來生成的角色,因此變更它不會改變任何現有角色。變更此屬性只會在玩家重生時生效。

CharacterUseJumpPower

平行讀取

CharacterUseJumpPower 決定玩家的 Humanoid.UseJumpPower 的起始值 。切換它會改變可視性的屬性: Character (否) 或 0> Class.Starter

這個屬性只適用於未來生成的角色,因此變更它不會改變任何現有角色。變更此屬性只會在玩家重生時生效。

CharacterWalkSpeed

平行讀取

CharacterWalkSpeed 決定玩家的 Humanoid.WalkSpeed 的起始值。 此屬性預設為 16。

這個屬性只適用於未來生成的角色,因此變更它不會改變任何現有角色。變更此屬性只會在玩家重生時生效。

DevCameraOcclusionMode

平行讀取

定義如何讓預設的攝影機指令處理對象之間的對象。適用於所有玩家,因為他們加入體驗,無法對個別玩家進行變更。

預設值是 Zoom (0)。 請參閱 Enum.DevCameraOcclusionMode 以取得可用模式清單。

DevComputerCameraMovementMode

平行讀取

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

平行讀取

DevComputerMovementMove 屬性讓開發人員在玩家上電腦時覆蓋玩家的移動模式。

這是玩家加入遊戲的預設屬性。它可以通過設置 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

平行讀取

DevTouchCameraMovementMode 屬性讓開發人員在玩家使用 touch 裝置時,可以覆蓋玩家的鏡頭模式,如果玩家在 touch 裝置上。

這是玩家加入遊戲的預設屬性。它可以通過設置 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

平行讀取

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

平行讀取

EnableMouseLockOption 屬性決定玩家是否可以自動切換滑鼠鎖定。

Mouse Lock 會將玩家的鼠標鎖定在屏幕中央。移動鼠標會使 CameraPlayer 相對於現有旋轉角度的攝影機機旋轉。

此屬性設定 Player.DevEnableMouseLock 的值。

注意,Shift-lock 相關 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

平行讀取

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

平行讀取

LoadCharacterAppearance 屬性設定是否載入玩家角色的外觀。

將此設定為 false 將結果在玩家沒有服裝 (包括帽子)、身體顏色、身體包或任何與玩家虛擬人偶外觀相關的其他內容。 預設值為 true

將此設置為 true 將會在玩家載入與玩家的 Player.CharacterAppearanceId 相應的外觀。

如果 Player:LoadCharacterWithHumanoidDescription() 使用,可以設定 StarterPlayer.LoadCharacterAppearance 為 false,因為玩家的虛擬人偶不需要所有資產 ID 來裝備,因此資產 ID 將在 HumanoidDescription 中傳回。

範例程式碼

Disabling a Player's Appearance

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

LoadCharacterLayeredClothing

未複製
無法建立指令碼
平行讀取

指示角色在體驗中是否有穿戴層級的服裝配件(Although Workspace.MeshPartHeadsAndAccessories 也需要在 Workspace 中啟用)。

LuaCharacterController

無法瀏覽
平行讀取

NameDisplayDistance

平行讀取

設置此玩家在其他 Humanoid 名稱時所能看到的距離。如果設置為 0,名稱將隱藏。

Class.StarterPlayer 屬性設定此玩家在看到其他 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

UserEmotesEnabled

平行讀取

這個屬性決定使用者擁有的表情符號在載入虛擬人偶時是否載入。將此屬性設置為 false 將無法載入。開發人員可以在 Studio 直接設置此屬性或通過 Game Settings 選單 設置。

停用表情載入時,表情 UI 仍會作為開發人員選擇使用表情功能所使用的時間,只要開發人員在遊戲中添加表情即可。

也參閱「虛擬人偶表情」,一文章詳細介紹如何控制、自訂和播放虛擬人偶表情。

方法

活動