StarterPlayer

AllowCustomAnimations 属性描述了网游戏上的自定义头像 Animations 的权限级别。

作为值，这个值不能在游戏中更改。它只能通过在网站的“游戏设置”页面中更改游戏的权限级别来更改。

此属性不是游戏中的使用。

AutoJumpEnabled 属性设置角色在移动设备上击中障碍时是否会自动跳跃。

这个属性是从 StarterPlayer 到 Player 加入游戏时复制的，然后。 在那之后，这个属性的值被复制到 Humanoid.AutoJumpEnabled 属性的角色的 1>Class.Humanoid1> 在生重生点时

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()

CameraMaxZoomDistance 属性设置了相机可以从角色中的最大距离，在默认相机上。

这个属性为每个加入游戏的玩家设置默认值 Player.CameraMaxZoomDistance 。如果该值设置为低于 StarterPlayer.CameraMinZoomDistance 的值，它将被提升到 CameraMinZoomDistance。

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75

CameraMinZoonDistance 属性设置了相机可以从角色中使用的最小距离。

这个属性为每个加入游戏的玩家设置默认值 Player.CameraMinZoomDistance 。如果此值设置为高于 StarterPlayer.CameraMaxZoomDistance 的值，它将被减少到 CameraMaxZoomDistance。

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75

为每个玩家在游戏中设置默认值 Player.CameraMode 。 Camera 有两个模式：

第一人称

在第一人称模式下，玩家的相机会将全部放大。除非有可见的 GUI 现象，否则，GuiButton.Modal 属性设置为 true ，鼠标将锁定，玩家的相机会随着鼠标移动而变为鼠标。

第三人称

在第三人称模式（默认）下，角色可以在相镜头中查看。 在 Roblox 的第三人称模式中：

• 您可以单击并拖动以旋转您的镜头，或使用屏幕右下角的箭头键。
• 当您移动鼠标时，您的相机不会改变（除非您将鼠标移动到屏幕端）。
• 当您按下任何箭头键时，用户的角色将面向在相应箭头键的方向面。
• 您可以放大和缩小。

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CameraMode = Enum.CameraMode.LockFirstPerson

CharacterJumpHeight 为玩家的 Humanoid.JumpHeight 设置了起始值。值默认为 7.2 格。

此属性仅在 StarterPlayer.CharacterUseJumpPower 设置为 false 时可见，因为它不会在其他情况下有重要性。

该属性仅适用于未来生成的角色，因此将不会更改任何现有玩家角色。该属性的更改只会在玩家重生时生效。

CharacterJumpPower 确定玩家的 Humanoid.JumpPower 的起始值为 50 ，当应用于玩家的 Character 时 ，该值默认为 50 ，当将其应用到玩家的 0> Class.Player.Character|Character0> 时 ，它将被限制在 0 和 1000

此属性仅在 StarterPlayer.CharacterUseJumpPower 设置为 true 时可见，因为它不会在其他情况下有重要性。

该属性仅适用于未来生成的角色，因此将不会更改任何现有玩家角色。该属性的更改只会在玩家重生时生效。

CharacterMaxSlopeAngle 确定玩家的 Humanoid.MaxSlopeAngle 的起始值为 89°，因此人类可以根据默认情况攀爬任何他们想要的斜坡。它默认为 89°，因此人类可以在默认情况下攀爬任何他们想要的�

该属性仅适用于未来生成的角色，因此将不会更改任何现有玩家角色。该属性的更改只会在玩家重生时生效。

CharacterUseJumpPower 确定玩家的 Humanoid.UseJumpPower 的起始值为 Character （真实值）或 0> Class.StarterPlayer.CharacterJumpPower0> (真实值)。

该属性仅适用于未来生成的角色，因此将不会更改任何现有玩家角色。该属性的更改只会在玩家重生时生效。

CharacterWalkSpeed 为玩家的 Humanoid.WalkSpeed 设置的起始值。 此属性默认为 16。

该属性仅适用于未来生成的角色，因此将不会更改任何现有玩家角色。该属性的更改只会在玩家重生时生效。

定义了默认的摄像头脚本在相机和相机主题之间处理对象的方式。 适用于所有玩家，无法对个人玩家进行更改。

默认值是 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

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 属性让开发者在玩家使用触摸设备时覆盖玩家的相机模式。

这是玩家加入游戏的默认属性。它可以通过设置 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)

EnableMouseLockOption 属性决定玩家是否可以默认地切换鼠标锁定。

鼠标锁定会将玩家的鼠标指针锁定在屏幕中心。 移动鼠标会旋转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 属性设置在这个玩家看到其他 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 为 false ，因为玩家的头像不需要所有资产 ID 来装备，因此在 HumanoidDescription 中的所有资产 ID 都会来自传过的 1> Class.Player:LoadCharacter1> 。

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CanLoadCharacterAppearance = false

指示角色在体验中是否会配备上衣（虽然 Workspace.MeshPartHeadsAndAccessories 也需要在 Workspace 中启用）。

设置此玩家将看到其他 Humanoid 名称的距离。如果设置为 0，名称将隐藏。

显示名称距离 StarterPlayer 属性设置此玩家在 Humanoid 名称的 Class.Name 的距离。如果设置为 0，名称将隐藏。此属性默认为 100 格。

要改变玩家加入游戏时显示距离的显示距离，您可以设置 Player.NameDisplayDistance 属性。

如果显示 Humanoid 名称，您可以使用 Humanoid.DisplayDistanceType 设置显示类型。

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0

此属性决定是否载入用户拥有的表情符号，当加载虚拟形象。将此属性设置为“关闭”会禁用加载。开发人员可以在 Studio 直接或通过“游戏设置菜单”设置这个属性。

当禁用表情加载时，表情 UI 仍然会工作，因为开发人员可以通过在游戏中添加表情来选择使用表情功能。

还请参阅虚拟形象表情，一篇文章详细介绍如何控制、自定义和播放虚拟形象表情。