[Home](./index.md) > [server](./server.md) > [PathfindingEntityController](./server.pathfindingentitycontroller.md) ## PathfindingEntityController class A pathfinding entity controller built on top of `SimpleEntityController`. When to use: obstacle-aware movement to a target coordinate. Do NOT use for: per-tick recalculation; pathfinding is synchronous and can be expensive. **Signature:** ```typescript export default class PathfindingEntityController extends SimpleEntityController ``` **Extends:** [SimpleEntityController](./server.simpleentitycontroller.md) ## Remarks Implements A\* pathfinding. Call `PathfindingEntityController.pathfind` sparingly; it is intended to be called once per destination in most cases.

Coordinate System & Model Orientation

HYTOPIA uses \*\*-Z as forward\*\*. Models must be authored with their front facing -Z. The controller automatically calls `face()` to orient the entity's -Z axis toward each waypoint. \*\*Category:\*\* Controllers ## Constructors

Constructor	Modifiers	Description
[(constructor)(options)](./server.pathfindingentitycontroller._constructor_.md)		Constructs a new instance of the `PathfindingEntityController` class

## Properties

Property	Modifiers	Type	Description
[debug](./server.pathfindingentitycontroller.debug.md)	`readonly`	boolean	Whether to enable debug mode.
[maxFall](./server.pathfindingentitycontroller.maxfall.md)	`readonly`	number	The maximum fall distance the entity can fall. \\Category:\\ Controllers
[maxJump](./server.pathfindingentitycontroller.maxjump.md)	`readonly`	number	The maximum jump distance the entity can jump. \\Category:\\ Controllers
[maxOpenSetIterations](./server.pathfindingentitycontroller.maxopensetiterations.md)	`readonly`	number	The maximum open set iterations before aborting pathfinding. \\Category:\\ Controllers
[speed](./server.pathfindingentitycontroller.speed.md)	`readonly`	number	The speed used for path movement. \\Category:\\ Controllers
[target](./server.pathfindingentitycontroller.target.md)	`readonly`	[Vector3Like](./server.vector3like.md) \\| undefined	The target coordinate being pathfound to. \\Category:\\ Controllers
[verticalPenalty](./server.pathfindingentitycontroller.verticalpenalty.md)	`readonly`	number	The vertical penalty used during pathfinding. \\Category:\\ Controllers
[waypointNextIndex](./server.pathfindingentitycontroller.waypointnextindex.md)	`readonly`	number	The index of the next waypoint being approached. \\Category:\\ Controllers
[waypoints](./server.pathfindingentitycontroller.waypoints.md)	`readonly`	[Vector3Like](./server.vector3like.md)\[\]	The current waypoints being followed. \\Category:\\ Controllers
[waypointTimeoutMs](./server.pathfindingentitycontroller.waypointtimeoutms.md)	`readonly`	number	The timeout in milliseconds for a waypoint to be considered reached. \\Category:\\ Controllers

## Methods

Method	Modifiers	Description
[pathfind(target, speed, options)](./server.pathfindingentitycontroller.pathfind.md)		Calculates a path and moves to the target if a path is found. Use for: one-shot navigation to a destination. Do NOT use for: high-frequency replanning; it is synchronous.