rojo/.cursor/rules/roblox/reference/engine/classes/PathfindingModifier.yaml
2026-02-02 12:08:47 -06:00

85 lines
2.7 KiB
YAML

# This file is automatically generated. Please don't edit it manually.
# To submit a bug report on the content, see
# https://devforum.roblox.com/c/bug-reports/documentation-issues/72
name: PathfindingModifier
type: class
memory_category: Instances
summary: |
Modifiers used to represent space that has a higher or lower cost to be
traversed when creating paths using the `Class.PathfindingService`.
description: |
Pathfinding modifiers can be used to represent space that has a higher or
lower cost to be traversed. When added as a child to a `Class.Part`, it takes
that Part's volume to annotate areas of the navmesh that are inside and on top
of it.
You can include pathfinding modifiers in the
`Class.PathfindingService:CreatePath()` parameters and compute smarter paths
across various materials or around defined regions.
Note that when adding a `Class.PathfindingModifier` to a part, **either**:
- The part is `Class.BasePart.CanCollide|collidable` and we are interested in
modifying pathfinding costs of paths on top of this part, which we call
**area**.
- The part is `Class.BasePart.CanCollide|non-collidable` (and usually
invisible in game) and we are interested in modifying pathfinding costs of
paths inside the part, which we call **volume**.
code_samples: []
inherits:
- Instance
descendants: []
tags: []
deprecation_message: ''
properties:
- name: PathfindingModifier.Label
summary: |
The name of the navigation area inside or on top of the `Class.Part`
volume.
description: |
The name of the navigation area inside or on top of the `Class.Part`
volume.
For a more detailed overview of `Class.PathfindingService` and
`Class.PathfindingModifier`, see
[Character Pathfinding](../../../characters/pathfinding.md).
code_samples: []
type: string
tags: []
deprecation_message: ''
security:
read: None
write: None
thread_safety: ReadSafe
category: Data
serialization:
can_load: true
can_save: true
capabilities:
- Basic
- name: PathfindingModifier.PassThrough
summary: |
Determines if the parts enclosed by the modifier are traversable, even if
they would normally be collided with.
description: |
Determines if the parts enclosed by the modifier are traversable, even if
they would normally be collided with. See
[Character Pathfinding](../../../characters/pathfinding.md) for details.
code_samples: []
type: boolean
tags: []
deprecation_message: ''
security:
read: None
write: None
thread_safety: ReadSafe
category: Data
serialization:
can_load: true
can_save: true
capabilities:
- Basic
methods: []
events: []
callbacks: []