navigation

type Navigator interface {
	// FindPath computes a path from start to dest on the given map.
	FindPath(mapID uint32, start, dest Point3D) (*PathResult, error)

	// FindRandomPath finds a random walkable point near center.
	FindRandomPath(mapID uint32, center Point3D, radius float32) (*PathResult, error)

	// GetHeight returns the ground height (Z) at the given point using the pathfinding data (maps + baked vmaps).
	GetHeight(mapID uint32, x, y, z float32) (float32, bool)

	// GetTerrainHeight returns terrain-only height (no vmaps) if available.
	GetTerrainHeight(mapID uint32, x, y float32) (float32, bool)

	// Close releases resources.
	Close()
}

type PathResult struct {
	Found  bool
	Points []Point3D
}

type Point3D struct {
	X, Y, Z float32
}