Humanoid

AutoJumpEnabled đặt xem có hay không có Humanoid sẽ cố gắng tự động nhảy qua chướng ngại vật mà nó đang đi tới.

Hiện tại, tính năng này chỉ hoạt động khi các điều kiện sau đây là đúng:

• Mô hình nhân vật của Humanoid là Player.Character của một Player .
• Người chơi trong câu hỏi đang sử dụng điều khiển cảm ứng.

Khi nhân vật của một người chơi xuất hiện, giá trị của thuộc tính phù hợp với thuộc tính Player.AutoJumpEnabled của người chơi - mà lại phù hợp với thuộc tính StarterPlayer.AutoJumpEnabled .

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

Tính năng AutoRotate mô tả xem Humanoid có tự động quay theo hướng mà họ đang di chuyển hay không.Khi được đặt thành true, mô hình nhân vật sẽ dần dần quay về hướng di chuyển của họ khi Nhân Bản đi dạo xung quanh.Khi được đặt thành false, mô hình nhân vật sẽ vẫn cố định trong vòng xoay hiện tại, trừ khi một lực xoay được áp dụng cho HumanoidRootPart.

Nếu mô hình nhân vật là nhân vật của một người chơi, thì hành vi của sự xoay của Humanoid bị ảnh hưởng bởi thuộc tính RotateType của UserGameSetting.

Khi tính năng AutoRotate được đặt thành true, tính năng RotateType có các hiệu ứng sau trên sự xoay của Humanoid:

<th>Hành vi</th>

    <th>Bối cảnh</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>Di chuyểnRelative</td>

    <td />

    <td />
  </tr>

  <tr>
    <td>Máy ảnhRelative</td>

    <td>Nhân vật sẽ xoay để hướng về phía máy ảnh.</td>

    <td>Người chơi có máy ảnh được phóng to vào người thứ nhất, hoặc họ đang ở trong chế độ khóa ca.</td>
  </tr>
</tbody>

local button = script.Parent
local enabled = true

local ON_COLOR = BrickColor.Green()
local OFF_COLOR = BrickColor.Red()

local function touchButton(humanoid)
	if enabled then
		enabled = false
		button.BrickColor = OFF_COLOR

		if humanoid.AutoRotate then
			print(humanoid:GetFullName() .. " can no longer auto-rotate!")
			humanoid.AutoRotate = false
		else
			print(humanoid:GetFullName() .. " can now auto-rotate!")
			humanoid.AutoRotate = true
		end

		task.wait(1)
		button.BrickColor = ON_COLOR
		enabled = true
	end
end

local function onTouched(hit)
	local char = hit:FindFirstAncestorWhichIsA("Model")
	if char then
		local humanoid = char:FindFirstChildOfClass("Humanoid")
		if humanoid then
			touchButton(humanoid)
		end
	end
end

button.Touched:Connect(onTouched)
button.BrickColor = ON_COLOR

Humanoid có sáu giá trị thước con bao gồm BodyDepthScale , BodyHeightScale , BodyProportionScale , BodyTypeScale , BodyWidthScale , HeadScale .Thay đổi giá trị của bất kỳ nguyên nhân nào cũng làm thay đổi các phần thân và phụ kiện của nhân vật, nhưng chỉ khi AutomaticScalingEnabled là đúng.

Xác định xem khớp của con người có bị phá vỡ khi ở trạng thái Enum.HumanoidStateType.Dead hay không. Mặc định là true.

Thuộc tính CameraOffset xác định một khoảng trừ bị cho vị trí chủ đề của camera khi Camera.CameraSubject được đặt thành Humanoid này.

Offset được áp dụng trong không gian đối tượng, so với hướng của Humanoid's HumanoidRootPart .Ví dụ, một giá trị offset Vector3(0, 10, 0) bù trừ giá trị camera của người chơi lên 10 đinh tán ở trên hình người chơi humanoid.

local RunService = game:GetService("RunService")

local playerModel = script.Parent
local humanoid = playerModel:WaitForChild("Humanoid")

local function updateBobbleEffect()
	local now = tick()
	if humanoid.MoveDirection.Magnitude > 0 then -- Is the character walking?
		local velocity = humanoid.RootPart.Velocity
		local bobble_X = math.cos(now * 9) / 5
		local bobble_Y = math.abs(math.sin(now * 12)) / 5

		local bobble = Vector3.new(bobble_X, bobble_Y, 0) * math.min(1, velocity.Magnitude / humanoid.WalkSpeed)
		humanoid.CameraOffset = humanoid.CameraOffset:lerp(bobble, 0.25)
	else
		-- Scale down the CameraOffset so that it shifts back to its regular position.
		humanoid.CameraOffset = humanoid.CameraOffset * 0.75
	end
end

RunService.RenderStepped:Connect(updateBobbleEffect)

Thuộc tính DisplayDistanceType kiểm soát hành vi khoảng cách của tên và sức khỏe của con người được hiển thị.Thuộc tính này được đặt bằng cách sử dụng enum Enum.HumanoidDisplayDistanceType với ba giá trị có sẵn, mỗi giá trị có bộ quy tắc riêng:

• Khi được đặt thành Viewer , con người nhìn thấy tên/sức khỏe của các con người khác trong phạm vi của chính nó NameDisplayDistance và HealthDisplayDistance .
• Khi được đặt thành , con người nhận kiểm soát hoàn toàn về tên và sức khỏe của mình thông qua các giá trị và của nó.
• Khi được đặt thành None, tên và thanh sức khỏe của con người không xuất hiện dưới bất kỳ hoàn cảnh nào.

Xem Tên nhân vật/Hiển thị sức khỏe để có một hướng dẫn chi tiết về việc kiểm soát sự xuất hiện của tên nhân vật và thanh sức khỏe.

local humanoid = script.Parent

humanoid.DisplayDistanceType = Enum.HumanoidDisplayDistanceType.Viewer
humanoid.HealthDisplayDistance = 0
humanoid.NameDisplayDistance = 100

DisplayName là một thuộc tính xác định tên hiển thị của Humanoid khi có thể nhìn thấy.Mặc định, một Humanoid mới sẽ có giá trị của một chuỗi trống.Nếu DisplayName là một chuỗi trống, hiển thị tên của humanoid sẽ mặc định cho tên của cha của humanoid.

Tải nhân vật người chơi

Khi người chơi tải nhân vật của họ, hoặc tự động hoặc thông qua việc sử dụng LoadCharacter() , Humanoid được tạo bởi động cơ sẽ có bộ thuộc tính DisplayName của nó được đặt cho tài sản của người chơi DisplayName.

Nhân vật khởi động và StarterHumanoid

Khi một Humanoid có tên StarterHumanoid được gán cho StarterPlayer , hoặc khi một Humanoid có mặt trong một Model có tên StarterCharacter , thuộc tính DisplayName sẽ được tôn trọng khi các Nhân vật được tải bởi Người chơi trong trò chơi.Động cơ sẽ chỉ thay thế tính chất DisplayName của Humanoid với tính chất DisplayName của người chơi nếu Humanoid.DisplayName của StarterHumanoid là một chuỗi trống.

Đây là một tính năng chỉ đọc mô tả Enum.Material đang đứng trên Humanoid hiện tại.Nó hoạt động với cả voxel thường Parts và Terrain voxel.

Ví dụ mã bên dưới cho thấy cách lắng nghe khi thuộc tính này thay đổi bằng cách sử dụng Object:GetPropertyChangedSignal() .Khi vật liệu mà hình người đang đứng thay đổi, nó sẽ in ra một thông điệp chỉ ra vật liệu mới đang được đứng trên.

local Humanoid = route.to.humanoid

Humanoid:GetPropertyChangedSignal("FloorMaterial"):Connect(function()
	print("New value for FloorMaterial: " .. tostring(Humanoid.FloorMaterial))
end)

Cảnh báo

• Khi Humanoid không đứng trên tầng, giá trị của thuộc tính này sẽ được đặt thành Không khí.

  • Điều này xảy ra vì các thuộc tính Enum không thể có giá trị trống.
  • Điều này có thể gây ra một số lẫn lộn nếu một phần có vật liệu được đặt thành Không Khí, mặc dù trong thực tế, các bộ phận không nên sử dụng vật liệu đó lúc đầu.
• Mô hình nhân vật của Humanoid phải có thể va chạm với sàn, nếu không sẽ không được phát hiện.

  • Bạn không thể kiểm tra xem Humanoid có bơi với thuộc tính này hay không. Bạn nên sử dụng chức năng Humanoid:GetState() của nó thay thế.

Thuộc tính này đại diện cho sức khỏe hiện tại của Humanoid .Giá trị bị giới hạn trong phạm vi từ 0 đến MaxHealth .Nếu hình người chết, thuộc tính này sẽ liên tục được đặt thành 0.

Lưu ý rằng chức năng TakeDamage() có thể được sử dụng để trừ từ Health thay vì đặt thuộc tính trực tiếp.

Hồi phục sức khỏe

Mặc định, một kịch bản hồi phục sức khỏe thụ động được tự động chèn vào humanoids.Điều này gây ra các nhân vật người chơi không chết tái sinh 1% của MaxHealth mỗi giây.Để vô hiệu hóa hành vi tái sinh này, thêm một hàng trống Script có tên là Sức khỏe vào StarterCharacterScripts .

Hiển thị thanh sức khỏe

Khi Health nhỏ hơn MaxHealth, thanh sức khỏe được hiển thị trong kinh nghiệm.Hành vi hiển thị của thanh sức khỏe phụ thuộc vào HealthDisplayDistance và HealthDisplayType.

Xem Tên nhân vật/Hiển thị sức khỏe để có một hướng dẫn chi tiết về việc kiểm soát sự xuất hiện của tên nhân vật và thanh sức khỏe.

Cái chết

Khi giá trị sức khỏe của nhân vật đạt 0, Humanoid tự động chuyển sang trạng thái Enum.HumanoidStateType.Dead.Trong trạng thái này, Health được khóa lại thành 0; tuy nhiên, không có lỗi hoặc cảnh báo nào để đặt Health của một con người nhân tạo chết thành một giá trị dương tích cực.

Thuộc tính này là một số được sử dụng cùng với thuộc tính DisplayDistanceType để kiểm soát khoảng cách từ đó thanh sức khỏe của một con người có thể được nhìn thấy.

Xem Tên nhân vật/Hiển thị sức khỏe để có một hướng dẫn chi tiết về việc kiểm soát sự xuất hiện của tên nhân vật và thanh sức khỏe.

Tính năng này kiểm soát khi thanh sức khỏe của một con người được phép hiển thị.Mặc định, thuộc tính này được đặt thành DisplayWhenDamaged , khiến thanh sức khỏe chỉ hiển thị khi humanoid của Health nhỏ hơn thanh MaxHealth của nó.Nó cũng có thể được đặt thành AlwaysOn , khiến thanh sức khỏe luôn hiển thị, hoặc AlwaysOff , ngăn chặn nó không bao giờ hiển thị.

Lưu ý rằng tính năng này hoạt động độc lập với tính năng HealthDisplayDistance của con người ở khoảng cách nhất định, có trách nhiệm làm cho thanh sức khỏe biến mất.Nếu Humanoid.HealthDisplayType|HealthDisplayType được đặt thành AlwaysOn , nó vẫn sẽ biến mất tùy thuộc vào cách HealthDisplayDistance được cấu hình.

Xem Tên nhân vật/Hiển thị sức khỏe để có một hướng dẫn chi tiết về việc kiểm soát sự xuất hiện của tên nhân vật và thanh sức khỏe.

Xác định khoảng cách (bằng đinh tán) khỏi mặt đất mà RootPart nên có khi con người đang đứng.The RigType ảnh hưởng đến cách thức mà thuộc tính này hoạt động.

Đối với các giàn R15, chiều cao eo phù hợp được đặt sẵn để đảm bảo chiều cao của RootPart là chính xác.Chiều cao của chân không được sử dụng.Chiều cao tổng thể của con người có thể được mô tả trong công thức sau:

Height = (0.5 * RootPart.Size.Y) + HipHeight

Đối với các giàn R6, HipHeight thay vào đó mô tả một độ mờ đối tượng tương đối. Chiều cao tổng thể của con người có thể được mô tả trong công thức sau:

Height = LeftLeg.Size.Y + (0.5 * RootPart.Size.Y) + HipHeight

Nếu true , Humanoid nhảy với lực lên tương đương với giá trị của Humanoid.JumpPower hoặc chiều cao của Humanoid.JumpHeight , tùy thuộc vào giá trị của Humanoid.UseJumpPower .

Cung cấp kiểm soát về chiều cao của một nhảy Humanoid , trong đinh tán.Giá trị khởi động của thuộc tính này được xác định bởi giá trị của StarterPlayer.CharacterJumpHeight mà mặc định là 7.2.

Mặc dù đặt thuộc tính này thành 0 sẽ hiệu quả ngăn chặn con người không nhảy, nhưng được khuyến khích vô hiệu hóa nhảy bằng cách vô hiệu hóa trạng thái Enum.HumanoidStateType.Jumping qua Humanoid:SetStateEnabled().

Thuộc tính này chỉ xuất hiện trong cửa sổ Tính năng nếu Humanoid.UseJumpPower được đặt thành giả mạo , bởi nó sẽ không liên quan nếu không (thay vào đó, Humanoid.JumpPower được sử dụng).

Xác định lượng lực lên bao nhiêu được áp dụng cho Humanoid khi nhảy.Giá trị khởi động của thuộc tính này được xác định bởi giá trị của StarterPlayer.CharacterJumpPower mà mặc định là 50 và bị giới hạn giữa 0 và 1000.Lưu ý rằng nhảy cũng bị ảnh hưởng bởi thuộc tính Workspace.Gravity định vị tốc độ gia tốc do trọng lực.

Mặc dù đặt thuộc tính này thành 0 sẽ hiệu quả ngăn chặn con người không nhảy, nhưng được khuyến khích vô hiệu hóa nhảy bằng cách vô hiệu hóa trạng thái Enum.HumanoidStateType.Jumping qua Humanoid:SetStateEnabled().

Thuộc tính này chỉ xuất hiện trong cửa sổ Tính năng nếu Humanoid.UseJumpPower được đặt thành đúng , bởi vì nó sẽ không liên quan nếu không (thay vào đó, Humanoid.JumpHeight được sử dụng).

Giá trị tối đa của một humanoid's Health .

Giá trị của thuộc tính này được sử dụng cùng với thuộc tính Health để thay đổi kích thước màn hình hiển thị sức khỏe mặc định.Khi thanh sức khỏe của một humanoid Health đạt đến MaxHealth, thanh sức khỏe có thể không được hiển thị, tùy thuộc vào thuộc tính HealthDisplayType của nó.

Tính chất này xác định góc độ dốc tối đa mà một humanoid có thể leo lên.Nếu góc của một dốc lớn hơn góc tối đa của một humanoid, chúng sẽ trượt xuống dốc.

Khi một nhân vật xuất hiện, thuộc tính này được đặt theo giá trị của StarterPlayer.CharacterMaxSlopeAngle .

Giá trị của thuộc tính này bị giới hạn ở các giá trị từ 0° đến 89°.Nó mặc định là 89°, vì vậy humanoids có thể leo lên hầu hết mọi dốc mà họ muốn theo mặc định.

local player = game.Players.LocalPlayer
local char = player.CharacterAdded:wait()
local h = char:FindFirstChild("Humanoid")

h.MaxSlopeAngle = 30

Hướng di chuyển là một tính năng chỉ đọc mô tả hướng mà Humanoid đang đi, như một vectơ đơn vị hoặc vectơ dài bằng không.Hướng được mô tả trong không gian thế giới.

Bởi vì thuộc tính này chỉ đọc, nó không thể được đặt bởi một Script hoặc LocalScript .

local RunService = game:GetService("RunService")

local playerModel = script.Parent
local humanoid = playerModel:WaitForChild("Humanoid")

local function updateBobbleEffect()
	local now = tick()
	if humanoid.MoveDirection.Magnitude > 0 then -- Is the character walking?
		local velocity = humanoid.RootPart.Velocity
		local bobble_X = math.cos(now * 9) / 5
		local bobble_Y = math.abs(math.sin(now * 12)) / 5

		local bobble = Vector3.new(bobble_X, bobble_Y, 0) * math.min(1, velocity.Magnitude / humanoid.WalkSpeed)
		humanoid.CameraOffset = humanoid.CameraOffset:lerp(bobble, 0.25)
	else
		-- Scale down the CameraOffset so that it shifts back to its regular position.
		humanoid.CameraOffset = humanoid.CameraOffset * 0.75
	end
end

RunService.RenderStepped:Connect(updateBobbleEffect)

Thuộc tính NameDisplayDistance là một số được sử dụng cùng với thuộc tính Humanoid.DisplayDistanceType để kiểm soát khoảng cách từ đó tên của một con người có thể được nhìn thấy.

Xem Tên nhân vật/Hiển thị sức khỏe để có một hướng dẫn chi tiết về việc kiểm soát sự xuất hiện của tên nhân vật và thanh sức khỏe.

Kiểm soát xem tên và thanh sức khỏe của một con người có thể được nhìn thấy phía sau các bức tường hoặc các đối tượng khác hay không.Thuộc tính này là một giá trị Enum.NameOcclusion và có thể được cấu hình để bỏ tất cả các tên, tên kẻ thù hoặc vô hiệu hóa việc bỏ hoàn toàn.

Trong trường hợp LocalPlayer không có Humanoid liên quan đến nó, tính chất này thay vào đó áp dụng cho chủ đề Humanoid .

Xem Tên nhân vật/Hiển thị sức khỏe để có một hướng dẫn chi tiết về việc kiểm soát sự xuất hiện của tên nhân vật và thanh sức khỏe.

local Players = game:GetService("Players")

local function onCharacterAdded(character)
	local humanoid = character:WaitForChild("Humanoid")
	humanoid.NamOcclusion = Enum.NameOcclusion.OccludeAll
end

local function onPlayerAdded(player)
	player.CharacterAdded:Connect(onCharacterAdded)
end

Players.PlayerAdded:Connect(onPlayerAdded)

Xác định xem Humanoid có đang ở trạng thái Enum.HumanoidStateType.PlatformStanding hay không.Khi đúng, Humanoid ở trong trạng thái mà nó đang rơi tự do và không thể di chuyển.Tình trạng này hành xử tương tự như ngồi, ngoại trừ việc nhảy không giải phóng humanoid khỏi trạng thái.

Cho phép các nhà phát triển vô hiệu hóa hành vi mà một người chơi Character|character chết nếu Cổ Motor6D bị xóa hoặc thoát kết nối ngay cả trong giây lát.Thuộc tính này mặc định thành true.

RigType mô tả xem có đang sử dụng Humanoid định dạng nhân vật di sản R6 hay không, hoặc định dạng nhân vật R15 mới hơn.

R6 giàn sử dụng 6 có thể nhìn thấy Parts trong khi R15 giàn sử dụng 15 có thể nhìn thấy Parts .Các giàn R15 có nhiều khớp hơn các giàn R6, làm cho chúng trở nên linh hoạt hơn nhiều khi được hoạt hình.

Lưu ý rằng nếu thuộc tính này được đặt sai, Humanoid sẽ không hoạt động đúng cách.Ví dụ, nếu R15 humanoid's RigType được đặt thành R6, Humanoid sẽ chết vì không có BasePart được gọi Torso được kết nối với một BasePart được gọi Đầu .

Một tham chiếu đến đối tượng HumanoidRootPart của con người, phần điều khiển rễ của Humanoid kiểm soát chuyển động của một con người thông qua thế giới 3D.Phần này thường vô hình.

Đối với các nhân vật R15, Model.PrimaryPart của mô hình Player.Character được đặt thành HumanoidRootPart .

Đối với các nhân vật R6, Model.PrimaryPart được đặt vào phần Head .

SeatPart là một tham chiếu đến chỗ ngồi mà một Humanoid hiện đang ngồi, nếu có.Giá trị của thuộc tính này có thể là một Seat , hoặc một VehicleSeat .Nó sẽ là nil nếu Humanoid hiện không đang ngồi trong một chỗ ngồi.

Ghi chú:

• Đối với một bool mô tả xem liệu Humanoid hiện đang ngồi hay không, xem Humanoid.Sit

Thuộc tính Sit là một boolean cho thấy liệu Humanoid có đang ngồi hay không.Humanoids có thể bị buộc vào trạng thái ngồi bằng cách đặt giá trị của thuộc tính này thành true.Nếu Humanoid không được gắn vào một chỗ ngồi trong trạng thái ngồi của nó, nó sẽ vấp ngã mà không va chạm vào chân của nó.Một Humanoid có thể thoát khỏi trạng thái ngồi bằng cách nhảy.

Ghi chú:

• The Seat hoặc VehicleSeat the Humanoid is sitting on can be obtained using the Humanoid.SeatPart property
• Bạn có thể phát hiện khi một Humanoid ngồi bằng cách kết nối với sự kiện Humanoid.Seated.

Không sử dụng Đặc tính này chỉ hoạt động với Chế độ Thử nghiệm được bật, đã bị ngừng hoàn toàn.

Thuộc tính này mô tả vị trí 3D trong không gian mà Player điều khiển Humanoid cuối cùng đã được nhấp với một Tool được trang bị.

Tính năng này chủ yếu được sử dụng bởi các công cụ cổ điển để xác định những gì một humanoid đang nhắm khi họ kích hoạt một công cụ.Nếu bạn cho một NPC một phóng tên lửa cổ điển, thiết lập Điểm mục tiêu của họ, và sau đó gọi chức năng Tool:Activate(), bạn có thể khiến NPC bắn tên lửa vào điểm mục tiêu.

Khi một nhân vật xuất hiện, thuộc tính này được đặt theo giá trị của StarterPlayer.CharacterUseJumpPower mà mặc định là true.

Khi nhảy, với giá trị này được đặt thành true, giá trị Humanoid.JumpHeight được sử dụng để đảm bảo nhảy humanoid lên đến độ cao đó.Với giá trị này được đặt thành false, giá trị Humanoid.JumpPower được sử dụng để áp dụng một lực lên.

Thuộc tính này mô tả tốc độ mà Humanoid có thể đi bộ, bằng đơn vị stud mỗi giây.Nó mặc định cho giá trị của StarterPlayer.CharacterWalkSpeed (16), có nghĩa là một nhân vật người chơi có thể di chuyển 16 đinh tán trong bất kỳ hướng nào mỗi giây.

Ghi chú

• Khi được kiểm soát trên thiết bị di động hoặc gamepad, một hình người có thể đi chậm hơn so với WalkSpeed nếu thanh điều khiển đang được di chuyển chỉ một độ dốc từ trung tâm.
• Bạn có thể đóng băng một humanoid tại chỗ bằng cách đặt WalkSpeed đến 0; điều này ngăn chặn người điều khiển di chuyển nó thông qua các cơ chế di chuyển mặc định.
• Tập lệnh hoạt hình mặc định thu nhỏ các hoạt hình di chuyển của con người dựa trên tốc độ di chuyển nhanh như thế nào so với tốc độ mặc định là 16 đinh tán/giây.
• Tốc độ mà Humanoid hiện đang đi bộ có thể được thu được bằng cách sử dụng sự kiện Running.

WalkToPart là một tham chiếu đến một phần mà Humanoid đang cố gắng tiếp cận.Thuộc tính này thường được đặt khi một phần được truyền là tham số thứ hai của chức năng Humanoid:MoveTo() của Humanoid.

Khi WalkToPart được đặt và một hình người đang cố gắng chạm đến phần, nó sẽ tiếp tục cập nhật mục tiêu Vector3 của nó để là vị trí của phần, cộng với Humanoid.WalkToPoint được dịch trong không gian đối tượng so với sự xoay của phần.

Nó có thể được mô tả trong Luau như:

goal = humanoid.WalkToPart.CFrame:pointToObjectSpace(humanoid.WalkToPoint)

Cảnh báo

• Đặt giá trị của WalkToPart không đủ để khiến một con người bắt đầu theo dõi một phần.
• Humanoid được yêu cầu bắt đầu cố gắng đạt được mục tiêu khi giá trị của WalkToPoint thay đổi.
• Điều này có thể thay đổi trong tương lai.
• Tình trạng tiếp cận mục tiêu của một con người sẽ hết hạn sau 8 giây nếu nó không đạt được mục tiêu của nó.
• Việc này được thực hiện để NPC không bị mắc kẹt chờ đợi Humanoid.MoveToFinished để bắn.
• Nếu bạn không muốn điều này xảy ra, bạn nên lặp lại lệnh MoveTo để thời gian chờ sẽ tiếp tục được thiết lập lại.

WalkToPoint mô tả vị trí 3D trong không gian mà một humanoid đang cố gắng đạt được, sau khi đã được yêu cầu làm như vậy bởi chức năng Humanoid:MoveTo() của Humanoid.

Nếu Humanoid.WalkToPart của một con người được cài đặt, mục tiêu được đặt bằng cách biến đổi WalkToPoint so với vị trí và độ xoay của các bộ phận.Nếu WalkToPart không được cài đặt, thì hình người sẽ cố gắng đến được vị trí 3D được chỉ định bởi WalkToPoint trực tiếp.

Cảnh báo

• Giá trị của WalkToPoint phải được thay đổi thành một giá trị khác để con người bắt đầu đi bộ tới nó.
• Nếu bạn muốn tạo một bước đi con người đến 0,0,0 , bạn nên sử dụng chức năng MoveTo của Humanoid.
• Điều này có thể thay đổi trong tương lai.
• Tình trạng tiếp cận mục tiêu của một con người sẽ hết hạn sau 8 giây nếu nó không đạt được mục tiêu của nó.
• Việc này được thực hiện để NPC không bị mắc kẹt chờ đợi Humanoid.MoveToFinished để bắn.
• Nếu bạn không muốn điều này xảy ra, bạn nên lặp lại lệnh MoveTo để thời gian chờ sẽ tiếp tục được thiết lập lại.

local function moveTo(humanoid, targetPoint, andThen)
	local targetReached = false

	-- listen for the humanoid reaching its target
	local connection
	connection = humanoid.MoveToFinished:Connect(function(reached)
		targetReached = true
		connection:Disconnect()
		connection = nil
		if andThen then
			andThen(reached)
		end
	end)

	-- start walking
	humanoid:MoveTo(targetPoint)

	-- execute on a new thread so as to not yield function
	task.spawn(function()
		while not targetReached do
			-- does the humanoid still exist?
			if not (humanoid and humanoid.Parent) then
				break
			end
			-- has the target changed?
			if humanoid.WalkToPoint ~= targetPoint then
				break
			end
			-- refresh the timeout
			humanoid:MoveTo(targetPoint)
			task.wait(6)
		end

		-- disconnect the connection if it is still connected
		if connection then
			connection:Disconnect()
			connection = nil
		end
	end)
end

local function andThen(reached)
	print((reached and "Destination reached!") or "Failed to reach destination!")
end

moveTo(script.Parent:WaitForChild("Humanoid"), Vector3.new(50, 0, 50), andThen)

Phương pháp này gắn Accessory được định cấu vào cha của humanoid.

Khi phương pháp này được gọi, một được gắn vào nhân vật bằng cách tìm kiếm một trong cha của con người có cùng tên với một trong tay cầm của phụ kiện có cùng tên với một ở đầu truy cập.Nếu một được tìm thấy, phần Xử lý sẽ được kết nối với cha của Attachment bằng một Weld , và hàn sẽ được cấu hình để Attachments chiếm cùng một không gian.

Nếu không thể tìm thấy Attachment yêu cầu, thì Accessory sẽ vẫn là cha của con người nhưng nó sẽ không được kết nối.

Thông thường, các liên kết phụ được tạo trên máy chủ, nhưng chúng có thể được tạo trên máy khách trong một số trường hợp.Trong những tình huống này, các cuộc gọi bên khách tới AddAccessory() có thể không phải lúc nào cũng sản xuất hành vi mong muốn và bạn có thể sử dụng BuildRigFromAttachments() để buộc sản phẩmhàn mong đợi.

Tham Số

Lợi Nhuận

local playerModel = script.Parent
local humanoid = playerModel:WaitForChild("Humanoid")

local clockworksShades = Instance.new("Accessory")
clockworksShades.Name = "ClockworksShades"

local handle = Instance.new("Part")
handle.Name = "Handle"
handle.Size = Vector3.new(1, 1.6, 1)
handle.Parent = clockworksShades

local faceFrontAttachment = Instance.new("Attachment")
faceFrontAttachment.Name = "FaceFrontAttachment"
faceFrontAttachment.Position = Vector3.new(0, -0.24, -0.45)
faceFrontAttachment.Parent = handle

local mesh = Instance.new("SpecialMesh")
mesh.Name = "Mesh"
mesh.Scale = Vector3.new(1, 1.3, 1)
mesh.MeshId = "rbxassetid://1577360"
mesh.TextureId = "rbxassetid://1577349"
mesh.Parent = handle

humanoid:AddAccessory(clockworksShades)

Phương pháp này tổng hợp một cây của Motor6D kết nối cho Humanoid . Motor6D kết nối là bắt buộc cho việc phát lại của Animations .

Bắt đầu từ humanoid's RootPart , phương pháp này thu thập tất cả Attachments cha có tên kết thúc bằng RigAttachment .Sau đó nó tìm kiếm một phần mở rộng phù hợp trong nhân vật có cùng tên với phần mở rộng.Sử dụng hai phụ kiện đó, một khớp Motor6D được tạo dựa trên các bộ phận liên quan đến hai phụ kiện và CFrame của các phụ kiện.

Humanoid:BuildRigFromAttachments() cũng thay đổi nhân vật và đặt màu cơ thể.

Lợi Nhuận

local function createJoint(jointName, att0, att1)
	local part0, part1 = att0.Parent, att1.Parent
	local newMotor = part1:FindFirstChild(jointName)

	if not (newMotor and newMotor:IsA("Motor6D")) then
		newMotor = Instance.new("Motor6D")
	end

	newMotor.Name = jointName

	newMotor.Part0 = part0
	newMotor.Part1 = part1

	newMotor.C0 = att0.CFrame
	newMotor.C1 = att1.CFrame

	newMotor.Parent = part1
end

local function buildJointsFromAttachments(part, characterParts)
	if not part then
		return
	end

	-- first, loop thru all of the part's children to find attachments
	for _, attachment in pairs(part:GetChildren()) do
		if attachment:IsA("Attachment") then
			-- only do joint build from "RigAttachments"
			local attachmentName = attachment.Name
			local findPos = attachmentName:find("RigAttachment")
			if findPos then
				-- also don't make double joints (there is the same named
				-- rigattachment under two parts)
				local jointName = attachmentName:sub(1, findPos - 1)
				if not part:FindFirstChild(jointName) then
					-- try to find other part with same rig attachment name
					for _, characterPart in pairs(characterParts) do
						if part ~= characterPart then
							local matchingAttachment = characterPart:FindFirstChild(attachmentName)
							if matchingAttachment and matchingAttachment:IsA("Attachment") then
								createJoint(jointName, attachment, matchingAttachment)
								buildJointsFromAttachments(characterPart, characterParts)
								break
							end
						end
					end
				end
			end
		end
	end
end

local function buildRigFromAttachments(humanoid)
	local rootPart = humanoid.RootPart
	assert(rootPart, "Humanoid has no HumanoidRootPart.")

	local characterParts = {}

	for _, descendant in ipairs(humanoid.Parent:GetDescendants()) do
		if descendant:IsA("BasePart") then
			table.insert(characterParts, descendant)
		end
	end

	buildJointsFromAttachments(rootPart, characterParts)
end

local humanoid = script.Parent:WaitForChild("Humanoid")

buildRigFromAttachments(humanoid)

local AssetService = game:GetService("AssetService")
local InsertService = game:GetService("InsertService")
local MarketplaceService = game:GetService("MarketplaceService")

local PACKAGE_ASSET_ID = 193700907 -- Circuit Breaker

local function addAttachment(part, name, position, orientation)
	local attachment = Instance.new("Attachment")
	attachment.Name = name
	attachment.Parent = part
	if position then
		attachment.Position = position
	end
	if orientation then
		attachment.Orientation = orientation
	end
	return attachment
end

local function createBaseCharacter()
	local character = Instance.new("Model")

	local humanoid = Instance.new("Humanoid")
	humanoid.Parent = character

	local rootPart = Instance.new("Part")
	rootPart.Name = "HumanoidRootPart"
	rootPart.Size = Vector3.new(2, 2, 1)
	rootPart.Transparency = 1
	rootPart.Parent = character
	addAttachment(rootPart, "RootRigAttachment")

	local head = Instance.new("Part")
	head.Name = "Head"
	head.Size = Vector3.new(2, 1, 1)
	head.Parent = character

	local headMesh = Instance.new("SpecialMesh")
	headMesh.Scale = Vector3.new(1.25, 1.25, 1.25)
	headMesh.MeshType = Enum.MeshType.Head
	headMesh.Parent = head

	local face = Instance.new("Decal")
	face.Name = "face"
	face.Texture = "rbxasset://textures/face.png"
	face.Parent = head

	addAttachment(head, "FaceCenterAttachment")
	addAttachment(head, "FaceFrontAttachment", Vector3.new(0, 0, -0.6))
	addAttachment(head, "HairAttachment", Vector3.new(0, 0.6, 0))
	addAttachment(head, "HatAttachment", Vector3.new(0, 0.6, 0))
	addAttachment(head, "NeckRigAttachment", Vector3.new(0, -0.5, 0))

	return character, humanoid
end

local function createR15Package(packageAssetId)
	local packageAssetInfo = MarketplaceService:GetProductInfo(packageAssetId)

	local character, humanoid = createBaseCharacter()
	character.Name = packageAssetInfo.Name

	local assetIds = AssetService:GetAssetIdsForPackage(packageAssetId)
	for _, assetId in pairs(assetIds) do
		local limb = InsertService:LoadAsset(assetId)
		local r15 = limb:FindFirstChild("R15")
		if r15 then
			for _, part in pairs(r15:GetChildren()) do
				part.Parent = character
			end
		else
			for _, child in pairs(limb:GetChildren()) do
				child.Parent = character
			end
		end
	end

	humanoid:BuildRigFromAttachments()
	return character
end

local r15Package = createR15Package(PACKAGE_ASSET_ID)
r15Package.Parent = workspace

Phương pháp này khiến Humanoid đi vào Enum.HumanoidStateType được cho, mô tả hoạt động mà Humanoid đang thực hiện.

Vui lòng xem trang Enum.HumanoidStateType để có thêm thông tin về các trạng thái cụ thể, vì một số có tên không trực quan.Ví dụ, Enum.HumanoidStateType.Running mô tả một trạng thái mà chân của con người ở trên mặt đất, bao gồm cả khi dừng lại.

Do hành vi mặc định của Humanoid, một số trạng thái sẽ tự động thay đổi khi được cài đặt. Ví dụ:

• Đặt trạng thái thành Enum.HumanoidStateType.Swimming khi con người không ở trong nước sẽ khiến nó được đặt tự động thành Enum.HumanoidStateType.GettingUp .
• Vì nó chưa được sử dụng, việc đặt trạng thái thành Enum.HumanoidStateType.PlatformStanding sẽ khiến trạng thái humanoid được tự động đặt thành Enum.HumanoidStateType.Running .

Lưu ý rằng để đặt trạng thái Humanoid bằng cách sử dụng phương pháp này, bạn phải làm như vậy từ một LocalScript và khách hàng phải có quyền sở hữu mạng của Player.Character .Ngoài ra, bạn có thể gọi phương thức này từ phía máy chủ Script , nhưng máy chủ phải có quyền sở hữu mạng của nhân vật người chơi.

Xem thêm Humanoid:SetStateEnabled() để bật hoặc tắt một trạng thái cụ thể, và Humanoid:GetState() để nhận trạng thái humanoid hiện tại.

Tham Số

Lợi Nhuận

local UserInputService = game:GetService("UserInputService")
local character = script.Parent

local humanoid = character:WaitForChild("Humanoid")

local doubleJumpEnabled = false

humanoid.StateChanged:Connect(function(_oldState, newState)
	if newState == Enum.HumanoidStateType.Jumping then
		if not doubleJumpEnabled then
			task.wait(0.2)
			if humanoid:GetState() == Enum.HumanoidStateType.Freefall then
				doubleJumpEnabled = true
			end
		end
	elseif newState == Enum.HumanoidStateType.Landed then
		doubleJumpEnabled = false
	end
end)

UserInputService.InputBegan:Connect(function(inputObject)
	if inputObject.KeyCode == Enum.KeyCode.Space then
		if doubleJumpEnabled then
			if humanoid:GetState() ~= Enum.HumanoidStateType.Jumping then
				humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
				task.spawn(function()
					doubleJumpEnabled = false
				end)
			end
		end
	end
end)

Phương pháp này làm cho Humanoid trang bị cho Tool được cung cấp.

Ví dụ dưới đây sẽ gây ra một Player để trang bị một công cụ trong Workspace có tên là 'Công cụ' .

local Players = game:GetService("Players")
local Workspace = game:GetService("Workspace")

local player = Players:FindFirstChildOfClass("Player")
if player and player.Character then
	local humanoid = player.Character:FindFirstChildWhichIsA("Humanoid")
	if humanoid then
		local tool = Workspace:FindFirstChild("Tool")
		if tool then
			humanoid:EquipTool(tool)
		end
	end
end

Khi phương pháp này được gọi, Humanoid sẽ đầu tiên tự động tháo tất cả Tools đã trang bị hiện tại.

Mặc dù chúng sẽ được trang bị, Tools đối với điều mà Tool.RequiresHandle là đúng sẽ không hoạt động nếu chúng không có tay cầm, bất kể phương pháp này có được sử dụng để trang bị chúng hay không.

Xem thêm:

• Để bỏ trang bị công cụ, sử dụng Humanoid:UnequipTools()

Tham Số

Lợi Nhuận

Phương pháp này trả về một mảng các đối tượng Accessory mà cha của hình học đang mặc hiện tại.Tất cả các đối tượng như vậy Accessory sẽ được bao gồm, bất kể chúng có được gắn kết hay không.

Nếu Humanoid không có đối tượng Accessory, một mảng trống sẽ được trả về.

Xem thêm Humanoid:AddAccessory() để gắn Accessory vào cha của một con người nhân tạo.

Lợi Nhuận

local Players = game:GetService("Players")

local function onPlayerAddedAsync(player)
	local connection = player.CharacterAppearanceLoaded:Connect(function(character)
		-- All accessories have loaded at this point
		local humanoid = character:FindFirstChildOfClass("Humanoid")
		local numAccessories = #humanoid:GetAccessories()
		print(("Destroying %d accessories for %s"):format(numAccessories, player.Name))
		humanoid:RemoveAccessories()
	end)

	-- Make sure we disconnect our connection to the player after they leave
	-- to allow the player to get garbage collected
	player.AncestryChanged:Wait()
	connection:Disconnect()
end

for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAddedAsync, player)
end
Players.PlayerAdded:Connect(onPlayerAddedAsync)

Phương pháp này trả về một bản sao của humanoid được lưu trữ HumanoidDescription mô tả ngoại hình hiện tại của nó.Nó có thể được sử dụng để nhanh chóng xác định diện mạo của một nhân vật và gán diện mạo của họ cho nhân vật khác bằng cách sử dụng phương pháp Humanoid:ApplyDescription().

Xem thêm

• Players:GetHumanoidDescriptionFromUserId() mà trả về một HumanoidDescription mô tả avatar cho người dùng đã được truyền đến.
• Players:GetHumanoidDescriptionFromOutfitId() mà trả về một HumanoidDescription có các tham số được khởi tạo để phù hợp với tham số của tài sản trang phục được chuyển đến bên máy chủ
• Player:LoadCharacterWithHumanoidDescription() mà tạo ra một người chơi với cái nhìn từ đã truyền đến HumanoidDescription .

Lợi Nhuận

Phương pháp này trả về những gì Enum.BodyPartR15 một Part là, hoặc Enum.BodyPartR15.Unknown nếu phần không phải là một phần thân R15.Phương pháp này cho phép các nhà phát triển lấy lại các phần cơ thể người độc lập với tên phần cơ thể thực tế, thay vì trả về một enum.

Nó có thể được sử dụng kết hợp với Humanoid:ReplaceBodyPartR15() .Ví dụ, nếu phần cơ thể của một người chơichạm vào thứ gì đó, chức năng này sẽ trả về một ví ví dụ / trường hợpphần.Sau đó, các nhà phát triển có thể tìm kiếm phần nào của cơ thể đã, như đầu hoặc tay.Sau đó tùy thuộc vào phần đó là gì, các nhà phát triển có thể thực hiện một số hành động chơi game hoặc thay thế phần đó bằng một phần khác - có thể hiển thị sát thương.

Phương pháp này có thể hữu ích cho các trò chơi mà vị trí bị trúng là quan trọng.Ví dụ, nó có thể được sử dụng để xác định xem một người chơi có bị đánh vào chân hay không và sau đó chậm lại dựa trên chấn thương.

Tham Số

Lợi Nhuận

Phương pháp này trả về enum Enum.Limb được liên kết với Part được cung cấp. Nó hoạt động cho cả R15 và R6 giàn, ví dụ:

-- Dành cho R15
print(humanoid:GetLimb(character.LeftUpperLeg))  -- Enum.Limb.LeftLeg Định nghĩa
print(humanoid:GetLimb(character.LeftLowerLeg))  -- Enum.Limb.LeftLeg Định nghĩa
print(humanoid:GetLimb(character.LeftFoot))  -- Enum.Limb.LeftLeg Định nghĩa

-- Dành cho R6
print(humanoid:GetLimb(character:FindFirstChild("Left Leg")))  -- Enum.Limb.LeftLeg

Lưu ý rằng Humanoid:GetLimb() sẽ ném một lỗi nếu cha của phần không được đặt thành cha của humanoid.

Tham Số

Lợi Nhuận

local Players = game:GetService("Players")

local player = Players.LocalPlayer
local character = player.Character or player.CharacterAdded:Wait()
local humanoid = character:WaitForChild("Humanoid")

for _, child in pairs(character:GetChildren()) do
	local limb = humanoid:GetLimb(child)
	if limb ~= Enum.Limb.Unknown then
		print(child.Name .. " is part of limb " .. limb.Name)
	end
end

Lợi Nhuận

Phương pháp này trả về Enum.HumanoidStateType, mô tả hoạt động mà Humanoid đang thực hiện, chẳng hạn như nhảy hoặc bơi.

Xem thêm Humanoid:SetStateEnabled() để bật hoặc tắt một trạng thái cụ thể, và Humanoid:ChangeState() để thay đổi trạng thái humanoid hiện tại.

Lợi Nhuận

local UserInputService = game:GetService("UserInputService")
local character = script.Parent

local humanoid = character:WaitForChild("Humanoid")

local doubleJumpEnabled = false

humanoid.StateChanged:Connect(function(_oldState, newState)
	if newState == Enum.HumanoidStateType.Jumping then
		if not doubleJumpEnabled then
			task.wait(0.2)
			if humanoid:GetState() == Enum.HumanoidStateType.Freefall then
				doubleJumpEnabled = true
			end
		end
	elseif newState == Enum.HumanoidStateType.Landed then
		doubleJumpEnabled = false
	end
end)

UserInputService.InputBegan:Connect(function(inputObject)
	if inputObject.KeyCode == Enum.KeyCode.Space then
		if doubleJumpEnabled then
			if humanoid:GetState() ~= Enum.HumanoidStateType.Jumping then
				humanoid:ChangeState(Enum.HumanoidStateType.Jumping)
				task.spawn(function()
					doubleJumpEnabled = false
				end)
			end
		end
	end
end)

Phương pháp GetStateEnabled trả về xem có được bật kích hoạt Enum.HumanoidStateType cho Humanoid hay không.

Tình trạng humanoid mô tả hoạt động mà humanoid đang thực hiện hiện tại.

Khi một cụ thể Enum.HumanoidStateType bị vô hiệu hóa, con người không bao giờ có thể vào trạng thái đó.Điều này đúng ngay cả khi nỗ lực thay đổi trạng thái được thực hiện bằng cách sử dụng Humanoid:ChangeState() hoặc mã con người nội bộ của Roblox.

Xem thêm:

• Đối với một sự kiện bắt lửa khi tình trạng humanoid được bật hoặc tắt xem Humanoid.StateEnabledChanged
• Để bật hoặc tắt một trạng thái Humanoid sử dụng Humanoid:SetStateEnabled()

Tham Số

Lợi Nhuận

local humanoid = script.Parent:WaitForChild("Humanoid")

-- Set state
humanoid:SetStateEnabled(Enum.HumanoidStateType.Jumping, false)

-- Get state
print(humanoid:GetStateEnabled(Enum.HumanoidStateType.Jumping)) -- false

Phương pháp này khiến Humanoid đi bộ theo hướng Vector3 đã cho.

Mặc định, hướng là bằng tiền thế điều khoản, nhưng nếu tham số relativeToCamera là true, hướng là tương đối với CFrame của CurrentCamera .Vì hướng tiêu cực Z bị xem là "theo chiều từ trên xuống" trong Roblox, mã sau đây sẽ làm cho con người di chuyển theo hướng của CurrentCamera .

humanoid:Move(Vector3.new(0, 0, -1), true)

Khi phương pháp này được gọi, Humanoid sẽ di chuyển cho đến khi phương pháp được gọi lại.Tuy nhiên, phương pháp này sẽ bị thay thế trong khung tiếp theo bởi kịch bản điều khiển nhân vật mặc định của Roblox.Điều này có thể tránh được bằng cách gọi chức năng này mỗi khung bằng cách sử dụng RunService:BindToRenderStep() (xem ví dụ), hoặc viết lại các kịch bản điều khiển trong StarterPlayerScripts .

Phương pháp này có thể được gọi trên máy chủ, nhưng việc này chỉ nên được thực hiện khi máy chủ có sở hữu mạng của tập hợp humanoid.

Xem thêm Humanoid:MoveTo() which makes a Humanoid walk to a point, và Player:Move() which effectively calls this function.

Tham Số

Lợi Nhuận

local RunService = game:GetService("RunService")
local Players = game:GetService("Players")

local player = Players.LocalPlayer

RunService:BindToRenderStep("move", Enum.RenderPriority.Character.Value + 1, function()
	if player.Character then
		local humanoid = player.Character:FindFirstChild("Humanoid")
		if humanoid then
			humanoid:Move(Vector3.new(0, 0, -1), true)
		end
	end
end)

Phương pháp này khiến Humanoid đi đến vị trí đã cho bằng cách thiết lập các thuộc tính Humanoid.WalkToPoint và Humanoid.WalkToPart.

Các tham số vị trí và phần tương ứng với những gì Humanoid.WalkToPoint và Humanoid.WalkToPart sẽ được đặt.

Nếu tham số phần được xác định, Humanoid vẫn sẽ cố gắng đi đến điểm.Tuy nhiên, nếu phần di chuyển thì điểm Humanoid đang đi sẽ di chuyển đến vị trí tương tự so với phần .Nếu tham số phần không được xác định, vị trí mà Humanoid đang đi sẽ không thay đổi.

Tình trạng tiếp cận mục tiêu của một con người sẽ hết hạn sau 8 giây nếu nó không đạt được mục tiêu của nó.Việc này được thực hiện để NPC không bị mắc kẹt chờ đợi Humanoid.MoveToFinished để bắn.Nếu bạn không muốn điều này xảy ra, bạn nên lặp lại lệnh MoveTo để thời gian chờ sẽ tiếp tục được thiết lập lại.

MoveTo() kết thúc nếu bất kỳ điều kiện sau đây áp dụng:

• Nhân vật đến điểm đến của nó.

• Nhân vật bị kẹt và hẹn giờ tám giây hết hạn.

• Giá trị của Humanoid.WalkToPoint hoặc Humanoid.WalkToPart thay đổi.

• Một kịch bản gọi Humanoid:Move() với một tham số mới moveDirection.

• Một kịch bản thay đổi tính chất CFrame của RootPart .

Tham Số

Lợi Nhuận

local function moveTo(humanoid, targetPoint, andThen)
	local targetReached = false

	-- listen for the humanoid reaching its target
	local connection
	connection = humanoid.MoveToFinished:Connect(function(reached)
		targetReached = true
		connection:Disconnect()
		connection = nil
		if andThen then
			andThen(reached)
		end
	end)

	-- start walking
	humanoid:MoveTo(targetPoint)

	-- execute on a new thread so as to not yield function
	task.spawn(function()
		while not targetReached do
			-- does the humanoid still exist?
			if not (humanoid and humanoid.Parent) then
				break
			end
			-- has the target changed?
			if humanoid.WalkToPoint ~= targetPoint then
				break
			end
			-- refresh the timeout
			humanoid:MoveTo(targetPoint)
			task.wait(6)
		end

		-- disconnect the connection if it is still connected
		if connection then
			connection:Disconnect()
			connection = nil
		end
	end)
end

local function andThen(reached)
	print((reached and "Destination reached!") or "Failed to reach destination!")
end

moveTo(script.Parent:WaitForChild("Humanoid"), Vector3.new(50, 0, 50), andThen)

Phương pháp này loại bỏ tất cả các Accessory đối tượng được mặc bởi cha của hình học con người. Đối với người chơi Characters, điều này sẽ loại bỏ tất cả các mũ và phụ kiện khác.

Phương pháp này xóa đối tượng Accessory bằng cách gọi Instance:Destroy() trên chúng, có nghĩa là Parent của các phụ kiện được đặt thành nil và bị khóa.

Xem thêm Humanoid:AddAccessory() để gắn Accessory , và Humanoid:GetAccessories() để lấy tất cả các Accessory đối tượng thuộc về một Humanoid .

Lợi Nhuận

local Players = game:GetService("Players")

local function onPlayerAddedAsync(player)
	local connection = player.CharacterAppearanceLoaded:Connect(function(character)
		-- All accessories have loaded at this point
		local humanoid = character:FindFirstChildOfClass("Humanoid")
		local numAccessories = #humanoid:GetAccessories()
		print(("Destroying %d accessories for %s"):format(numAccessories, player.Name))
		humanoid:RemoveAccessories()
	end)

	-- Make sure we disconnect our connection to the player after they leave
	-- to allow the player to get garbage collected
	player.AncestryChanged:Wait()
	connection:Disconnect()
end

for _, player in Players:GetPlayers() do
	task.spawn(onPlayerAddedAsync, player)
end
Players.PlayerAdded:Connect(onPlayerAddedAsync)

Thay thế một phần chi R15/Rthro năng động trong một Humanoid bằng một phần khác. Phần được tự động thay đổi theo cách bình thường.

Phương pháp này hữu ích để thay đổi nhân vật trong lúc chơi trò chơi hoặc xây dựng nhân vật từ một cấu hình cơ sở.Phương pháp liên quan GetBodyPartR15 có thể hữu ích khi sử dụng phương pháp này.

Tên của phần được truyền qua phải phù hợp với tên của BodyPartR15 Enum được truyền qua.

Tham Số

Lợi Nhuận

Phương pháp này xác định xem một được cho phép Enum.HumanoidStateType có bật cho Humanoid hay không.Khi một cụ thể Enum.HumanoidStateType bị vô hiệu hóa, Humanoid không bao giờ có thể vào trạng thái đó.Điều này là đúng ngay cả khi nỗ lực thay đổi trạng thái được thực hiện bằng cách sử dụng Humanoid:ChangeState() hoặc mã nội bộ Roblox Humanoid .

Lưu ý rằng sử dụng SetStateEnabled() trên máy chủ không sao chép thay đổi cho khách hàng, hoặc ngược lại.

Tham Số

Lợi Nhuận

local character = script.Parent

local JUMP_DEBOUNCE = 1

local humanoid = character:WaitForChild("Humanoid")

local isJumping = false
humanoid.StateChanged:Connect(function(_oldState, newState)
	if newState == Enum.HumanoidStateType.Jumping then
		if not isJumping then
			isJumping = true
			humanoid:SetStateEnabled(Enum.HumanoidStateType.Jumping, false)
		end
	elseif newState == Enum.HumanoidStateType.Landed then
		if isJumping then
			isJumping = false
			task.wait(JUMP_DEBOUNCE)
			humanoid:SetStateEnabled(Enum.HumanoidStateType.Jumping, true)
		end
	end
end)

Phương pháp này làm giảm Humanoid.Health của Humanoid bởi số tiền được cho ** nếu nó không được bảo vệ bởi một ForceField

Phương pháp này chấp nhận các giá trị âm cho tham số số tiền.Điều này sẽ tăng độ con người của humanoid Humanoid.Health .Tuy nhiên, điều này chỉ có hiệu lực nếu không có ForceField .

Làm thế nào ForceFields bảo vệ chống lại TakeDamage

Một Humanoid được coi là được bảo vệ bởi một ForceField nếu một ForceField đáp ứng một trong những tiêu chí sau:

• Các đối tượng ForceField chia sẻ cùng một Instance.Parent như đối tượng Humanoid
• The ForceField là cha của Humanoid.RootPart của Humanoid
• The ForceField là cha của một tổ tiên của Humanoid khác ngoài Workspace

Để gây sát thương cho một Humanoid không phụ thuộc vào bất kỳ ForceFields hiện tại, hãy đặt Humanoid.Health trực tiếp.

Để biết thêm thông tin về cách ForceFields bảo vệ Humanoids xem trang ForceField.

Tham Số

Lợi Nhuận

local Players = game:GetService("Players")

local player = Players.LocalPlayer
local character = player.Character or player.CharacterAdded:Wait()
local humanoid = character:WaitForChild("Humanoid")

humanoid:TakeDamage(99)