PathfindingService


<tbody>
  <tr>
    <td><b>代理範圍</b></td>
    <td>整數</td>
    <td>2</td>
    <td>確定空白空間所需的最小寬度，以便空白空間可以被視為可穿越。</td>
  </tr>

  <tr>
    <td><b>代理高度</b></td>
    <td>整數</td>
    <td>5</td>
    <td>確定空間可以被視為可穿越的最小垂直空間。</td>
  </tr>

  <tr>
    <td><b>AgentCanJump</b></td>
    <td>boolean</td>
    <td>真的</td>
    <td>決定是否允許在路徑導航中跳躍。</td>
  </tr>

  <tr>
    <td><b>AgentCanClimb</b></td>
    <td>boolean</td>
    <td>否</td>
    <td>決定是否允許在路徑找到期間攀爬 <code>Class.TrussPart|TrussParts</code>。</td>
  </tr>

  <tr>
    <td><b>方位空間乘數</b></td>
    <td>數字</td>
    <td>4</td>
    <td>決定路徑中間點之間的空間。</td>
  </tr>

  <tr>
    <td><b>花費</b></td>
    <td>表</td>
    <td></td>
    <td>材料欄或定義 <code>Class.PathfindingModifier|PathfindingModifiers</code> 和它們的 "cost" 對穿越。 有助於使代理對某些材料/區域比其他區域更喜歡。 請參閱  <a href="../../../characters/pathfinding.md#pathfinding-modifiers">這裡</a> 查看詳細資訊。</td>
  </tr>
</tbody>

鑰匙	類型	預設	說明

參數

agentParameters: Dictionary

可以微調路徑大小的 Lua 桌子 (會移動在路徑上的人形號)。請參閱上方以取得有效的鑰匙、類型和說明。

預設值："nil"

Path

一個 Path 對物件。

範例程式碼

Creating a Path with Pathfinding Service

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

-- This model contains a start, end and three paths between the player can walk on: Snow, Metal and LeafyGrass
local PathOptionsModel = script.Parent.PathOptions
local startPosition = PathOptionsModel.Start.Position
local finishPosition = PathOptionsModel.End.Position

-- Create a path that avoids Snow and Metal materials
-- This will ensure the path created avoids the Snow and Metal paths and guides
-- the user towards the LeafyGrass path
local path = PathfindingService:CreatePath({
	AgentRadius = 3,
	AgentHeight = 6,
	AgentCanJump = false,
	Costs = {
		Snow = math.huge,
		Metal = math.huge,
	},
})

-- Compute the path
local success, errorMessage = pcall(function()
	path:ComputeAsync(startPosition, finishPosition)
end)

-- Confirm the computation was successful
if success and path.Status == Enum.PathStatus.Success then
	-- For each waypoint, create a part to visualize the path
	for _, waypoint in path:GetWaypoints() do
		local part = Instance.new("Part")
		part.Position = waypoint.Position
		part.Size = Vector3.new(0.5, 0.5, 0.5)
		part.Color = Color3.new(1, 0, 1)
		part.Anchored = true
		part.CanCollide = false
		part.Parent = Workspace
	end
else
	print(`Path unable to be computed, error: {errorMessage}`)
end