SimplePath - Pathfinding Module

SimplePath is an open-source pathfinding module that gives you the ability to quickly create a pathfinding script for humanoids and non-humanoids with just a few lines of code. Pathfinding is done using Roblox’s PathfindingService.

This module works by using a “repetitive” approach to pathfinding. The pathfinding agent moves a more efficient path when computed repetitively instead of just once. Part of the reason why is because computing the path once doesn’t guarantee that the agent reaches the goal as expected. Taking the repetitive approach accounts for any obstructions or obstacles blocking the path at the current time. This guarantees that the agent will reach its goal no matter what as long as it’s traversable within the scope of PathfindingService. Although you can still use SimplePath normally, it is strongly suggested that you take a repetitive approach to pathfinding as this was the primary concept kept in mind during the development of this module. However, in some scenarios, it might be better to compute the path just once. For example, if the agent does not interact with moving objects, you should consider changing the structure of your pathfinding code by reducing the number of repetitions between path computations to improve performance.

To get started with using SimplePath visit: Getting Started - SimplePath


AI stuttering Help
Pathfinding AI running back and forth HELP
Pathfinding on terrain
How to update pathfinding?
C stack overflow?
How to make npc follow player anywhere?!
How to script AI
How to fix npc moving to waypoint behind them?
NPC won't move for some reason
Best way of implementing pathfinding/AI for my purposes and where can I learn about how to do it?
Making Zombie gameplay better
Humanoid.MoveToFinished fires before humanoid reaches part
What should I add to my zombie defense game?
NextPath: Next gen script for Nextbots
Help with npc Ai
How do i fix this?
AI unable to catch up to player
Why is my npc move like that
Npc keeps jumping while following player
Choppy Humanoids: Target Position updating too quick for the server?
AI keeps moving towards goal even though it no longer exists? (Pathfinding, SimplePath)
Have an NPC stop walking when target is seen
Stop Npc moving to attack
NPC with Pathfinding service gets hung up on terrain
Non-humanoid Npc Pauses at Waypoint
(Legacy) SimplePath - Pathfinding Module
Fixing a script about pathfinding from YouTube. (help)
Help making enemy leader system
Alternatives to moving enemies in my tower defense game
How to make NPC's avoid obstacles (and themselves too)
Faster, smarter and more efficient AI pathfinding needed
SimplePath module: Trouble with cancelling a path
CFrame Math Problem
AI unable to catch up to player
Issues related to Custom AI Behavior
Project Delta Credits
Halo's Arena Update Post
How do i make something like this?
PathFindService will stuck in part
(Legacy) SimplePath - Pathfinding Module
My NPC isn't pathfinding how I want it to
(Legacy) SimplePath - Pathfinding Module
How do I stop NPCs from stacking onto other npcs heads?
NPC makes stops while chasing target
IA Path is dont work correctly
Looking for a way NPCS can constantly follow player AND avoid obstacles
Tide Rush Update Logs
Issue with Pathfinding service/nav mesh
How would you make pathfinding work with Collision Groups?
SimplePath Pathfinding Links
Roblox pathfinding can only compute path within limited range
Make Npc Pathfinding More smooth
Pathfinding causes massive lag
Smart NPC Chase
Pathfinding issue
Anything wrong with my NPC spawning script?
Ohio hide and seek credits
SimplePath module help
How can I make a follower AI not jittery
{SimplePath} NPC Pathfinding AI Breaks Randomly
Depth Spelunking Information
AI isn't moving but the jumpscare plays meaning the script runs with no errors
Whats the best way to do pathfinding chase?
SimplePath or Write my own?
Help with pathfinding script
PathfindingService is pretty garbage
Pathfinding has issues with elevation?
How would I CFrame a character to look towards a point
Pathfinding jittery/stuttering walk animation solution

nice pathfinding lol
this is cool


Update 1.01:

  • Fixed a velocity jump issue.
  • Added three new static methods (see API).

Nice module! You can create something like this with it lol


Update 1.02:

  • Fixed issues when rigs had HipHeight of 0.
  • Enabled the usage of Path:Stop() for non-humanoids. See API for more info.

I love the system. But for how I use it, when I stand on top of a part, the NPC is clueless on how to get to me.


i don’t think npc can jump or jump good


He jumps when he wants, I was on top of a truss and he didn’t know what to do.


The NPC cannot always reach you. It can only walk to your location if there is a clear pathway available for the NPC. Sometimes in rare cases, the path may not be generated even though it’s possible for the NPC to reach the goal. Unfortunately, this is one of the limitations associated with pathfinding service and in this case, there’s nothing I can do.


Im not sure if im doing something wrong but this character is jumping randomly i used path:run() and nothing else also i have no clue why the gyazo is so laggy


It still gives me an error that the hip height is zero. And i am moving a model.


When there is something blocking the path or if there is some kind of an interference, it gets detected by when the humanoid does not reach the next waypoint within the set amount of time. After the timeout, the RetryPath method is executed which assumes that there’s something blocking the path so this is why the humanoid jumps and due to the way the script works, the humanoid more or lese doesn’t move while in the air so there’s a velocity applied to it. I’m aware that .Velocity is depreciated and I plan to update the module soon.


It doesn’t support truss climbing
(it just stops at bottom)

Also some others bugs


This uses the Roblox pathfinding system (as any other pathfinding module does). If the Roblox pathfinding system doesn’t support climbing (I doubt it does) then it would require a whole rework of the module to make that possible, if there are any other stable pathfinding methods out there.

1 Like

I suggest creating a state property so we can check it with an if statement. While I was making my own NPC with your system, I found it would be helpful to check the status and change it to what I want if it isn’t already. Example:
if path.Status == "Running" then path:Stop() end
or the opposite


That’s a very good idea. I will make sure to implement it in the upcoming update. Thank you for the suggestion.

I built a controller like this awhile ago for a friend, but I noticed that when doing obstacle courses that the pathfinder wasn’t finding paths / creating jump links, avoiding dangerous objects, respecting timed events, or able to provide advanced maneuvering like walking sideways. Sometimes it couldn’t even jump on pillars because it would return waypoints in the opposite direction before a jump.

These issues are impossible to fix in a controller like this, so I’m working on a new pathfinder. I’ll likely build on and submit PR for this controller and use that.

If anyone is interested in contributing to the list of do’s and don’ts for the new pathfinder, I’m building a community to discuss those issues. Here is a discord invite:


How do I make it so the npc’s animations will activate when walking.

1 Like

You can download the provided example which includes a dummy with animations.

Edit: If using the example above, make sure to use the latest version of SimplePath.

I’m running into behavior with this module. Here’s how I run it.

         if ClosestObject then
			local Combat_NpcStates = CharacterModel:WaitForChild("Combat_NpcStates")
			--[Trigger States]
			local TriggerStates = Combat_NpcStates:WaitForChild("TriggerStates")
			local Aggro = TriggerStates:WaitForChild("Aggro")
			local RandomX = Universal_Checks.TrueRandom(-ClosestObject.Size.X/2, ClosestObject.Size.X/2)
			local RandomZ = Universal_Checks.TrueRandom(-ClosestObject.Size.Z/2, ClosestObject.Size.Z/2)
			local PathfindPosition = (ClosestObject.CFrame *, 0, RandomZ)).Position
			local CalculatedPath =, {AgentHeight = 5, AgentRadius = 3, AgentCanJump = true,})
			Connections["PathCompleteConnect"] = CalculatedPath.Completed:connect(function(Status)
				--check distance of all players to aggro
			Connections["AggroChangeConnect"] = Aggro:GetPropertyChangedSignal("Value"):connect(function()
				if Aggro.Value ~= nil then

Here’s what happens. This causes a HUGE lag spike. Do you notice anything wrong in my code that could cause this?

EDIT: Turns out I was using the old version of the module. I believe the issue is fixed!