StarterPlayer

Hiển Thị Bản Đã Lỗi Thời

*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.

Không Thể Tạo
Dịch Vụ

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

Thuộc Tính

AllowCustomAnimations

Ẩn
Bảo Mật Kịch Bản Roblox
Đọc Song Song

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

Đọc Song Song

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ã

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

Không Sao Chép
Không Thể Viết Kịch Bản
Không Thể Duyệt
Đọc Song Song

CameraMaxZoomDistance

Đọc Song Song

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ã

Setting Camera Zoom Distance

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

CameraMinZoomDistance

Đọc Song Song

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ã

Setting Camera Zoom Distance

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

CameraMode

Đọc Song Song

Đặ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ã

Playing in First Person

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

CharacterJumpHeight

Đọc Song Song

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

Đọc Song Song

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

Đọc Song Song

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

Đọc Song Song

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

Đọc Song Song

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

Đọc Song Song

Đị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

Đọc Song Song

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ã

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

Đọc Song Song

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ã

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

Đọc Song Song

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ã

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

Đọc Song Song

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ã

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

Không Thể Viết Kịch Bản
Đọc Song Song

EnableMouseLockOption

Đọc Song Song

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 CameraPlayer để đ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ã

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

Đọc Song Song

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ã

Hiding Player Health and Names

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0

LoadCharacterAppearance

Đọc Song Song

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ã

Disabling a Player's Appearance

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

LoadCharacterLayeredClothing

Không Sao Chép
Không Thể Viết Kịch Bản
Đọc Song Song

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

Không Thể Duyệt
Đọc Song Song

NameDisplayDistance

Đọc Song Song

Đặ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ã

Hiding Player Health and Names

local Players = game:GetService("Players")
local player = Players.LocalPlayer
player.HealthDisplayDistance = 0
player.NameDisplayDistance = 0

UserEmotesEnabled

Đọc Song Song

Đặ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.

Phương Pháp

Sự Kiện