StarterPlayer

显示已弃用

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

无法创建
服务

允许在 Player 对象中设置属性的默认值。当玩家进入服务器时,每个玩家对象的属性都设置为 StarterPlayer 中的相应属性的当前值。

此外,您可以将四个对象添加到此服务:

  • Class.StarterPlayerScripts 实例,拥有每个玩家都会运行的脚本。
  • Class.StarterCharacterScripts 实例,包含每次玩家重生点时添加到其角色的脚本。
  • 一个名为 Humanoid 的实例,该实例将用作每个玩家角色的默认人形。
  • 一个名为 Model 的实例,将作为所有玩家的角色模型使用。

概要

属性

属性

AllowCustomAnimations

隐藏
读取并联
Roblox 脚本安全性

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

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

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

AutoJumpEnabled

读取并联

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

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

代码示例

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 。 Camera 有两个模式:

第一人称

在第一人称模式下,玩家的相机会将全部放大。除非有可见的 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 时 ,该值默认为 50 ,当将其应用到玩家的 0> Class.Player.Character|Character0> 时 ,它将被限制在 0 和 1000

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

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

CharacterMaxSlopeAngle

读取并联

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

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

CharacterUseJumpPower

读取并联

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

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

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")
game.Players.PlayerAdded:Connect(function(player)
-- Set the player's movement mode on mobile devices to a dynamic thumbstick
player.DevComputerMovementMode = Enum.DevComputerMovementMode.DynamicThumbstick
end)

DevTouchCameraMovementMode

读取并联

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

读取并联

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 属性决定玩家是否可以默认地切换鼠标锁定。

鼠标锁定会将玩家的鼠标指针锁定在屏幕中心。 移动鼠标会旋转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 来装备,因此在 HumanoidDescription 中的所有资产 ID 都会来自传过的 1> Class.Player:LoadCharacter1> 。

代码示例

Disabling a Player's Appearance

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

LoadCharacterLayeredClothing

未复制
不可写入脚本
读取并联

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

LuaCharacterController

不可浏览
读取并联

NameDisplayDistance

读取并联

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

显示名称距离 StarterPlayer 属性设置此玩家在 Humanoid 名称的 Class.Name 的距离。如果设置为 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

读取并联

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

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

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

方法

活动