概要
屬性
說明當前遊戲的許可等級,以及從網站的自訂虛擬人偶動畫。
設定角色在擊中移動設裝置上的障礙時是否會自動跳躍。
玩家的預設相機可以在範圍內移動。
玩家的預設視角距離允許在 stud 中縮放大。
將標準攝影機角的模式變更為第一人稱或第三人稱。
為 Humanoid.JumpHeight 設定起始值 Player.Character。
為 Humanoid.JumpPower 設定開始值 Player.Character。
為 Humanoid.MaxSlopeAngle 設定開始值 Player.Character。
決定 Humanoid.UseJumpPower 對 Player.Character 的起始狀態。
為 Humanoid.WalkSpeed 設定開始值 Player.Character。
設定攝影機和玩家之間的預設視角。
如果玩家使用電腦,就會覆蓋玩家的預設視角模式。
如果玩家在電腦上,讓開發者覆蓋玩家的移動模式。
如果玩家使用移動設裝置,讓開發人員覆蓋每個玩家的預設視角動作模式。
如果玩家使用觸摸設裝置,讓開發人員覆蓋玩家的移動模式。
決定玩家是否可以自動切換滑鼠鎖定。
設置此玩家在其他 Humanoid 生命值條時的距離。如果設置為 0,生命值條將不會顯示。
要載入玩家角色的外觀或不要載入。
指示角色在體驗中是否會配備層次的服裝配件。
設置此玩家在其他 Humanoid 名稱時所能看到的距離。如果設置為 0,名稱將隱藏。
決定是否載入使用者擁有的表情符號,載入虛擬人偶時。
屬性
AllowCustomAnimations
AllowCustomAnimations 屬性描述當前遊戲的許可等級,關於自訂虛擬人偶 Animations 從網站。
因此,此值無法在遊戲中變更。它只能通過變更遊戲的許可等級在網站的設定頁面來變更。
此屬性不適用於遊戲。
AutoJumpEnabled
AutoJumpEnabled 屬性設定角色在移動設裝置上擊中障礙時是否會自動跳躍。
這個屬性是從 StarterPlayer 複製到 Player 當他們加入遊戲時。 在那之後,這個屬性的值會被複製到 Humanoid.AutoJumpEnabled 角色的 1>Class.Humanoid</
範例程式碼
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。
範例程式碼
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75
CameraMinZoomDistance
CameraMinZoonDistance 屬性設定相機可以從角色中的最小距離。
這個屬性設定每個加入遊戲的玩家的預設值為 Player.CameraMinZoomDistance。如果此值設為高於 StarterPlayer.CameraMaxZoomDistance 的值,它將被減少至 CameraMaxZoomDistance。
範例程式碼
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75
CameraMode
為每個遊戲中的玩家設定預設值 Player.CameraMode 。 攝影機有兩種模式:
第一人稱
在第一人稱模式中,玩家的相機會將全方位盤入。除非有可見的 GUI 現象,否則會有 GuiButton.Modal 屬性設定為 true ,否則滑鼠將鎖定,使用者的相機將會跟隨滑鼠移動。
第三人稱
在第三人稱模式 (預設) 中,角色可以在攝影機中查看。在 Roblox 的第三人稱模式中:
- 您可以按一下滑鼠右鍵並拖曳以旋轉相攝影機,或使用箭頭鍵在屏幕右下角。
- 當您移動鼠滑鼠時,您的相機不會改變 (除非您將鼠標移動到畫面端)。
- 當您按下任何箭頭按鍵時,使用者的角色將會面向相應的箭頭按鍵的方向。
- 您可以自由放大和縮小。
範例程式碼
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。
此屬性對於不在電腦上的玩家沒有影響。
範例程式碼
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。讓開發人員覆蓋玩家在電腦上的移動模式,如果玩家在電腦上。
此屬性對於不在電腦上的玩家沒有影響。
範例程式碼
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。
此屬性對於不在移動設裝置上的玩家沒有影響。
範例程式碼
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。讓開發人員覆蓋玩家在觸摸設備上的移動模式,如果玩家在觸摸設裝置上。
這個屬性沒有影響未啟用觸摸設裝置的玩家。
範例程式碼
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 而不是鎖定鼠滑鼠。
範例程式碼
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 設定顯示類型。
範例程式碼
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 中傳回。
範例程式碼
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 設定顯示類型。
範例程式碼
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0
UserEmotesEnabled
這個屬性決定使用者擁有的表情符號在載入虛擬人偶時是否載入。將此屬性設置為 false 將無法載入。開發人員可以在 Studio 直接設置此屬性或通過 Game Settings 選單 設置。
停用表情載入時,表情 UI 仍會作為開發人員選擇使用表情功能所使用的時間,只要開發人員在遊戲中添加表情即可。
也參閱「虛擬人偶表情」,一文章詳細介紹如何控制、自訂和播放虛擬人偶表情。