StarterPlayer
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
Một dịch vụ cho phép các giá trị mặc định trong Player đối tượng để được cài đặt. Khi một người chơi vào máy chủ, mỗi giá trị của người chơi được đặt vào giá trị hiện tại của tương ứng tương ứng ứng ứng ứng ứng ứng ứng ứng ứng
Ngoài ra, bạn có thể thêm bốn đối tượng vào dịch vụ này:
- Một StarterPlayerScripts instance với các script chạy một lần cho mỗi người chơi.
- Một StarterCharacterScripts instance với các script để thêm vào mỗi người chơivật mỗi lần họ xuất hiện.
- Một Humanoid 实例名为 StarterHumanoid người chơimặt người mặt người mặt người mặt người mặt người mặt người mặt người mặt người mặt người mặt người mặt người mặt người mặt người mặt người mặt người mặt người mặt người mặt người mặt ngư
- Một Model 实例名为 StarterCharacter ,将作为角色模型 đối với tất cả người chơi.
Tóm Tắt
Thuộc Tính
Mô tả các cấp phép hiện tại của trò chơi liên quan đến hoạt họa avatar tùy chỉnh từ trang web.
Điều chỉnh xem dấu hiệu nào cho thấy nhân vật sẽ tự động nhảy khi đánh vào một vật cản trên thiết bị di động.
Khoảng cách tối đa mà mắt thấy của máy ảnh mặc định của người chơi được phép nhòm ra trong studs.
Khoảng cách tối thiểu trong studs máy ảnh mặc định của người chơi được phép zoom vào.
Đổi chế độ mặc định của máy ảnh thành người đầu tiên hoặc thứ ba.
Xác định giá trị khởi đầu của Humanoid.JumpHeight cho Player.Character .
Xác định giá trị khởi đầu của Humanoid.JumpPower cho Player.Character .
Xác định giá trị khởi đầu của Humanoid.MaxSlopeAngle cho Player.Character .
Xác định trạng thái khởi đầu của Humanoid.UseJumpPower cho Player.Character .
Xác định giá trị khởi đầu của Humanoid.WalkSpeed cho Player.Character .
Đặt cách màn hình mặc định camera điều khiển vật thể giữa máy ảnh và người chơi.
Hãy để nhà phát triển qua mặt camera mặc định cho mỗi người chơi nếu người đó đang ở trên máy tính.
Hãy để nhà phát triển quyết định chế độ di chuyển của người chơi nếu người chơi đang ở trên máy tính.
Hãy để nhà phát triển qua đổi chế độ di chuyển máy ảnh mặc định cho mỗi người chơi nếu người đó đang ở trên thiết bị di động.
Hãy để nhà phát triển quy định chế độ di chuyển của người chơi nếu người chơi đang ở trên thiết bị cảm ứng.
Xác định nếu một người chơi có thể bật/tắt khóa chuột mặc định.
Điều chỉnh khoảng cách mà mắt người chơi sẽ thấy các thanh sức khỏe Humanoid khác. Nếu được đặt để 0, các thanh sức khỏe sẽ không được hiển thị.
Dù nên tải nhân vật của một người chơi hay không.
Chỉ ra whether characters spawning into an experience will have layered clothing accessories equipped on them.
Đặt khoảng cách màn hình mà người chơi này sẽ thấy các tên Humanoid khác. Nếu đặt 0, tên được ẩn.
Xác định nếu các cảm xúc được sở hữu bởi người dùng được tải khi tải avatar.
Thuộc Tính
AllowCustomAnimations
Thuộc tính AllowCustomAnimations mô tả các cấp phép của trò chơi hiện tại liên quan đến avatar tùy chỉnh Animations từ trang web.
Như vậy, giá trị này không thể được thay đổi từ trong trò chơi. Nó chỉ có thể được thay đổi bằng cách thay đổi các cấp quyền trong trang cài đặt của trò chơi trên trang web.
Đặ性 này không được sử dụng trong trò chơi.
AutoJumpEnabled
Tính năng AutoJumpEnabled quy định có hay không có nhảy tự động khi đánh vào một vật cản trên một thiết bị di động.
Giá trị này được sao chép từ StarterPlayer đến một Player khi họ tham gia vào trò chơi. Sau đó, giá trị này được sao chép sang Class.H
Mẫu mã
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
Chỉ số CameraMaxZoomDistance thiết lập khoảng cách tối đa trong studs mà máy ảnh có thể từ nhân vật với các máy ảnh mặc định.
Điều này cài đặt giá trị mặc định của Player.CameraMaxZoomDistance cho mỗi người chơi tham gia trò chơi. Nếu giá trị này được cài đặt thấp hơn StarterPlayer.CameraMinZoomDistance nó sẽ được tăng lên CameraMinZoomDistance.
Mẫu mã
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75
CameraMinZoomDistance
Chỉ số CameraMinZoonDistance thiết lập khoảng cách tối thiểu trong studs mà máy ảnh có thể từ nhân vật với các máy ảnh mặc định.
Điều này cài đặt giá trị mặc định của Player.CameraMinZoomDistance cho mỗi người chơi tham gia trò chơi. Nếu giá trị này được cài đặt cao hơn giá trị StarterPlayer.CameraMaxZoomDistance nó sẽ được giảm xuống CameraMaxZoomDistance.
Mẫu mã
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMaxZoomDistance = 50
player.CameraMinZoomDistance = 75
CameraMode
Đặt giá trị mặc định cho Player.CameraMode cho mỗi người chơi trong trò chơi. Camera có hai chế độ:
góc nhìn thứ nhất
Trong chế độ người chơi, máy ảnh của người chơi được zoom toàn bộ cách. Trừ khi có một bộ hiển thị GUI có đặt tính bằng GuiButton.Modal , thì chuột sẽ bị khóa và máy ảnh của người chơi sẽ chuyển như máy ảnh di chuyển.
Góc nhìn thứ ba
Trong chế độ người chơi thứ ba (mặc định), nhân vật có thể được nhìn thấy trong máy ảnh. Trong khi ở chế độ người chơi thứ ba trên Roblox:
- Bạn có thể nhấp chuột phải và kéo để quay camera của bạn, hoặc sử dụng các nút mũi tên ở góc dưới bên phải của màn hình.
- Khi bạn di chuyển chuột của bạn, máy ảnh của bạn không thay đổi (ngoại trừ bạn di chuyển chuột đến cuối màn hình).
- Khi bạn nhấn bất kỳ phím mũi tên nào, nhân vật của người dùng sẽ đối diện với hướng của phím mũi chìa khóatương ứng.
- Bạn có thể thu nhỏ bằng cách thoải mái.
Mẫu mã
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CameraMode = Enum.CameraMode.LockFirstPerson
CharacterJumpHeight
CharacterJumpHeight xác định giá trị khởi đầu của Humanoid.JumpHeight cho một người chơi's Character . Giá trị của thuộc tính này mặc định là 7,2 studs.
Thuộc tính này chỉ xuất hiện trong các cửa sổ Thuộc tính nếu StarterPlayer.CharacterUseJumpPower được đặt thành false, vì nó sẽ không liên quan đến nhau nếu không.
Vì đặc tính này chỉ áp dụng cho những nhân vật được tạo ra trong tương lai, thay đổi nó sẽ không ảnh hưởng đến bất kỳ nhân vật nào hiện tại. Thay đổi này sẽ chỉ có hiệu lực khi một người chơi respawn.
CharacterJumpPower
CharacterJumpPower định giá trị khởi đầu của Humanoid.JumpPower cho một người chơi của Character . Giá trị của thuộc tính này mặc định là 50 và khi được áp dụng và
Thuộc tính này chỉ xuất hiện trong các cửa sổ Thuộc tính nếu StarterPlayer.CharacterUseJumpPower được đặt thành true, vì nó sẽ không liên quan đến nhau nếu không.
Vì đặc tính này chỉ áp dụng cho những nhân vật được tạo ra trong tương lai, thay đổi nó sẽ không ảnh hưởng đến bất kỳ nhân vật nào hiện tại. Thay đổi này sẽ chỉ có hiệu lực khi một người chơi respawn.
CharacterMaxSlopeAngle
CharacterMaxSlopeAngle xác định giá trị khởi đầu của Humanoid.MaxSlopeAngle cho một người chơi. Nó mặc định là 89°, vì vậy humanoids có thể leo qua hầu như bất kỳ dố
Vì đặc tính này chỉ áp dụng cho những nhân vật được tạo ra trong tương lai, thay đổi nó sẽ không ảnh hưởng đến bất kỳ nhân vật nào hiện tại. Thay đổi này sẽ chỉ có hiệu lực khi một người chơi respawn.
CharacterUseJumpPower
CharacterUseJumpPower xác định giá trị khởi đầu của Humanoid.UseJumpPower cho một người chơi's Character . Đổi nó sẽ thay
Vì đặc tính này chỉ áp dụng cho những nhân vật được tạo ra trong tương lai, thay đổi nó sẽ không ảnh hưởng đến bất kỳ nhân vật nào hiện tại. Thay đổi này sẽ chỉ có hiệu lực khi một người chơi respawn.
CharacterWalkSpeed
CharacterWalkSpeed xác định giá trị khởi đầu của Humanoid.WalkSpeed cho một người chơi's Character . Đặt tính này mặc định 16.
Vì đặc tính này chỉ áp dụng cho những nhân vật được tạo ra trong tương lai, thay đổi nó sẽ không ảnh hưởng đến bất kỳ nhân vật nào hiện tại. Thay đổi này sẽ chỉ có hiệu lực khi một người chơi respawn.
DevCameraOcclusionMode
Định nghĩa cách các脚本 máy ảnh mặc định xử lý các thống nhất giữa camera và chủ đề camera. Áp dụng cho tất cả người chơi khi tham gia trải nghiệm và không thể được thay đổi cho cá nhân người chơi.
Giá trị mặc định là Zoom (0). Xem Enum.DevCameraOcclusionMode để có được danh sách các chế độ có sẵn.
DevComputerCameraMovementMode
Thuộc tính DevComputerCameraMovementMode cho phép nhà phát triển quy định chế độ máy ảnh của người chơi nếu người chơi đang ở trên một máy tính.
Đây là mặt tùy chỉnh của người chơi tham gia trò chơi. Nó có thể được thay đổi cho các người chơi cụ thể bằng cách cài đặt Player.DevComputerCameraMode .
Nếu được cài đặt để UserChoice thì chế độ di chuyển máy ảnh của người chơi sẽ được xác định bởi bất kỳ thứ gì mà người chơi đã thiết lập trong cài đặt trò chơi. Ngược lại, nó sẽ được cài đặt dựa trên thuộc tính này.
Xem Enum.DevComputerCameraMovementMode để biết các chế độ máy ảnh khác nhau có sẵn.
Điều này không ảnh hưởng đến người chơi không ở trên máy tính.
Mẫu mã
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
Thuộc tính DevComputerMovementMove cho phép nhà phát triển quy định chế độ di chuyển của người chơi trên một máy tính nếu người chơi đang ở trên một máy tính.
Đây là mặt tài sản mặc định cho người chơi tham gia trò chơi. Nó có thể được thay đổi cho các người chơi cụ thể bằng cách cài đặt Player.DevComputerMovementMode .
Nếu được thiết lập để UserChoice thì chế độ di chuyển của người chơi sẽ được xác định bởi bất kỳ thứ gì mà người chơi đã thiết lập trong cài đặt trò chơi. Ngược lại, chế độ sẽ được thiết lập dựa trên giá trị này.
Xem Enum.DevComputerMovementMode cho các chế độ di chuyển khác nhau có sẵn. Hãy cho phép nhà phát triển viết đổi chế độ di chuyển của người chơi nếu người chơi đang ở trên một máy tính.
Điều này không ảnh hưởng đến người chơi không ở trên máy tính.
Mẫu mã
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
Thuộc tính DevTouchCameraMovementMode cho phép nhà phát triển quy định chế độ máy ảnh của người chơi trên thiết bị cảm ứng nếu người chơi đang ở trên thiết bị cảm ứng.
Đây là mặt tài sản mặc định cho người chơi tham gia trò chơi. Nó có thể được thay đổi cho các người chơi cụ thể bằng cách cài đặt Player.DevTouchCameraMode .
Nếu được cài đặt để UserChoice thì chế độ di chuyển máy ảnh của người chơi sẽ được xác định bởi bất kỳ thứ gì mà người chơi đã thiết lập trong cài đặt trò chơi. Ngược lại, nó sẽ được cài đặt dựa trên thuộc tính này.
Xem Enum.DevTouchCameraMovementMode để biết các chế độ máy ảnh khác nhau có sẵn.
Điều này không ảnh hưởng đến người chơi không ở trên thiết bị di động.
Mẫu mã
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
Thuộc tính DevTouchMovementMode cho phép nhà phát triển quy định chế độ di chuyển của người chơi trên thiết bị cảm ứng nếu người chơi đang ở trên thiết bị cảm ứng.
Đây là mặt tùy chỉnh của người chơi tham gia trò chơi. Nó có thể được thay đổi cho các người chơi cụ thể bằng cách cài đặt Player.DevTouchMovementMode .
Nếu được đặt UserChoice thì chế độ di chuyển của người chơi sẽ được xác định bởi bất kỳ thứ gì người chơi đặt trong cài đặt trò chơi. Nếu không, chế độ sẽ được xác định dựa trên thuộc tính này.
Xem Enum.DevTouchMovementMode cho các chế độ di chuyển khác nhau có sẵn. Hãy cho phép nhà phát triển viết đổi chế độ di chuyển của người người chơinếu người dùng đang ở trên một thiết bị cảm ứng.
Điều này không ảnh hưởng đến người chơi không ở trên thiết bị kích hoạt cảm ứng.
Mẫu mã
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
Thuộc tính EnableMouseLockOption xác định nếu một người chơi có thể bật/tắt tùy chọn khóa chuột bằng cách mặc định.
Mouselock sẽ khóa mũi tên của người chơi ở trung tâm của màn hình. Di chuyển chuột sẽ xoay Camera và Player để điều chỉnh vị trí quay của máy ảnh.
Điều này đặt giá trị của Player.DevEnableMouseLock .
Lưu ý rằng các API liên quan đến khóa thay đổi liên quan đến việc bị xóa sổ, vì vậy nên sử dụng UserInputService.MouseBehavior thay vì sử dụng chuột.
Mẫu mã
local Players = game:GetService("Players")
local player = Players.LocalPlayer
while true do
player.DevEnableMouseLock = not player.DevEnableMouseLock
task.wait(5)
end
HealthDisplayDistance
Cuộn dữ liệu HealthDisplayDistance lập mô hình khoảng cách trong studs mà người chơi này sẽ thấy các thanh sức khỏe Humanoid khác. Nếu được đặt để 0, các thanh sức khỏe sẽ không được hiển thị. Cấu hình này được đặt để 100
Để thay đổi khoảng cách hiển thị cho một người chơi một khi họ tham gia trò chơi, bạn có thể thiết lập Player.HealthDisplayDistance tính năng.
Nếu một dòng chữ Humanoid trên thanh sức khỏe là hiển thị, bạn có thể thiết lập kiểu hiển thị bằng cách sử dụng Humanoid.DisplayDistanceType .
Mẫu mã
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0
LoadCharacterAppearance
Thuộc tính LoadCharacterAppearance quyết định có nên tải xuống ngoại hình của một người chơivật hay không.
Đặt các cấu hình này để false kết quả trong người chơi không có quần áo (bao gồm mũ), màu thân hình, gói thân hình hoặc bất kỳ thứ gì liên quan đến ngoại hình của avatar người chơi. Bởi mặc định, cấu hình này được đặt để true .
Đặt các cấu hình này để true kết quả trong người chơi tải nhìn tương ứng với người chơi's Player.CharacterAppearanceId .
Nếu Player:LoadCharacterWithHumanoidDescription() được sử dụng, nó có thể là một lợi thế để thiết lập StarterPlayer.LoadCharacterAppearance để làm sao đó người chơi's avatar không cần thiết khi tất cả các ID tài sản để trang bị trên nhân vậ
Mẫu mã
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.CanLoadCharacterAppearance = false
LoadCharacterLayeredClothing
Chỉ ra có phải khi nhân vật được sinh ra vào một trải nghiệm sẽ có trang phục lớp áo được trang bị trên họ (mặc dù Workspace.MeshPartHeadsAndAccessories cũng cần được bật trên Workspace).
LuaCharacterController
NameDisplayDistance
Đặt khoảng cách màn hình mà người chơi này sẽ thấy các tên Humanoid khác. Nếu đặt 0, tên được ẩn.
The NameDisplayDistance StarterPlayer property sets the distance in studs at which this player will see other Humanoid names. If set to 0, names are hidden. This property is set to 100 studs by default.
Để thay đổi khoảng cách hiển thị cho một người chơi một khi họ tham gia trò chơi, bạn có thể thiết lập Player.NameDisplayDistance tính năng.
Nếu tên Humanoid được hiển thị, bạn có thể cài đặt kiểu hiển thị bằng cách sử dụng Humanoid.DisplayDistanceType .
Mẫu mã
local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0
UserEmotesEnabled
Đặt tính này xác định có phải emote sở hữu của người dùng được tải khi tải avatar. Đặt tính này để sai khiết tải. Các nhà phát triển có thể đặt tính này trong Studio trực tiếp hoặc qua menu Cài đặt trò chơi .
Khi tải trượt chuyển cảm xúc bị vô hiệu hóa, giao diện người dùng trượt chuyển cảm xúc vẫn sẽ hoạt động cho đến khi người dùng chọn sử dụng tính năng trượt chuyển cảm xúc bằng cách thêm trượt chuyển cảm xúc vào trò chơi của họ.
Xem thêm Avatar Emotes, một bài viết chi tiết cách điều khiển, tùy chỉnh và chơi avatar emotes.