Changelog
4.3.81 (2023-09-25)
Fixed a memory leak which could happen if the game was not running in the editor, and no cameras were being rendered (e.g. on a server).
Fixed standalone builds not working due some editor-only API usage (regression in 4.3.80).
Fixed compatibility with entities package versions 1.0.0 to 1.0.7.
Fixed a bug in MultiTargetPath, causing it to sometimes throw an exception when used on grid graphs (regression in 4.3.x).
Fixed scanning point graphs didn't work (regression in 4.3.80).
Removed previously deprecated method NavGraph.ScanGraph, use NavGraph.Scan instead.
Added ASTAR_MORE_MULTI_TARGET_PATH_TARGETS to the A* Inspector -> Optimizations tab. It allows you to increase the maxmimum number of targets for a multi target path from around 256 to around 4096.
Improved performance when scanning or updating grid graphs. In particular if you have used the Capsule collision mode.
4.3.80 (2023-09-24)
Breaking changes
Namespace structure has been significantly improved. I have tried to keep most changes to internal classes that are not used often by users, but you may have to adjust your using statements slightly. Here's a summary of the changes:
Pathfinding.Graphs.Grid has been added, and a lot of classes related to the grid graph have been moved there.
Pathfinding.Graphs.Grid.Jobs replaces Pathfinding.Jobs.Grid.
Pathfinding.Graphs.Grid.Rules now contains all grid graph rules.
Pathfinding.Graphs.Navmesh replaces Pathfinding.Recast.
Pathfinding.Graphs.Navmesh.Voxelization replaces Pathfinding.Voxels. Sadly C# doesn't support public namespace aliases, so these changes cannot be made backwards compatible.
If you have written your own graph type (one of a rare bunch), you may need to update your scanning code slightly. In particular, you'll need to yield with the ScanningStage.WritingNodeData stage as the final item in your scanning function. Take a look at Writing Graph Generators for more details.
Removed a lot of deprecated code. All of these have been deprecated for at least a few years.
Removed previously deprecated property RecastGraph.forcedBounds.
Removed previously deprecated method RecastGraph.ClosestPointOnNode (use node.ClosestPointOnNode instead).
Removed previously deprecated method RecastGraph.ContainsPoint (use node.ContainsPoint instead).
Removed previously deprecated method GridGraph.CheckConnection (use node.HasConnectionInDirection instead).
Removed previously deprecated method GridGraph.GetNodesInArea (use GridGraph.GetNodesInRegion instead).
Removed previously deprecated method overload GridGraph.CalculateConnections(int,int,GridNode).
Removed previously deprecated method GridGraph.UpdateNodePositionCollision.
Removed previously deprecated method GridGraph.UpdateSizeFromWidthDepth (use GridGraph.SetDimensions instead).
Removed previously deprecated method GridGraph.GenerateMatrix (use GridGraph.UpdateTransform instead).
Removed previously deprecated method GridGraph.GetNodeConnection (use GridNodeBase.GetNeighbourAlongDirection instead).
Removed previously deprecated method GridGraph.HasNodeConnection (use GridNodeBase.HasConnectionInDirection instead).
Removed previously deprecated method GridGraph.SetNodeConnection (use GridNode.SetConnectionInternal instead).
Removed previously deprecated class LegacyAIPath, as it's been deprecated for about 6 years now.
Removed previously deprecated class LegacyRichAI, as it's been deprecated for about 6 years now.
Removed previously deprecated class LegacyRVOController, as it's been deprecated for about 6 years now.
Removed previously deprecated method Seeker.GetNewPath (use ABPath.Construct instead).
Removed previously deprecated overload of Seeker.StartMultiTargetPath (use Seeker.StartPath instead).
Removed previously deprecated field AstarPath.astarData (use AstarPath.data instead).
Removed previously deprecated field AstarPath.limitGraphUpdates (use AstarPath.batchGraphUpdates instead).
Removed previously deprecated field AstarPath.maxGraphUpdateFreq (use AstarPath.graphUpdateBatchingInterval instead).
Removed previously deprecated property AstarPath.IsAnyGraphUpdatesQueued (use AstarPath.IsAnyGraphUpdateQueued instead).
Removed previously deprecated callback AstarPath.OnGraphsWillBeUpdated.
Removed previously deprecated callback AstarPath.OnGraphsWillBeUpdated2.
Removed previously deprecated method AstarPath.QueueWorkItemFloodFill.
Removed previously deprecated method AstarPath.EnsureValidFloodFill.
Removed previously deprecated method AstarPath.FloodFill.
Removed previously deprecated method AstarPath.FlushWorkItems(bool,bool) (use AstarPath.FlushWorkItems() instead).
Removed previously deprecated method AstarPath.FlushThreadSafeCallbacks (use AstarPath.FlushWorkItems() instead).
Removed previously deprecated method AstarPath.BlockUntilPathQueueBlocked (use AstarPath.PausePathfinding instead).
Removed previously deprecated method AstarPath.WaitForPath (use AstarPath.BlockUntilCalculated instead).
Removed previously deprecated method AstarPath.RegisterSafeUpdate (use AstarPath.AddWorkItem instead).
Removed previously deprecated method GraphNode.RecalculateConnectionCosts.
Removed previously deprecated component TileHandlerHelper, as this is built-in to navmesh/recast graphs now.
Improved consistency guarantees when doing an async graph scan. Previously, the graphs could be in partially scanned states during the scan, which could cause e.g. GetNearest calls to return incorrect results, or throw exceptions. Now, the graphs will be in a consistent state at all times during the scan (from the main thread's perspective).
Improved performance of scanning and updating recast graphs.
Reduced likelyhood of gaps being generated between tiles in recast graphs. This will reduce the precision of the navmesh a bit on the y-axis along tile edges, but agents should be able to navigate better (and it will look better).
Combined several methods in the layered grid graph and regular grid graph to use the same implementation, reducing code duplication and improving compile times.
Moved GridGraphRule.ForEachNode to GridIterationUtilities.ForEachNode.
Moved GridGraphRule.FilterNodeConnections to GridIterationUtilities.FilterNodeConnections.
Moved GridGraphRule.GetNeighbourDataIndex to GridIterationUtilities.GetNeighbourDataIndex.
The grid graph inspector will now list which tags will be used for erosion, when the tags option is enabled.
You can now choose which tags erosion is allowed to overwrite, when the tags option is enabled, using the new GridGraph.erosionTagsPrecedenceMask option.
Added 2D support for the recast graph. The recast graph now supports 2D colliders and the inspector has a new enum that allows you to change between 2D and 3D mode. There's a new field RecastGraph.backgroundTraversability that controls if a navmesh should be generated for an unobstructed background in 2D mode.
Changed the behavior of the recast graph's collider detail field. Previously it would not scale with the cell size, which made it hard to transfer between scenes of different scales. Now it scales with the cell size, so leaving it at the default value of 1 should work well for almost all games.
Fixed the recast graph's 'Snap bounds to scene' button could misalign the graph if the graph was rotated.
The recast graph's center, size and rotation fields will now be rounded to a multiple of 0.5 if it is very close to one.
Deprecated GridGraph.CalculateConnections(int,int). Use GridGraph.RecalculateConnectionsInRegion instead to batch multiple calls. This method still works, but the overhead of calling it will be significantly higher than in earlier versions. This new overhead comes from properly handling the new GridGraph.maxStepUsesSlope option, and job scheduling overhead. If you are recalculating connections for a large number of nodes, you should use GridGraph.RecalculateConnectionsInRegion instead. The RecalculateConnectionsInRegion method scales better to larger node counts than CalculateConnections ever did.
The RaycastModifier now defaults to graph raycasting in the pro version of the package.
Fixed NavmeshCuts with custom meshes could calculate an incorrect bounding box, which could lead to it not updating some tiles, even if it was touching them.
Fixed rotated RecastGraphs could in some cases end up with gaps between tiles because some meshes that should have been included in the tile were missed.
Fixed grid graph inspector could throw an exception if a tilemap in the scene was destroyed.
Fixed NavmeshPrefab not refreshing its gizmos when the bounding box was changed in the inspector.
Fixed NavmeshPrefab not being aligned properly to the graph, if the graph was not scanned, when the align button in the inspector was pressed.
Fixed NavmeshPrefab in some cases breaking nearest node lookups when it was loaded.
Fixed compatibility when loading recast graphs before 4.3.68.
The FollowerEntity component will now show a warning in the inspector if the entities package is not installed, and a button to automatically install it.
Allow editing the destination manually in the inspector for the FollowerEntity component.
The FollowerEntity now defaults to having local avoidance disabled.
Deprecated AIPath.OnTargetReached, RichAI.OnTargetReached, AILerp.OnTargetReached. You can use IAstarAI.reachedDestination or IAstarAI.reachedEndOfPath instead.
PointGraph.optimizeForSparseGraph is now included in the free version too. This option makes scanning a large point graph much faster.
The transform tool for the GameObject with the AstarPath component is now hidden to reduce clutter, as each graph has its own transform tool instead.
4.3.79 (2023-08-11)
Fixed GraphUpdateScene.GetBounds sometimes incorrectly returning an empty bounding box if the convex option was enabled.
Fixed disabling the RVOSimulator while there were still RVOControllers in the scene could lead to an exception (regression in 4.3.78).
The RVOController will now disable itself if the global RVOSimulator is disabled.
4.3.78 (2023-08-09)
Added NavGraph.isScanned.
Fixed GridGraph and LayerGridGraph not always using GridGraph.newGridNodeDelegate when creating nodes.
Fixed two memory leaks in the local avoidance system.
4.3.77 (2023-07-12)
Breaking changes:
Scanning when the game starts now happens during early OnEnable instead of during early Awake. This should typically not cause any issues, since it's good practice in Unity to not depend on other components being initialized in Awake. But this may cause issues if you have been depending on this very specific initialization order.
Added support for 'Enter Play Mode Options' with 'Reload Scene' disabled. This is considered an experimental feature. Please report any bugs you may have with Reload Scene disabled.
The AstarPath component will now initialize itself during early OnEnable instead of during early Awake. This makes it possible to set custom settings on the AstarPath component, such as the thread count, from a script when the game starts. Previously this was kinda tricky, since no user scripts would have been run before the AstarPath component initialization.
Fixed FollowerEntity not respecting tags when repairing its path.
Fixed some cases where a recast graph would miss some connections between nodes in different tiles. Especially if the shared edge was long.
Fixed Navmesh Cutting Update Interval would not be serialized, and therefore always reset to 0 when the game started.
4.3.76 (2023-06-22)
Fixed sphere gizmos for navmesh cut component could be drawn incorrectly if the object was scaled.
Fixed AIPath throwing an exception if there was no RVOSimulator in the scene (regression in 4.3.75).
Fixed linecasts not working on navmesh graphs if the mesh had triangles which were not clockwise in the xz plane (regression in 4.3.x).
Fixed editing NavmeshCut components in a scene without an AstarPath component would throw an exception.
4.3.75 (2023-06-13)
Fixed race condition which could cause an exception to be thrown when using AIPath or RichAI with local avoidance.
Fixed some edge cases in FollowerEntity which could cause FollowerEntity.remainingDistance to return the wrong value.
Make FollowerEntity.rvoAgent use a ref return to enable easier modifications.
Exposed FollowerEntity.groundMask
Exposed FollowerEntity.debugFlags
Fixed a memory leak in the local avoidance system when an AstarPath component was not present in the scene.
4.3.74 (2023-06-09)
Added NavGraph.IsInsideBounds.
Added RecastGraph.bounds
Fixed "Some meshes were statically batched..." error message being logged multiple times when scanning a recast graph. Now it is limited to at most once per scan.
Removed dependency on the Unity Jobs package, as it has been merged into the Unity Collections package.
Added AIDestinationSetter.useRotation, which is usable with the FollowerEntity movement script.
Navmesh graphs now have an option to expand all navmesh cuts by a constant amount.
Various improvements to the FollowerEntity movement script.
4.3.73 (2023-05-16)
Fixed some properties on the FollowerEntity component could throw exceptions when written to.
4.3.72 (2023-05-14)
Fixed compatibility with the entities package version 1.0.8. Unity really can't stop breaking backwards compatibility...
Exposed FollowerEntity.autoRepath.
4.3.71 (2023-05-12)
Fixed RVOExampleAgent could throw an exception if it tried to follow a path with length 1.
Implemented FollowerEntity.canMove.
Implemented FollowerEntity.updatePosition.
Implemented FollowerEntity.updateRotation.
Implemented FollowerEntity.isStopped.
Exposed FollowerEntity.maxSpeed.
Improved documentation for the new ECS components.
4.3.70 (2023-05-09)
Fixed FloodPath and FloodPathTracer not working properly on navmesh/recast graphs since the large path refactoring in 4.3.67.
Added FollowerEntity.movement.groundMask to allow specifying which layers that are considered when raycasting for ground placement.
4.3.69 (2023-05-08)
Fixed typo causing paths which would fail due to not finding a valid end node, to instead crash the whole pathfinding thread (regression in 4.3.67).
4.3.68 (2023-05-07)
Made the entities package an optional dependency.
4.3.67 (2023-05-07)
Fixed compatibility with the entities package version 1.0.0-pre.65.
Improved accuracy of path searches on navmesh graphs significantly.
Previously, paths on navmesh/recast graphs have been searched by going from triangle center to triangle center. This is not very accurate and can lead to agents choosing suboptimal paths. Now, paths use a more accurate method which moves between different points on the sides of the triangles instead of the centers. This is much more accurate and should lead to agents choosing better paths in almost all cases.
It also accounts for the exact start and end point of the path more accurately now.
However, this improved accuracy comes with a cost, and pathfinding performance on navmesh/recast graphs is a bit lower than before. Luckily, it is still very fast, and most games are not bottlenecked by this.
Simplified the code for path types significantly. There's now a lot more code sharing.
AutoRepathPolicy will now automatically randomly spread out path recalculations a bit to avoid many agents recalculating their paths at the same time.
Improved the MultiTargetPath.
It now properly properly works even with multiple targets within a single node. This is particularly important for accuracy on navmesh graphs. Previously all endpoints would be snapped to the closest node center.
Improved performance when only finding the closest target (MultiTargetPath.pathsForAll=false), sometimes significantly so.
Removed the MultiTargetPath.heuristicMode field, it now automatically does the best thing.
Added an overload of GraphNode.GetConnections which takes a ref value that will be passed to the callback. This can be used to avoid allocations when getting connections due to not having to allocate a closure.
ABPath now accepts an ending condition (ABPath.endingCondition), making the XPath path type obsolete.
Marked XPath as obsolete. Use ABPath with an ending condition instead.
Removed Jump Point Search support for grid graphs. It was quite limited, and very few people seemed to use it. But it contributed a significant amount of code.
Various bugfixes, especially related to rvo and the FollowerEntity component.
4.3.66 (2023-03-24)
Fixed a bug causing layered grid graphs not to scan properly.
4.3.65 (2023-03-22)
Fixed calling certain methods on the RVOController component could cause an exception to be thrown, because it wasn't properly synchronizing with the local avoidance worker thread (regression in 4.3.62).
Fixed exception when scanning a graph and there were no walkable nodes at all (regression in 4.3.62).
4.3.64 (2023-03-21)
Fixed compilation errors when any render pipeline packages were also installed.
4.3.63 (2023-03-19)
Fixed FollowerEntity component had bad defaults for some fields.
4.3.62 (2023-03-19)
Breaking changes
The type of some tag fields have changed from int to PathfindingTag. If you have assigned a tag to those fields before, you will now first need to convert it to a PathfindingTag:
new PathfindingTag((uint)tag).Removed support for deserializing graphs from version 3.8.x and below. 3.8.x was released over 7 years ago, so this should hopefully have given people enough time to upgrade.
NavGraph.GetNearest will now always take the constraint into account. Previously this depended on the graph type and it was generally hard to use to get consistent results across graph types.
NavGraph.GetNearest now returns an NNInfo instead of a NNInfoInternal.
Added a completely new movement script FollowerEntity which uses ECS and aims to be much more robust compared to AIPath and RichAI. It is still under development, but it already works quite well. However, it is limited to navmesh/recast graphs. It implements the IAstarAI interface, so the API is very similar to other movement scripts.
Added NodeLink2.pathfindingTag to be able to control which agents can traverse an off-mesh link.
Added the PathfindingTag struct. You can add this to your scripts to automatically get a nice dropdown in the inspector for selecting pathfinding tags.
Added GraphNode.ContainsPoint(Vector3) and GraphNode.ContainsPointInGraphSpace.
Added GridNodeBase.ContainsPoint and GridNodeBase.ContainsPointInGraphSpace.
Added a way to align a grid graph to a tilemap. Previously this has been quite tricky, especially for isometric and hexagonal tilemap layouts.
Added GridGraph.AlignToTilemap.
RecastMeshObj components now have a "Geometry Source" field, so that you can choose manually if you want to use a mesh or a collider when voxelizing it.
RecastMeshObj components now have a "Include In Scan" field, which allows you to choose if the object should be filtered using layer/tag masks, or if it should always/never be included in the scan. Previously RecastMeshObj components were always included in the scan. When upgrading from, all existing RecastMeshObj components will be set to "AlwaysInclude" for compatibility.
Changed how GridGraph.aspectRatio works for isometric and hexagonal grid graphs. Now it works more intuitively to just make the nodes N times wider. Before it only behaved properly for rectangular grid graphs.
Fixed using graph coloring mode HierarchicalNode could draw the wrong color for some nodes after graph updates, due to too aggressive caching.
Fixed the grid graph's collision preview showing the side view when using 2D physics even though that's irrelevant for 2D.
Fixed an exception could in rare circumstances be thrown when using ABPath.calculatePartial.
Fixed NavmeshCut behaving incorrectly when scaled along the Y axis sometimes (regression in 4.3.x).
Fixed destination and the auto repath policy's sensitivity would always be visualized in the xz plane. Now they are visualized in the same plane as the agent moves in.
Fixed RVO agents would sometimes collide with invisible obstacles if there had been a recent graph update (regression in 4.3.x).
Fixed solid objects that were rasterized by a RecastGraph would not get treated as solid if they were partially outside the graph's bounding box along the y-coordinate.
Fixed name collision when both the A* Pathfinding Project and ALINE were installed in a project. This could cause the warning "There are 2 settings providers with the same name Project/ALINE." to be logged to the console.
Fixed editor-only data would sometimes not be loaded from graphs, leading to some settings in the graph inspectors to be lost (e.g. if the grid graph's collision preview was open or closed).
Changed some private fields in AIPath to be protected instead.
Added GridNodeBase.HasConnectionsToAllAxisAlignedNeighbours.
Fixed MeshNode.ContainsConnection could throw an exception if the node had no connections at all.
Changed the signature of GraphNode.GetPortal to use out-parameters instead of output lists. The old signature will continue to work, but it is marked as deprecated.
Removed support for deserializing graphs from version 3.8.x and below.
Fixed RVO debug drawing lines were drawn incorrectly on spherical/non-planar worlds.
Scanning a navmesh graph asynchronously now offloads more computations to worker threads. This makes stutter much less of an issue when scanning large navmeshes.
Fixed AIPathAlignedToSurface would not work properly if a mesh was updated while the agent was moving on it.
Added support for scheduling paths (AstarPath.StartPath) from within the Unity Job System.
Reduced the overhead of having many AIDestinationSetter components.
Allow running nearest node queries and other node lookup functions from within the unity job system. This requires you to call the AstarPath.LockGraphDataReadOnly function to ensure safety.
Multi-editing is now enabled for the RecastMeshObj.solid property in the inspector.
Added ABPath.cost for accessing the total cost of a calculated path.
Fixed calling GraphUtilities.GetContours with a grid graph that had one-way connections could cause an infinite loop. Now an exception will be thrown if any one-way connections are found. This is reasonable because the contours of a grid graph are not really well-defined if any one-way connections exist.
Fixed node connections could be deserialized incorrectly when loading a layered grid graph from cache or a file that was saved with version 4.3.11 or earlier.
Fixed updating a recast graph could throw an exception if the update touched no tiles at all (regression in 4.3).
Various local avoidance fixes, especially related to collision and avoidance of navmesh edges.
Added a new distance metric when searching for the closest node: DistanceMetric.ClosestAsSeenFromAboveSoft(Vector3). This is much nicer for character movement in most cases, and also usually faster than the default euclidean metric.
Deprecated NavmeshBase.nearestSearchOnlyXZ. Use NNConstraint.distanceMetric instead.
Deprecated NNConstraint.distanceXZ, use NNConstraint.distanceMetric instead.
Deprecated NavGraph.GetNearestForce, use NavGraph.GetNearest instead as it does the same thing now.
Improved performance when searching for nearest nodes on navmesh/recast graphs (sometimes up to 5x, but typically only by a small percentage).
Improved rebuild performance of the recast/navmesh internal bounding box tree (particularly important when using navmesh cutting).
Added ASTAR_LARGER_GRIDS which can be set under the Optimizations tab to enable grid graphs larger than 1024x1024.
Removed AstarPath.prioritizeGraphs. It was always a bit of a hack. Use NNConstraint.graphMask if you want to choose which graphs are searched.
Removed AstarPath.fullGetNearestSearch, it is now always treated as true.
Improved accuracy of GetNearest calls on grid graphs. Previously the returned node was not necessarily the closest one if AstarPath.fullGetNearestSearch was not enabled.
Renamed NNConstraint.Default to NNConstraint.Walkable for clarity.
4.3.61 (2022-11-09)
Added a documentation page on the architecture of the package: Architecture overview.
Added a tutorial on migrating from Unity's pathfinding to this package: Migrating from Unity Navigation.
Added a tutorial on how to deal with pathfinding in large worlds: Large worlds.
Fixed local avoidance obstacle time horizon was always 1, instead of the actual value set on the RVOController.
Fixed saving or loading graphs could deadlock on WebGL since the zip library tired to use threads, which doesn't work on WebGL.
The game view will now automatically repaint after a graph is scanned in the editor. Previously only the scene view was repainted.
Deprecated AstarPath.prioritizeGraphs.
4.3.60 (2022-10-10)
Fixed a regression causing exceptions to be thrown when RVOControllers were marked as locked.
Removed double buffering support from the local avoidance system. Double buffering was causing issues with newer features, and it didn't give that much benefit anyway (and caused agents to be less responsive). The system can already simulate up to 30000 agents at 60 fps, so the use cases were limited.
Grid graphs and layered grid graphs now have support for NNConstraint.distanceXZ. This makes AIPath.constrainInsideGraph work a lot better for grid graphs which have slopes.
Nearest node queries on layered grid graphs are now significantly faster.
4.3.59 (2022-09-21)
Fixed bug causing grid graph updates that were almost, but not quite, inside the graph to throw exceptions.
4.3.58 (2022-09-13)
Fix exception that could be thrown when using local avoidance and the navmesh had degenerate edges (could happen when using the NavmeshAdd component).
Changed the color of gizmos drawn for the NavmeshAdd component from green to purple to avoid confusion with the Seekers gizmos.
Removed some debugging code that had been left in by mistake in 4.3.56.
Fixed some cases where profiling scopes were not properly closed, resulting in a (harmless) error message in the console.
If you have a persistent (DontDestroyOnLoad) AstarPath component while loading a new scene with an existing AstarPath component, the newly loaded AstarPath component will disable itself instead of logging an error and leaving both components in inconsistent states. This will make it easier to keep a single AstarPath component around for the whole duration of the game.
4.3.57 (2022-09-05)
Improve documentation for RecastGraph.useTiles.
Fix typo causing gizmos from prefabs to always be drawn in the scene view in Unity versions earlier than 2022.1, even if they were not even added to the scene.
4.3.56 (2022-08-31)
Fix exceptions could be logged from the gizmo drawing code. Regression in 4.3.55.
A garbage collection will no longer be forced immediately after scanning graphs. Unity has decent support for incremental GC now, and it's best to rely on that instead. This may improve performance when scanning graphs.
Burstified parts of navmesh graph scanning.
4.3.55 (2022-08-27)
Fixed local avoidance behaving very weirdly (regression from 5.3.52)
Fixed graphs would not show up with some operating system/graphics api combinations.
4.3.54 (2022-08-22)
Various fixes for NavmeshPrefab.
Fixed the minimum required burst version was incorrect.
4.3.53 (2022-08-21)
Version bump because npm required it.
4.3.52 (2022-08-21)
Fixed documentation and changelog URLs in the package manager.
Renamed AutoRepathPolicy.interval/maximumInterval to AutoRepathPolicy.period/maximumPeriod since that's a more descriptive name.
Fixed graph updates on grid graphs sometimes updated a slightly larger number of nodes than strictly necessary.
Improved local avoidance performance by optimizing the quadtree even further.
Fixed local avoidance jobs would not get burstified in standalone builds, reducing local avoidance performance there.
Fixed grid graph update jobs would not get completely burstified in standalone builds, reducing grid graph update performance.
Added RecastGraph.Resize to allow changing the number of tiles of a graph during runtime.
Added RecastGraph.ReplaceTiles to allow replacing multiple tiles at once.
Added NavmeshPrefab to allow easily storing recast graph tiles in prefabs and load them at runtime (great for big procedurally generated levels).
Fixed the FunnelModifier could simplify the path incorrectly on rotated recast graphs.
Fixed ExitGUIException could show up in the console sometimes when editing component properties.
Fixed floating point errors causing the FunnelModifier to simplify the path incorrectly in rare cases.
Reverted an earlier change which unintentionally could make small obstacles create large holes in recast graphs. Common issues such as placing tiny rocks on the ground could make large parts completely unwalkable.
4.3.51 (2022-06-14)
Fixed AILerp.remainingDistance throwing an exception instead of returning +inf if it had no path to follow. Regression since 4.3.50.
Added support for ITraversalProvider.filterDiagonalGridConnections to layered grid graphs (previously only normal grid graphs had support).
4.3.50 (2022-06-08)
Breaking changes
The minimum supported Unity version is now Unity 2020.3.34f1.
Added ITraversalProvider.filterDiagonalGridConnections (see below). This is a breaking change when using Unity 2021.2 or older because a default implementation cannot be provided due restrictions in the C# runtime. If you are implementing the ITraversalProvider interface you can just add an implementation for that property returning true.
The PathInterpolator class has been refactored significantly and now represents points using a Cursor struct, instead of storing it on the interpolator itself. Normally the PathInterpolator is not used by users, but a few may have used it in their own movement scripts. In that's the case for you, then you will need to make small modifications to your code to create a cursor representing the current point.
Fixed compatibility with Unity 2022.1 and up.
Added ITraversalProvider.filterDiagonalGridConnections for better control over how diagonal grid connections are handled.
Added a warning to the inspector when scanning a recast graph that includes unreadable meshes. Previously a warning would only be logged to the console.
Fixed SerializableAnimationCurve being stripped from the build in IL2CPP builds.
Changed AutoRepathPolicy to make it usable for custom movement scripts without having to implement the IAstarAI interface.
Fixed bug in RVO system which could cause very large agents to behave weirdly.
Increased artificial limit for the maximum length of paths from 2048 to 16384.
4.3.49 (2022-04-15)
GridNodeBase.RemoveConnection now also works for grid connection, not just custom connections.
GridNodeBase.AddConnection will now remove an existing grid connection (if it exists) to the same node, before adding the new custom connection. Before, you could get two connections between the nodes instead of one, like you'd expect.
Fixed setting RVOController.velocity would not work because of a bug. (regression from 4.3.x).
Fixed inheriting from scripts in this package (e.g. AIPath) and adding new fields, would not make those fields show up in the inspector unless you had a custom editor script too. Now all fields the editor scripts cannot handle will show up automatically.
Improved error checking in FloodPath for if the start node was destroyed before the path calculation started.
Using IAstarAI.SetPath will now set the destination of the movement script to the end point of the path by default. If you pass a RandomPath, FleePath or MultiTargetPath, the destination will be set once the path has been calculated since that's when it is first known. This makes properties like IAstarAI.reachedDestination and IAstarAI.remainingDistance work out of the box for those path types.
4.3.48 (2022-02-02)
Fixed not being able to check for updates in Unity 2022.1+ because https must now be used for all web requests.
Fixed exception when using MecanimBridge with RichAI.
Fixed AIPath.reachedDestination would throw an exception if you tried to access it when the agent had no path.
Fixed some smaller memory memory leaks in the unity editor.
Fixed some warnings related to ENABLE_UNITY_COLLECTIONS_CHECKS which burst would log when building a standalone player.
Fixed AIPathAlignedToSurface would throw an exception if no RVOController was attached.
Fixed setting RVOController.velocity would be buggy except in 2D space (regression from 4.3.x).
Fixed setting RichAI.rotation while the agent was stationary would rotate the agent, but it would immediately rotate back to the previous heading.
Fixed the Teleport function not working properly for LocalSpaceRichAI.
Fixed the inspector for LocalSpaceRichAI not showing the very important graph field, making it very hard to use. This is a recent regression.
Created a property drawer for the GraphMask struct. So now you can include GraphMask fields in your own scripts and they will show up nicely in the inspector.
Deprecated some older linecast overloads for grid graphs.
Deprecated LevelGridNode.GetConnection in favor of LevelGridNode.HasConnectionInDirection.
Improved performance of linecasts on grid graphs by approximately a factor of 2.
Improved accuracy of linecasts on grid graphs. In particular, many edge cases were previously undefined and were not consistently handled. Now linecasts which only touch corners of obstacles are always allowed, and also linecasts which go right on the border between walkable and unwalkable nodes.
Fixed linecasts on grid graphs would not always return a hit if the start point or end point was outside the graph.
Fixed radius expansion didn't work on NavmeshCuts with the shape "Rectangle".
Add GridNodeBase.NormalizePoint and GridNodeBase.UnNormalizePoint.
Implemented a new and better algorithm for path simplification on grid graphs based on the paper "Toward a String-Pulling Approach to Path Smoothing on Grid Graphs". This essentially makes the raycast modifier obsolete for grid graphs (unless you use the physics raycasting option) as the new algorithm is both faster and more accurate. It is used automatically by the FunnelModifier on grid graphs. It also takes penalties/tags into account, which has been a long requested feature.
4.3.47 (2021-09-04)
Exposed AILerp.velocity.
Fixed AIPath.reachedEndOfPath not always being reset to false when the component was disabled and then enabled again.
GraphNode.ClosestPointOnNode is now available for all node types instead of only being implemented for GridNode and MeshNode.
Fixed a case where the Seeker -> Start End Modifier -> Snapping to NodeConnection mode would not respect tags or ITraversalProviders. This could result in the path partially entering a node which should not be traversable by it.
Fixed a case where using the ABPath.calculatePartial option together with Seeker->Start End Modifier->Snapping=ClosestOnNode would make the path seemingly ignore which tags were traversable in some cases.
Fixed some edge cases which could cause an ai with the 'stop when destination is crowded' to not start moving until after a few seconds after it got a new destination.
Fixed a regression since 4.3.44 in which overlapping navmesh cuts (especially with different shape types) would often cause exceptions.
4.3.46 (2021-07-21)
Added a get/set property GridGraph.is2D which is equivalent to the inspector's "2D" toggle.
Added a new grid graph rule pass: Pass.AfterErosion. See Writing Custom Grid Graph Rules.
Fixed graph updates would not work well with GridGraph.erosionUseTags. In particular when removing obstacles.
4.3.45 (2021-06-25)
Fixed an exception could be thrown in rare cases when scanning a recast graph (bug introduced in 4.3.43).
4.3.44 (2021-06-23)
Unity 2020.2.2f1 is now required.
Updated versions of the burst, collections and jobs packages.
Fixed RelevantGraphSurface not working in the new burst-powered recast graph scanning code.
NavmeshCuts now support some 3D shapes (box/sphere/capsule) in addition to the previous 2D shapes (rectangle/circle) which makes them a lot more pleasant to use.
NavmeshCuts now support expanding the cut by the agent radius.
Fixed an exception could be thrown in rare cases when scanning a recast graph (bug introduced in 4.3.43).
Fixed an exception could be thrown when using the NavmeshClamp script with multiple graphs.
4.3.43 (2021-05-04)
Breaking changes
Fixed some cases where an unwalkable surface a small distance above a walkable surface would still end up as walkable when using a recast graph. This may have an impact on your graphs.
Removed support for local avoidance obstacles (RVOSquareObstacle and RVONavmesh). More details further down.
You can now mark surfaces as having specific tags for recast graphs. Just add the RecastMeshObj component to an object and set the mode to RecastMeshObj.Mode.WalkableSurfaceWithTag.
Graph updates on recast graphs now use the new burstified code and is therefore significantly faster.
Added GraphUpdateObject.stage which contains info about if a graph update has been applied or not.
Improved the DynamicGridObstacle to handle cases when graph updates take a very long time in a better way.
Fixed some cases where an unwalkable surface a small distance above a walkable surface would still end up as walkable when using a recast graph.
Fixed the RecastMeshObj component would sometimes still affect objects even if it was disabled.
Removed support for local avoidance obstacles (RVOSquareObstacle and RVONavmesh). Local avoidance obstacles never worked particularly well and the performance was poor. They were also never supported by the new burstified local avoidance code. Use regular graph updates to update the pathfinding graphs instead.
Fixed LevelGridNode.HasConnectionsToAllEightNeighbours always returning false.
Fixed ProceduralGridMover not working with layered grid graphs.
4.3.42 (2021-04-17)
Breaking changes
Improved handling of tags and ITraversalProviders for grid graphs. This may change paths in your game slightly. In pretty much all cases the new behavior is what you want though. See below for details.
Changed the order of execution for the AstarPath script to -10000. Previously the order of execution was left at the Unity default value which is very unpredictable. This may cause issues for you if you relied on Awake to be executed before the graphs were loaded and scanned. If you need full control over when the graphs are scanned it is recommended that you disable scanOnStartup and instead call AstarPath.Scan(NavGraph[]) manually when you want to scan the graphs.
Added a NavmeshClipper.graphMask field to the NavmeshCut and NavmeshAdd components.
Improved the NavmeshAdd component inspector.
Improved handling of tags and ITraversalProviders for grid graphs. Previously when a path was calculated it would only take tag walkability and ITraversalProviders into account in a very basic way. For example normally an agent is not allowed to move diagonally between two unwalkable nodes, even if both the start and end nodes are themselves walkable. However this check did not apply to tags and ITraversalProviders because that info was precalculated and tags/ITraversalProviders can be set per path. Now this is properly taken into account. This also means things like the GridGraph.cutCorners option will apply to tags and ITraversalProviders. See GridNode.FilterDiagonalConnections for more details.
Fixed a bug which could very rarely cause some node connections between tiles in a recast graph to be missed, causing various subtle movement issues.
Fixed a bug which could cause a SynchronizationLockException to be thrown in some cases when the game was quit in a non-graceful way (e.g. when Unity exits play mode after recompiling scripts).
Fixed a bug which could cause some native arrays to not be cleaned up when the game was quit in a non-graceful way (see previous line).
Fixed a bug which could cause connections to be calculated incorrectly on layered grid graphs that just so happened to only have a single layer.
Fixed layered hexagonal graphs not working properly.
4.3.41 (2021-02-28)
Fixed the graphs would be rendered even when the scene view was in prefab isolation mode and you were viewing an unrelated prefab.
Fixed a deprecation warning when using the HDRP package version 9.0 or higher.
Fixed a bug in the grid graph rule's helper function ForEachNode which would not work if the normal of the nodes were exactly (0,1,0).
Improved error messages when trying to include a non-readable mesh in a recast graph scan.
4.3.40 (2021-01-27)
Cleaned up some large audio files in the example scenes to reduce the package install size quite significantly.
Removed some `.blend1` (blender backup files) that had been accidentally included in the package.
The Unity Entities package is no longer a dependency. This previously contained some functionality that was needed, but this has since moved to the smaller Jobs package.
Fixed some visual scaling bugs in the collision visualization code for the grid graph.
Fixed calling `AstarData.ClearGraphs` and then immediately calling `AstarData.AddGraph` would result in an exception.
Fixed UpdateGraphsNoBlock(GraphUpdateObject,GraphNode,GraphNode,bool) could return incorrect results if there were already some pending graph updates.
4.3.39 (2020-12-11)
Fixed grid graph would see 2D triggers as obstacles. Now all 2D colliders marked as triggers will be ignored by the grid graph.
Improved compatibility with some older versions of the Universal Render Pipeline.
4.3.38 (2020-11-18)
Fixed a memory leak that could happen after switching scenes. Thanks nGenius for finding it.
Fixed compatibility with Unity 2020.2. Note that this package is not compatible with some alpha releases of 2020.2, but it is compatible with the later 2020.2 releases.
4.3.37 (2020-11-01)
Fixed scanning recast graphs could throw an exception in Unity 2020 or higher if the scene contained a mesh with 0 vertices.
Added IAstarAI.endOfPath.
Fixed the built-in movement scripts' 'Stop When Destination Is Crowded' behavior would not work well if the destination couldn't be reached, but the agents were still crowding up against the closest point they could reach.
Fixed updating layer grid graphs during runtime that had been loaded from a file/cache could throw an exception (bug introduced during the 4.3.x beta). Thanks Kevin_Jenkins for help with pinning the bug down.
Note: If you are using the "account for slopes" graph option I recommend that you regenerate any caches and re-save any graph files after upgrading (if you are using any caches/graph files). Things will work without doing that, but in some cases it may behave as if "account for slopes" is disabled.
Fixed updating grid graphs during runtime could sometimes give you subtly different results if the graph had been loaded from a file/cache (bug introduced during the 4.3.x beta).
4.3.36 (2020-10-25)
Fixed a major memory leak that could happen if the graph was re-scanned many times. The bug was introduced in 4.3.12.
Fixed Unity freezing when scanning grid graphs on some computers.
Made it possible to create grid graph rules that run in the main thread instead of using the unity job system. See Writing Custom Grid Graph Rules.
Fixed a bug which could cause a greyed out object called 'RetainedGizmos' to appear in the scene hierarchy.
Improved the documentation for writing custom grid graph rules: Writing Custom Grid Graph Rules.
4.3.35 (2020-10-10)
Fixed burstified recast code sometimes throwing an exception in standalone IL2CPP builds.
Worked around a null reference exception in Unity's ClearPreviewCache that could appear randomly from time to time.
Minor reduction in overhead in standalone builds.
4.3.34 (2020-09-04)
Added a setter for the rotation property of all movement scripts (IAstarAI.rotation).
Fixed RichAI always teleporting to the closest point on the navmesh when the script is enabled even if AIBase.canMove is false.
Fixed old hidden instances of the BatchedEvents object could be left in the scene. In the editor this could lead to a build-up of hidden objects that were not cleaned up until Unity exited.
Fixed grid graph rules would not work in standalone games when using IL2CPP and bytecode stripping was enabled.
Changed 'The burstified recast code is only supported in Unity 2020.1 or newer. Falling back to the slower pure C# code.' error to a warning to make it less annoying.
Fixed recast graph rasterizing trees with the incorrect rotation sometimes. The Unity terrain system does not support rotations for trees without a LODGroup. However the pathfinding code would still think such trees were rotated even though Unity always rendered them with a rotation of 0.
4.3.33 (2020-08-24)
Improved rotation handling for characters on non-planar worlds (e.g. spherical ones).
4.3.32 (2020-08-12)
Fixed graph updates not working properly on grid graphs if the graph was loaded from a file or when using cached startup. This fixes a regression introduced in 4.3.x.
4.3.31 (2020-08-09)
Breaking changes
Changed when the AIPath/RichAI movement scripts stop when AIBase.whenCloseToDestination is set to Stop. See below for more details. The new behavior is usually what you want. If you really want the old behavior then set
ai.whenCloseToDestination = CloseToDestinationMode.ContinueToExactDestinationand in a separate script runai.isStopped = ai.reachedEndOfPathevery frame.
Fixed incompatibility with the unity.collections-0.11 package.
Added warning message when using the Experimental URP 2D Renderer. The URP 2D renderer unfortunately does not have enough features yet to be able to support the gizmo drawing system. It doesn't have an extensible post processing system. The 2D renderer will be supported as soon as it is technically possible. This does not affect any functionality of the A* Pathfinding Project except gizmo drawing and visualization in the editor.
Changed when the AIPath/RichAI movement scripts stop when AIBase.whenCloseToDestination is set to Stop. Consider the case when the destination was slightly outside the navmesh and the path instead goes to the closest point it can reach. Previously it would stop up to AIBase.endReachedDistance units from the end of the path. This could lead to unexpected behavior since it may be the case that by just moving a bit closer to the end of the path it would end up within AIBase.endReachedDistance units from the destination. Essentially AIBase.reachedDestination would remain false even though the agent could actually reach the destination by just moving a bit further. So this behavior has been changed so that it now only stops when it is within AIBase.endReachedDistance units from the destination, not the end of the path.
Fixed an exception could be thrown when scanning a recast graph and last tile in the graph didn't contain any meshes. This was a regression introduced in 4.3.x.
4.3.30 (2020-07-26)
Fixed gizmos sometimes not showing up when using a render pipeline (URP or HDRP) or when rendering in VR.
Fixed GraphUpdateScene not using the outline from an attached PolygonCollider2D properly.
4.3.29 (2020-07-13)
Added a new dynamic path recalculation mode to the movement scripts. This mode is smarter about when it recalculates paths. It will recalculate the path often when the destination changes a lot and much less frequently if the destination doesn't change much or if it is very far away. This can help improve both the responsiveness of your agents and the performance if you have many agents that do frequent path recalculations. Any existing agents will still use the old method of recalculating the path every N seconds, but you can change this in the inspector. New agents will by default use the new Dynamic mode.
The AIPath/RichAI.canSearch field has been replaced by the AIBase.autoRepath.mode field. For backwards compatibility setting canSearch to false will set the mode to Never and setting it to true will set the mode to EveryNSeconds.
The AIPath/RichAI.repathRate field has been replaced by the AIBase.autoRepath.period field. For backwards compatibility you can both read and write to the old name and it will work as before. Note that this field is not used for the new Dynamic path recalculation mode.
Improved performance of the AIPath and RichAI inspectors a bit.
The recast graph now supports terrain holes (only when running in Unity 2020 or later).
Fixed gizmos not showing up in the editor when using VR rendering.
The burstified grid graphs now support the 'erosion uses tags' option (this fixes a 4.3.x regression).
Fixed burstified recast code not working when building for IL2CPP (this fixes a regression introduced in 4.3.27).
4.3.28 (2020-06-14)
Breaking changes
The AIPath script will now clear the path it is following if a path calculation fails. See below for more details.
The AIPath script will now clear the path it is following if a path calculation fails. Previously it would continue following its previous path. This could lead to problems if the world had changed so that there was no longer a valid path to the target. The agent could then in some situations just continue trying to walk through obstacles instead of stopping. In pretty much all cases this change in behavior is what you want and will not cause any problems when upgrading.
Fixed some cases where graph updates with 2D colliders would not use the most up to date physics engine data. All graph updates are now preceeded by a call to Physics2D.SyncTransforms (in addition to Physics.SyncTransform which was already being called).
4.3.27 (2020-06-12)
Breaking changes
The ITraversalProvider interface has a new member CanTraverse(path,from,to). Since Unity's C# version does not support default interface implementation this member needs to be implemented if you have been inheriting from the ITraversalProvider interface. Luckily you just need to add a very short and simple implementation to get it working:
public bool CanTraverse (Path path, GraphNode from, GraphNode to) {
return CanTraverse(path, to);
}Convex colliders are now automatically treated as solid by the recast graph. This may lead to a different navmesh being generated, however in pretty much all cases it will be what you want.
Improved the accuracy and performance of the RaycastModifier when thick raycasting is enabled.
Made GridGraph.GetRectFromBounds public.
The Recast graph now uses burst and the Unity Job System when scanning it. This improves the speed of scanning to about 2x to 4x the previous speed. Graph updates still use the C# code, however that too will be ported in a future version. Note that graph updates do not respect the 'solid' option (see below) since the C# backend does not support that feature.
The RecastMeshObj now has an option for making a mesh solid. This is useful to prevent a navmesh from being generated inside objects. Convex colliders (box, sphere, capsule and convex mesh colliders) are automatically treated as solid.
Recast now has better support for trees
Colliders on child objects will also be taken into account.
You can use the RecastMeshObj component on trees to cutomize how they are rasterized.
Significantly improved performance when you have many trees.
Tree rotation is now taken into account.
Right clicking fields in the inspector no longer shows the "Show in online documentation" context menu, instead the normal unity context menu is shown. The previous menu prevented things like resetting individual fields to their prefab values and similar things.
Fixed a bug which could cause recast graphs to be generated incorrectly in some very rare circumstances. So rare that nobody has noticed this bug for several years.
Fixed LayerCoordinateInGrid was incorrect for layered grid graph nodes. This bug was introduced in the 4.3 beta.
The RaycastModifier now respects graphMasks set on paths. Thanks brettkercher for reporting the bug.
Added ITraversalProvider.CanTraverse(path,from,to). This allows you to control not only which nodes are traversable, but also which connections can be used.
Changed some 'internal' access modifiers to 'public' or 'protected' on the Path class. This makes it easier to create custom path types.
4.3.26 (2020-05-11)
Additional fix for gizmos not working in some scripts. Introduced in 4.3.23.
4.3.25 (2020-05-08)
Fixed no gizmos working in the whole project. Introduced in 4.3.23. This was a very silly bug.
Fixed linecasts on navmesh/recast graphs could fail when the start of the line was close to a steep slope.
Fixed linecasts on navmesh/recast graphs would incorrectly return no obstructions if for example used between two floors of a building that were not connected.
4.3.24 (2020-05-06)
Fixed RichAI trying to traverse an off mesh link twice if the path's endpoint was also the endpoint of an off-mesh link.
Fixed a missing script in the turnbased example scene causing warnings when opening that scene.
4.3.23 (2020-05-04)
The ProceduralGridMover script now has an option for specifying which graph to update.
Fixed conflicting assembly names when used in a project that also has the ALINE package installed.
Fixed a crash when running on iOS.
Fixed opening some example scenes would log a warning about it including the old GUILayer component.
Fixed warnings would be logged when first importing the package on recent version of Unity due to a change in how Unity imports fbx files.
4.3.22 (2020-04-28)
Make DynamicGridObstacle call Physics.SyncTransforms to ensure it has the most up to date data for the collider.
Fixed changing the dimensions of a grid graph and then scanning it again could cause an exception to be thrown (beta regression). Thanks eintopffahrer for reporting the bug.
Removed 'Upgrading serialized data ...' message as it was mostly just annoying.
4.3.21 (2020-04-27)
Fixed layer grid graphs would throw an exception if a graph update added new layers. Thanks antvelm for reporting the bug.
Fixed a race condition when scanning grid graphs that could cause an exception to be thrown or some node data to be invalid.
Fixed Unity would lock up if you tried to scan a grid graph when the Unity Job System was configured to use zero worker threads.
4.3.20 (2020-04-24)
Added a filter parameter to graph linecast methods. This can be used to mark additional nodes as not being traversable by the linecast. See GridGraph.Linecast.
The RaycastModifier now respects which tags are traversable and any ITraversalProvider set on the path.
Fixed GameObject references (like the PointGraph's Root field) would not get serialized properly if the AstarPath component was stored in a prefab.
Fixed layer grid graphs would throw an error if you tried to scan them on a computer with fewer than 4 cpu cores due to how the number of threads were set.
Fixed LayerGridGraphs would throw an error when being scanned for the first time (i.e. they had not existed in the project before). Thanks antvelm for reporting the bug.
4.3.19 (2020-03-30)
Fixed the Optimization tab not working when installing the package using the unity package manager.
4.3.18 (2020-03-30)
Added ai.GetRemainingPath.
Fixed version number not being accurate in the built package (introduced in 4.3.17).
4.3.17 (2020-03-27)
Made the grid graph's collision visualization in the inspector green instead of blue. This is done to make the connection to colliders more clear. The color is also easier to see against the grey background.
Fixed importing the package using the unity package manager would cause the A* inspector to not be able to load since it couldn't find the editor resources folder.
4.3.16 (2020-03-23)
Fixed AIPath/RichAI throwing exceptions when an RVOController on the same object was disabled.
Moved ProceduralGridMover and DynamicGridObstacle out from the ExampleScenes folder to the Utilities folder.
Fixed updating a recast graph with a bounding box that was outside the graph would throw an exception (bug introduced in 4.3.13). Thanks antvelm for reporting this.
Fixed grid graph erosion not working properly (beta regression).
4.3.15 (2020-03-11)
Fixed ai.SetPath did not accept paths if you called it from the OnPathComplete callback for the path.
Changed Seeker.IsDone to return true from within the OnPathComplete callback. Previously it would always return false, which was confusing since the callback explicitly indicates that the path has been calculated.
Fixed compile errors when using the Unity Collections package version 0.6.0-preview or later.
Fixed AIPath/RichAI throwing exceptions when there was an RVOSimulator in the scene but they themselves did not have an RVOController attached (beta regression). Thanks Eran for reporting this.
Fixed paths could sometimes be cancelled without a reason if 'draw gizmos' was disabled on the Seeker component. Thanks Eran for reporting this.
4.3.14 (2020-02-28)
Fixed "Not allowed to access vertices on mesh" exception in Unity 2019.3 which started appearing due to a change in how Unity handles mesh data uploads.
Added a mode for the RecastMeshObj to make objects be completely ignored when scanning recast graphs. This is useful if you are running out of layers in your project.
Fixed implementations of Object.Equals for Int3, Int2, IntRect, Connection and SimpleMovementPlane would throw an exception if compared to an object of a different type. Thanks SilentSin for reporting this bug.
4.3.13 (2020-02-20)
Worked around an IL2CPP bug that caused grid graphs not to work in standalone games. Thanks eintopffahrer for reporting the bug.
Significantly improved performance when updating recast graphs when you are updating many tiles. Thanks Joel for finding the performance regression.
Fixed graphs dissappearing from the scene view during graph updates that take more than one frame. (fixes regression in beta only).
Fixed DynamicGridObstacle logging an error about not having a collider attached even outside of play mode.
4.3.12 (2020-02-14)
Upgrade notes
GridGraph.nodes now has the type GridNodeBase[] instead of GridNode[]. The same is true for the layered grid graph. In most cases everything should work as normal, however if you have been accessing GridNode specific methods or properties on a node you may need to cast the node to a GridNode (or LevelGridNode) to avoid compile errors.
The LayeredGridGraph now only supports 15 layers by default. This is to reduce memory usage for the common case and to reduce code complexity. If this causes issues for your workflow, please let me know in the forum.
The LayeredGridGraph now uses the Burst compiler when scanning.
The LayeredGridGraph now supports 8 neighbours per node instead of 4 as was the case previously.
Added some helper visualizations for the collision settings for the grid graph.
Fixed RVOController layers not working properly. Thanks Foulcloud for finding the bug.
Fixed clicking the Apply button in the Optimization tab would throw an exception in Unity 2019.3. Thanks rey4033 for reporting the bug.
Fixed NodeLink component throwing exceptions when drawing gizmos (beta regression since 4.3.6).
Fixed example scene descriptions not showing up in the Example6 (navmesh) example scene due to using the outdated GUIText component.
Fixed some multithreading race conditions when scanning and updating grid graphs. This could cause exceptions to be thrown.
Better time slicing when scanning grid graphs asynchronously, in particular for large graphs.
Fixed an exception could be thrown when resizing a grid graph to make it smaller.
Improved performance of making small updates to grid graphs a bit due to improved job scheduling performance.
Fixed ProceduralGridMover not working with non-square grid graphs.
ProceduralGridMover now uses the burst code for updating grid graphs. The performance is mostly the same, but usually faster when the graph moves a significant amount.
Fixed graph updates not always picking up physics changes done during the same frame as the update if "Auto Sync Transforms" has been disabled in the Unity physics settings.
Change: LayerGridNode.HasAnyGridConnections is now a property instead of a method.
Added GridNodeBase.HasAnyGridConnections
Removed LayerGridGraph.mergeSpanRange. This was a rarely used and hard to understand setting. Now it is automatically set to half the LayerGridGraph.characterHeight.
Added GridGraph.SetGridShape.
Fixed RVOController.layer showing up as a layer mask instead of a single layer field.
Fixed a null reference exception which could happen in rare cases when using one-way links on point graphs. Thanks Andrea for finding the bug.
Fixed exceptions could be thrown when reducing the dimensions of a grid graph and then scanning again.
Improved performance when scanning graphs in the editor outside of play mode by not searching through assemblies for graph types every time.
Fixed changing the scene and scanning a graph in the same frame may cause the graph to not pick up the latest scene changes if Physics.autoSyncTransforms is disabled.
Fixed RVOController not working if the x axis scale is negative (e.g. a 2D character which has been flipped).
Made AstarData.ClearGraphs public.
4.3.11 (2019-11-22)
Known bugs
Layered grid graphs do not work in this release. They need to be rewritten to use burst first.
Fixed graphs and other gizmos not rendering when using the High-Definition Render Pipeline.
Fixed a crash in the Unity Editor when using a custom render pipeline.
Added a helper window with shortcuts when the GraphUpdateScene object is selected and the Move tool is active.
Fixed a crash when scanning a graph on the WebGL platform and exception support is disabled.
4.3.10 (2019-11-11)
Known bugs
Layered grid graphs do not work in this release. They need to be rewritten to use burst first.
Fixed gizmos not being rendered when using a scriptable render pipeline (e.g. URP or HDRP) instead of Unity's built-in one.
Fixed null reference exception when a navmesh/recast graph is marked as not being affected by navmesh cuts.
Fixed collider faces with the exact same y coordinate as the base of a grid graph would sometimes not get detected.
4.3.9 (2019-11-08)
Upgrade notes
Due to local avoidance now supporting non-planar worlds many internal coordinates have been changed from float2 to float3. If you have been using the RVOController script then you do not need to do anything, however if you have used the internal IAgent interface then you may have to change your code a bit to pass 3D coordiantes instead of 2D ones.
Added support for local avoidance on non-planar worlds (e.g. spherical ones). See Spherical Worlds.
Minor improvements to local avoidance performance.
Fixed off-mesh links sometimes throwing exceptions when disabled. Thanks Foulcloud for reporting this.
4.3.8 (2019-10-22)
Upgrade notes
GraphModifier events and some callbacks on the AstarPath object (e.g. OnGraphsUpdated) have changed semantics. Read below for more info.
OnPostUpdate no longer runs during scan. TODO
Made GridGraph.neighbourGridOffsetsX and neighbourGridOffsetsZ to static readonly members since they data is constant.
Graph updates for grid graphs no longer call the GraphUpdateObject.Apply method, instead the GraphUpdateObject.ApplyJob method is called. If you have been inheriting from the GraphUpdateObject to make custom graph updates you may need to convert your code so that it works with Burst. TODO: Tutorial.
When GraphModifier events and some callbacks like AstarPath.OnGraphsUpdated are actually fired has been inconsistent and not very well (or accurately) documented for a long time. This release makes it more consistent and better documented. Note that this is a breaking change so if you have used any of those callbacks in your code you may want to have a look at the Pathfinding.GraphModifier documentation which describes when all events are fired.
Fixed a number of edge cases with node applying node links and simplified the code for links quite a lot. Hopefully they are more stable now.
4.3.7 (2019-10-21)
Fixed upgrading from an earlier version could cause compiler errors due to UnityPackages not deleting files properly.
Added an option to try harder to simplify the path when using the FunnelModifier. This is the same type of simplification that the RichAI.funnelSimplification option is using.
To be more descriptive all modifiers have had their visible names changed to include "Modifier" (unless it was already included).
Fixed AstarPath.OnGraphsUpdated and GraphModifier.OnGraphsPostUpdate being called before area (see HierarchicalGraph) information had been updated.
Fixed AstarPath.OnGraphsUpdated not being called after NavmeshCut updates.
Fixed GraphModifier.OnGraphsPreUpdate could be called multiple times per update when using navmesh cutting.
Fixed GraphModifier.OnGraphsPreUpdate could be called in the middle of a graph scan. Now graph scans will only send PreScan, PostScan and LatePostScan events.
4.3.6 (2019-10-20)
Note: AIPath/RichAI scripts are a bit slow to turn around in some cases right now due to the new rotation filtering.
Upgrade notes
OnPostUpdate no longer runs during scan. TODO
Made GridGraph.neighbourGridOffsetsX and neighbourGridOffsetsZ to static readonly members since they data is constant.
Graph updates for grid graphs no longer call the GraphUpdateObject.Apply method, instead the GraphUpdateObject.ApplyJob method is called. If you have been inheriting from the GraphUpdateObject to make custom graph updates you may need to convert your code so that it works with Burst. TODO: Tutorial.
Added a new system for grid graph rules. See Grid Graph Rules.
Removed GraphCollision.rayDirection. This option has never been exposed in the inspector and it's not that useful.
Added the property desiredVelocityWithoutLocalAvoidance to the AIPath and RichAI components. This allows you to both read and write the internal velocity of the agent.
The recast graph's position/rotation and size can now be edited using handles in the scene view. Thanks SeithCG for the suggestion.
Fixed weird undo/redo behaviour when editing graph settings. Previously some undo events would not be saved and sometimes you would have to press ctrl+z twice in order to undo a change.
Improved local avoidance performance significantly. This was done both by optimizing some internal algorithms and by switching to using the ORCA algorithm instead of RVO2. The behaviour of agents should remain similar, however a higher symmetry breaking bias may be required in some cases. (setting on the RVOSimulator component).
Switched some components (e.g. AIPath/RichAI/Seeker) to use a custom gizmo drawing library instead of Unity's internal one. This improved performance when you have a lot of agents and makes the lines use high quality anti-aliasing even if the camera does not use any anti-aliasing itself. Please post in the forum if you see any bugs related to this. Gizmo drawing has a surprising number of edge cases.
Optimized graph rendering a bit if multiple scene views/in game cameras are used.
Improved rotation filtering for AIPath/RichAI components. This reduces jitter in the agent's rotation when they are close to standing still. This is particularly important when using local avoidance.
Fixed GraphUpdateScene editor preventing selection of another object by clicking in the scene view. Thanks SeithCG for reporting this.
4.3.5 (2019-08-06)
Note: Some grid graph features are broken at the moment. Primarily the ones involving setting node tags when scanning or updating the graph.
Note: All graphs other than grid graphs may be broken at the moment. This beta is primarily for testing the new burst scanning for grid graphs.
Upgrade notes
OnPostUpdate no longer runs during scan. TODO
Made GridGraph.neighbourGridOffsetsX and neighbourGridOffsetsZ to static readonly members since they data is constant.
Graph updates for grid graphs no longer call the GraphUpdateObject.Apply method, instead the GraphUpdateObject.ApplyJob method is called. If you have been inheriting from the GraphUpdateObject to make custom graph updates you may need to convert your code so that it works with Burst. TODO: Tutorial.
Improved GridGraph performance when scanning and updating. In particular when using the Ray collision testing mode the performance is much better since that can be fully jobified, but other modes are roughly twice as fast as before 4.3 now. Large graph updates are much faster, however really small ones take about the same time or may even be slightly slower due to the overhead of jobifying all the code.
If an RVOController was attached to a GameObject with an AIPath/RichAI component during runtime after the movement script had been initialized then the movement script would previously possibly not find it. This is fixed now and the RVOController notifies the AIPath/RichAI script that it has been attached.
4.3.4 (2019-07-25)
Upgrade notes
Fixed hexagon connection costs were sqrt(3/2)≈1.22 times too large. The connection costs are now approximately 1000*the distance between the nodes, as it should be. For example if you have set the hexagon width to 1 then the cost to move between two adjacent hexagons is now 1000 instead of 1224 like it was before. For almost all users this will not affect anything, however it may improve pathfinding performance a bit. If you have been using penalties on your graph then you may have to divide them by 1.22 to get the same behavior. Similarly if you have been using the ConstantPath to get a set of nodes you may have to divide the maxGScore parameter by 1.22.
Added a visualization for which dimension of the hexagons that is being edited when using a hexagonal grid graph.
Fixed hexagon connection costs were sqrt(3/2)≈1.22 times too large. See the upgrade notes above.
4.3.3 (2019-07-23)
Added Pathfinding.GridGraph.maxStepUsesSlope which improves slope handling significantly in some scenarios. When upgrading this field will be disabled for compatibility reasons, but it will be enabled for all new graphs.
Pathfinding.GridGraph.maxClimb has been renamed to the more descriptive name Pathfinding.GridGraph.maxStepHeight.
4.3.2 (2019-07-16)
RichAI's Funnel Simplification now does a straight line check as the first thing it does. This can help improve both performance and the quality of the path.
Fixed NavmeshBase.Linecast (used by RecastGraph and Navmesh linecast methods) would not fill the trace out parameter with the starting node in case the start point of the linecast was identical to the end point.
Removed support in some shaders for Unity version 5.5 and earlier.
AIPath and RichAI now clear their paths when they are disabled. Not clearing the path has caused some issues when using object pooling and also some other unexpected behavior. If you want to just temporarily disable the movement then use the canMove or isStopped properties.
The SetPath method on all built-in movement scripts can now be passed a null parameter. This will clear the current path of the agent. In earlier versions this caused an exception to be thrown.
Fixed RichAI.remainingDistance could refer to the previous path for one frame after a new path had been calculated.
Fixed AIPath and RichAI scripts sometimes starting with a height of 0.01 when creating a new component in the unity inspector. Now they start with a more reasonable height of 2.0.
The AIBase.usingGravity setter is now protected instead of private which helps when overriding some methods.
The "Show Surface" mode on recast and navmesh graphs is now enabled by default when creating a new graph.
Added a small helper window to the scene view when the A* Inspector is open. I think this should work well with the dark Unity theme as well, but please start a thread in the support forum if something looks off.
4.3.1
Fixed local avoidance could throw exceptions when using Burst and there were fewer than 64 agents. Thanks apolybus for reporting this.
4.3.0
Upgrade notes
This release only works in Unity 2019.3 or later. The code should work in earlier releases, however some example scenes may require unity 2019.3 to load properly.
The AIPath and RichAI scripts no longer use the Update and FixedUpdate methods. Instead a separate script (BatchedEvents) is used which allows all components of a specific type to be processed at once. This is slightly faster and is also required for the AIBase.rvoDensityBehavior implementation. If you have been overriding the Update or FixedUpdate methods you will need to change your code to instead override the OnUpdate method.
Local avoidance has hard collisions enabled by default. If this is not what you want you can disable this in the RVOSimulator component settings. See below for more details.
The Unity WebPlayer target is no longer supported. This target was deprecated in Unity 5.4.
Grid graph scanning now uses the Burst compiler. This improves performance by 10-20% in most cases. The improvement is not that great because the bottleneck is some physics code that can not be put in jobs in the current versions of Unity. The performance of erosion on grid graphs, especially with a large number of iterations, has been greatly increased. This does not affect graph updates at the moment, but in a future update it may.
The system no longer destroys itself in OnApplicationQuit and is instead always destroyed during OnDestroy. Using OnApplicationQuit could cause trouble when the quitting process was cancelled (e.g. using Application.wantsToQuit).
Using managed code stripping even up to the High level is now supported out of the box.
Local avoidance has been rewritten to use the Burst compiler. This greatly improves performance, in many cases by several hundred percent. It is slower to use the burst code with the burst compiler disabled than it is to use the original non-burst code. Since there are still some build targets that can not use the burst compiler, it is possible to disable the burst code and use the old non-burst code.
The RVOSimulator inspector has been improved visually.
Local avoidance now supports more aggressive collision prevention. This is controlled by the RVOSimulator.hardCollisions field. Enabling this will cause the system to try very hard to avoid any kind of agent overlap, similar to how a physics engine would do it. This does not influence agent avoidance when the agents are not overlapping.
RichAI now has a whenReachedDestination field which behaves like the one that the AIPath script has had for some time.
AIPath/RichAI now have options for more intelligently stopping earlier if there are already a lot of agents around the destination (see Pathfinding.AIBase.rvoDensityBehavior). This prevents the agents from walking around endlessly trying to reach the destination when many agents have the same destination. This can only be used together with the local avoidance system, i.e. when there's also an RVOController attached to the character.
Fixed exceptions could be thrown in the editor if the project contains some assemblies that can for some reason not be read. Thanks joshcamas for reporting this.
Changed the automatic graph coloring limits code to ignore nodes that are unwalkable. This improves the contrast when some unwalkable nodes, that are not visible anyway, have very high penalties (or whatever other value you are visualizing in the scene view).
Fixed missing null checks in TriangleMeshNode.GetPortal and TriangleMeshNode.SharedEdge.
The RichAI inspector will now show a helpful warning if one tries to use it in a scene that does not contain a navmesh or recast graph.
Pathfinding.GraphUtilities.GetContours for grid graphs now simplifies the contour more consistently. Previously there could be one or two additional points where the algorithm started to traverse the contour.
4.2.8 (2019-04-29)
Made it possible for nearest node queries on point graphs to find the closest connection instead of just the closest node. This will make it easier to use graphs when you have many long connections. See Pathfinding.PointGraph.nearestNodeDistanceMode.
Improved the Seeker->StartEndModifier's Connection snapping mode. Now it will behave better if the path only moves along a single connection in the graph.
Fixed a crash when deploying for Nintendo Switch due to a Unity bug when setting thread names. Thanks ToastyStoemp for reporting this.
Fixed some compiler warnings in the ObjImporter class that would show up on some platforms.
Fixed GridGraph.CalculateConnectionsForCellAndNeighbours would throw an exception when called with the coordinates for a node on the border of the grid. Thanks davidpare for reporting this.
4.2.7 (2019-04-05)
Significantly improved graph rendering performance for recast graphs when using a very large number of small tiles.
Fixed GridGraph.CountNodes throwing an exception when the graph is not scanned. Now it will return 0.
4.2.6 (2019-03-23)
Fixed AIPath.reachedDestination and RichAI.reachedDestination only worked when the y coordinate of the agent was close to zero... which it of course was in all my tests. Sorry about this silly bug and the headache it may have caused.
Fixed loading a serialized navmesh graph when the source mesh no longer existed would cause the graph to be offset if a navmesh cut was later used to cut it.
4.2.5 (2019-02-14)
Added a new documentation page for how to create and configure graphs during runtime. Creating graphs during runtime.
Added a new documentation page about editing point graph connections manually. Editing graph connections manually.
Fixed exceptions could be thrown if the project contains some assemblies that can for some reason not be read.
Fixed the visualization for unwalkable nodes (red cubes) sometimes disappearing in newer versions of Unity (2018.2+ I think) due to a change in how Time.renderedFrameCount works. Thanks Kevin Jenkins for reporting this.
Fixed applying optimizations (under the Optimizations tab) could cause several error messages to be logged about unsupported platforms in Unity 2018.3 or newer. Thanks NoxMortem for reporting the issue.
Fixed AIPath throwing an exception if it was given a valid path that contained no nodes at all.
Made Path.GetTagPenalty public instead of internal.
Added Pathfinding.ABPath.FakePath.
Worked around a null reference exception bug when using IL2CPP and deploying for iPhone. This is caused by a bug in the IL2CPP compiler.
Fixed custom graph types could not be used if they were in another assembly. Thanks juskelis for reporting this and founderio for finding a fix.
4.2.4 (2018-12-03)
Added an option for which dimension of the hexagon to adjust in the grid graph editor when using the hexagonal mode. This significantly helps with making a hexagonal graph line up with your other game elements as previously you might have had to manually calculate some complicated conversion factors in order to do this.
Fixed loading navmesh graphs from a file could be extremely slow if the graph had been saved with the source mesh field set to a mesh with an empty name and your project had a lot of things in its Resources folder.
Fixed a massive performance regression when using RVO together with IL2CPP and .net 4.6 due to changes in how the .net framework handles locking internally.
Made GraphNode.Destroy public again (it was made internal in 4.2) because without that, it is not possible to make custom graph types.
Made Path.PipelineState, Path.duration and Path.pathID public again (they were made internal in 4.2) because those properties are actually useful even for non-internal use. This also fixes some incompatibility issues with the Node Canvas integration package. Thanks jsaracev and Grofit for reporting this.
4.2.3 (2018-11-07)
Fixed some compiler warnings in the free version on newer versions of Unity.
Fixed a bug which caused point graphs to interpret the nearest node distance limit as being 1/1000th the actual value in the free version of the package and in the pro version when not using the 'optimize for sparse graph' option. This bug caused the point graph example scene to not work in the free version of the package.
4.2.2 (2018-10-25)
Fixed upgrading from an earlier 4.x version to 4.2 could cause compiler errors in some newer versions of Unity because the UnityPackage doesn't import the new directory structure correctly.
4.2.1 (2018-10-23)
Fixed a bug which caused scanning navmesh graphs to throw an exception when using the free version of the package. Thanks Hunted for reporting the bug.
4.2 (2018-10-17)
4.1.17 through 4.1.26 were beta versions, all their changelogs have been merged into this one.
Upgrade notes
This release contains some breaking changes (primarily the pivot point change for characters that you can read about below). This will affect very few users, but I still recommend that you take a backup of your project before upgrading.
Since 4.1.23 the base of the character when using AIPath/RichAI is always at the pivot point of the Transform. This reduces code complexity and improves performance. Most users would already have had configured their characters that way, but in rare cases you may have to adjust your characters a bit (mostly just move them up or down a bit).
When changing some low level fields that can affect the connectivity of the graph such as Pathfinding.MeshNode.connections you must now call Pathfinding.GraphNode.SetConnectivityDirty(). The documentation for all the relevant fields mention this. Currently it only applies to the connection fields on the MeshNode, PointNode and GridNodeBase classes. All high level methods that modify the connectivity do this automatically. Most likely you do not have to change your code.
When updating the graph using a work item, it is no longer necessary to call the QueueFloodFill or FloodFill methods. Due to the hierarchical graph update mentioned below, this is all handled transparently behind the scenes. You should remove any calls to those deprecated methods as they will (for backwards compatibility reasons) force a full recalculation of the connected components which is much slower than what is likely necessary.
Improvements
Converted all comments to XML comments. This will drastically improve intellisense for most users as Doxygen style comments are not supported by that many editors. As the whole codebase has been converted using a script, there is a potential for errors in the translation. Please let me know if you find anything which looks odd or where the intellisense info could be improved.
Improved recast graph scanning speed by up to 60% in the unity editor on Mono2x. Surisingly this optimization doesn't seem to matter much for other compiler backends. This may cause minor changes to your navmesh. If this change causes bad navmeshes to be generated or if it reduces performance, please start a thread in the forum.
The RVOController and AIPath/RichAI scripts now take the scale of the object into account when using their respective height and radius fields. If you have an existing character with a non-unit scale the height and radius fields will automatically be updated to compensate for this scale. However if you are scaling characters during runtime, this may change their behaviour.
Added a new GraphMask struct to represent a set of graphs. Previously graph masks have been represented using pure integers (e.g. in Pathfinding.Seeker.graphMask and Pathfinding.NNConstraint.graphMask). The new struct contains some nice helper methods like Pathfinding.GraphMask.FromGraphName which has been requested by many users.
Added a new documentation page describing the inspector: The A* Inspector.
Added a new documentation page with an overview of the different included movement scripts: Movement scripts.
Added a new property on all movement scripts called reachedDestination. The existing reachedEndOfPath property has some quirks, which are very reasonable when considering how everything works, but are not very intuitive for new users and it can easily lead to quite brittle code. This new property will work as expected for most use cases.
Added a height and radius for the AIPath and RichAI movement scripts. This in turn deprecates the old Pathfinding.AIBase.centerOffset field as it is now implicitly height/2. If an RVOController is attached to the same GameObject, its height and radius will be driven by the movement script's values. The script will try to autodetect reasonable height and radius values from other attached components upon upgrading.
Improved look of all movement script inspectors by grouping the fields into different sections. Also added some validation to prevent invalid field values.
Optimized graph rendering a bit. In particular if multiple scene views/in game cameras are used.
The default graph rendering mode is now 'Solid Color' instead of 'Areas'. This new mode will render the graphs with a single color as the name implies. The Area coloring mode has turned out to sometimes be confusing for new users and it is not useful that often anyway.
Improved performance of small graph updates on large graphs by a very large amount. Previously when making a small update to a large graph, updating the connected components of the graph using a flood fill has been the thing which took the longest time by far. Using a new internal hierarchical graph it is now possible to update large graphs much faster. For example making a small update to a 1024*1024 grid graph is on the order of 30 times faster and is now perfectly reasonable to do in real time (slightly depending on how the graph looks and its settings). The cost of the flood fill was previously offloaded to a separate thread, so it would not always be noticed in the Unity profiler, but it was there and could affect the performance of the game in strange ways. The performance of scanning a graph or updating the whole graph remains roughly the same. For more information about how this works, see Pathfinding.HierarchicalGraph.
Removed small allocation that was previously done for each calculated path on grid graphs.
Pathfinding threads now show up in the Unity Profiler in the Timeline view when using a recent Unity version (2017.3 or higher).
Scanning layered grid graphs is now approximately 2.2x as fast.
Updating layered grid graphs is now approximately 1.5x as fast.
Scanning and updating layered grid graphs now allocates a lot less memory.
Added assembly definition (.asmdef) files to the package and restructured things a bit. This will help cut down on the compilation times in your project. See https://docs.unity3d.com/Manual/ScriptCompilationAssemblyDefinitionFiles.html for more info.
Improved performance of scanning and updating recast graphs, in particular with very large tiles.
Improved performance of get nearest queries on point graphs when not using optimizeForSparseGraph.
Reduced memory usage of local avoidance slightly.
All navmesh/recast graphs now support navmesh cutting out of the box and the TileHandlerHelper component is no longer necessary. If you have a TileHandlerHelper component in your scene you can safely delete it after upgrading.
AIPath/RichAI now has an option for disabling rotation completely. This was possible before as well, but the options you had to set were not entirely intuitive. The inspector has been restructured a bit to improve the ease of use.
Changes
Removed non-generic version of PathPool which has been deprecated since early 2016.
Removed various methods in the AstarMath and Polygon classes which have been deprecated since early 2016.
Removed a few other things that have been deprecated since early 2016.
Removed AstarPath.ScanLoop which has been deprecated since 2015.
Removed IntRect.Rotate and IntRect.Offset because they were not used by any part of the package.
Removed the mostly internal method GraphCollision.Raycast because it was not used by any code in the package.
Changed signature and behavior slightly of the mostly internal method GraphCollision.CheckHeightAll.
Replaced #Pathfinding.LayerGridGraph.SampleCell with the new method #Pathfinding.LayerGridGraph.SampleHeights which does essentially the same thing, but in a more efficient way.
The rotationIn2D option for the built-in movement scripts has been renamed to orientation and is now an enum.
Fixes
Replaced usage of the WWW class with the newer UnityWebRequest in the update checker to avoid a deprecation compiler warning in newer versions of Unity.
Fixed a bug in the A* inspector that could cause the inspector to log errors and look weird in Unity 2018.3b5 and up. Thanks Aisit for reporting the bug.
Fixed a rare race condition that could cause exceptions in various parts of the code due to the StackPool class not being thread safe. Thanks nindim for reporting the issue.
Fixed applying optimizations (under the Optimizations tab) could cause several error messages to be logged about unsupported platforms in Unity 2018.2 or newer and in 2017.4.
Fixed trying to set a tag on a node to a value outside the valid range (0...32) could silently cause very weird behavior as other fields were affected by that.
Fixed minor allocation when calling AstarPath.GetNearest without an NNConstraint.
Fixed a bug introduced in 4.1.22 which could cause a null reference exception to sometimes be thrown when visualizing graphs in the scene view.
Fixed Pathfinding.Path.IsDone could due to a race condition return true a tiny amount of time before the path was actually calculated.
Fixed a bug introduced in 4.1.18 which caused various rotation settings to be hidden in the inspector for the RichAI component.
Fixed removing a movement script from the same component as an RVOController during runtime would not cause the RVOController to stop using the (now destroyed) movement script's position for local avoidance calculations.
Fixed the ObjectPlacer example script which is used in some example scenes would not always update the graph properly after destroying objects. In Unity object destruction is delayed until after the Update loop, but the script did not wait to update the graph until after the object had actually been destroyed. Thanks djzombie for reporting this.
Fixed recalculating a part of a recast graph using a graph update object would not expand the bounding box with the character radius to make sure that all tiles that could be affected by something inside the box were updated.
Worked around occational crashes when using RVO with the IL2CPP backend due to a bug in IL2CPP.
Fixed scanning a recast graph could throw an exception if there was a RecastMeshObj component attached to a GameObject with a MeshFilter that had a null/missing mesh. Thanks ccm for finding the bug.
Fixed FloodPath throwing an exception when starting on a node that isn't connected to any other node. Thanks BulwarkStudios for finding the bug.
Fixed applying optimizations (under the Optimizations tab) could cause several error messages to be logged about unsupported platforms in Unity 2018.1 or newer. Thanks NFMonster for reporting the issue.
Rotation speed and acceleration are now decoupled for AIPath and RichAI. Previously the acceleration limited how quickly the agents could rotate due to how the math for centripetal acceleration works out. This was originally added in 4.1.11, but due to a typo the change was disabled. Now it is properly working.
Fixed GraphModifier.OnGraphsPostUpdate being called multiple times during a single update if multiple tiles were updated due to navmesh cutting. This can significantly improve performance if you are using many off-mesh links or you are using the RVONavmesh component.
Fixed an edge case bug which could cause get nearest node queries on a newly scanned point graph to return older destroyed nodes.
Fixed work items throwing exceptions could cause some internal data to get into an invalid state.
Fixed tree colliders would not be rasterized correctly when using the recast graph and the tree prefabs had been scaled.
Fixed not finding graph types and graph editors from other assemblies than the one which contains the pathfinding system (important when using asmdef files).
Fixed AstarPath.FlushWorkItems always pausing the pathfinding threads even if no work items were queued.
Fixed loading navmesh graphs (and potentially in rare cases: recast graphs) from the cache or from a file could result in bad graph data which confused the funnel modifier which would create very zig-zaggy paths. If you have been experiencing this then just re-save your graphs/regenerate the cache after you have updated and then it should work as it should. Thanks Igor Aherne for reporting this.
4.1.16 (2018-04-26)
Fixed PointNode.ContainsConnection could throw an exception if the node didn't have any connections.
Fixed AILerp's started out with a destination set to (0,0,0) instead of not having a destination set. So if you did not set a destination for it, it would try to move to the world origin.
4.1.15 (2018-04-06)
Fixed RichAI.desiredVelocity always being zero. Thanks sukrit1234 for finding the bug.
Added some video examples to AIPath.pickNextWaypointDist.
Fixed a bug introduced in 4.1.14 which caused scanning recast graphs in the Unity editor to fail with an error sometimes.
Fixed the position returned from querying the closest point on the graph to a point (AstarPath.GetNearest) on layered grid graphs would always be the node center, not the closest point on the node's surface. Thanks Kevin_Jenkins for reporting this. This caused among other things the ClosestOnNode option for the Seeker's StartEndModifier to be identical to the SnapToNode option.
Fixed RVOController.velocity being zero when the game was paused (Time.timeScale = 0).
4.1.14 (2018-03-06)
Fixed Pathfinding.GridNode.ClosestPointOnNode being completely broken. Thanks Ivan for reporting this. This was used internally in some cases when pathfinding on grid graphs. So this fixes a few cases of strange pathfinding results too.
It is now possible to use pathfinding from editor scripts. See Pathfinding from editor scripts.
4.1.13 (2018-03-06)
Fixed LayerGridGraph.GetNode not performing out of bounds checks.
Exposed a public method PointGraph.ConnectNodes which can be useful if you are creating a graph from scratch using e.g PointGraph.AddNode.
Improved the Multiple agent types tutorial.
Improved the Writing a movement script tutorial, among other things it can now also be followed if you are creating a 2D game. The movement script that you write has also been improved.
Improved how the RichAI movement script keeps track of the node it is on. It should now be more stable in some cases, especially when the ground's y-coordinate lines up badly with the y-coordinate of the navmesh.
Added an option to AIPath for constraining the agent to be inside the traversable surface of the graph at all times. I think it should work everywhere without any issues, but please post in the forum if anything seems to break.
Fixed the proper fonts were not imported in the documentation html, so for many browsers it fell back to some other less pretty font.
4.1.12 (2018-02-27)
Fixed right clicking on array elements in the Unity inspector would bring up the 'Show in online documentation' context menu instead of the Unity built-in context menu (which is very useful).
Navmesh assets used in the navmesh graph no longer have to be at the root of the Resources folder, they can be in any subfolder to the Resources folder.
4.1.11 (2018-02-22)
You can now set which graphs an agent should use directly on the Seeker component instead of having to do it through code.
Added tutorial for how to deal with agents of different sizes: Multiple agent types.
Fixed scanning recast graphs could in rare cases throw an exception due to a multithreading race condition. Thanks emrys90 for reporting the bug.
Fixed a regression in 4.0.6 which caused position based penalty to stop working for layered grid graphs. Thanks DougW for reporting the bug.
Rotation speed and acceleration are now decoupled for AIPath and RichAI. Previously the acceleration limited how quickly the agents could rotate due to how the math for centripetal acceleration works out.
Acceleration can now be set to a custom value on the AIPath class. It defaults to a 'Default' mode which calculates an acceleration such that the agent reaches its top speed in about 0.4 seconds. This is the same behaviour that was hardcoded in earlier versions.
Fixed a bug in GraphUtilities.GetContours for grid graphs when the nodes parameter was explicitly passed as non null that could cause some contours not to be generated. Thanks andrewBeers for reporting the bug.
Improved documentation for StartEndModifier.Exactness.
4.1.10 (2018-01-21)
4.1.0 through 4.1.9 were beta versions, all their changelogs have been merged into this one.
Upgrade notes
Fixed the AIPath script with rotationIn2D would rotate so that the Z axis pointed in the -Z direction instead of as is common for Unity 2D objects: to point in the +Z direction.
ALL classes are now inside the Pathfinding namespace to reduce potential naming collisions with other packages. Make sure you have "using Pathfinding;" at the top of your scripts. Previously most scripts have been inside the Pathfinding namespace, but not all of them. The exception is the AstarPath script to avoid breaking too much existing code (and it has a very distinctive name so name collisions are not likely).
Since the API for several movement scripts have been unified (see below), many members of the movement scripts have been deprecated. Your code should continue to work exactly as before (except bugs of course, but if some other behaviour is broken, please start a thread in the forum) but you may get deprecation warnings. In most cases the changes should be very easy to make as the visible changes mostly consist of renames.
A method called SetPath has been added to all movement scripts. This replaces some hacks you could achieve by calling the OnPathComplete method on the movement scripts from other scripts. If you have been doing that you should now call SetPath instead.
Paths calculated with a heuristic scale greater than 1 (the default is 1) might be slightly less optimal compared to before. See below for more information.
The StartEndModifier's raycasting options are now only used if the 'Original' snapping option is used as that's the only one it makes sense for.
The RaycastModifier has changed a bit, so your paths might look slightly different, however in all but very rare cases it should be at least as good as in previous versions.
Linecast methods will now assign the Pathfinding.GraphHitInfo.node field with the last node that was traversed in case no obstacle was hit, previously it was always null.
Multithreading is now enabled by default (1 thread). This may affect you if you have been adding the AstarPath component during runtime using a script, though the change is most likely positive.
The DynamicGridObstacle component will now properly update the graph when the object is deactivated since the object just disappeared and shouldn't block the graph anymore. Previously it only did this if the object was destroyed, not if it was deactivated.
If you have written a custom graph type you may have to change the access modifier on some methods. For example the ScanInternal method has been changed from being public to being protected.
Some internal methods on graphs have been hidden. They should never have been used by user code but in case you have done that anyway you will have to access them using the IGraphInternals or IUpdatableGraph interface now.
Removed some compatibility code for Seekers for when upgrading from version 3.6.7 and earlier (released about 2 years ago). If you are upgrading from a version that old then the 'Valid Tags' field on the Seeker component may get reset to the default value. If you did not use that field then you will not have to do anything.
AIPath now rotates towards actual movement direction when RVO is used.
Improvements
Improved pathfinding performance by around 8% for grid graphs, possibly more for other graph types. This involved removing a special case for when the pathfinding heuristic is not admissable (in short, when A* Inspector -> Settings -> Heuristic Scale was greater than 1). Now paths calculated with the heuristic scale greater than 1 might be slightly less optimal compared to before. If this is important I suggest you reduce the heuristic scale to compensate. Note that as before: a heuristic scale of 1 is the default and if it is greater than 1 then the calculated paths may no longer be the shortest possible ones.
Improved overall pathfinding performance by an additional 10-12% by heavily optimizing some core algorithms.
Improved performance of querying for the closest node to a point when using the PointGraph and optimizeForSparseGraph. The improvements are around 7%.
Unified the API for the included movement scripts (AIPath, RichAI, AILerp) and added a large number of nice properties and functionality.
The IAstarAI interface can now be used with all movement scripts.
To make it easier to migrate from Unity's navmesh system, this interface has been designed to be similar to Unity's NavmeshAgent API.
The interface has several nice properties like: remainingDistance, reachedEndOfPath, pathPending, steeringTarget, isStopped, destination, and many more.
You no longer need to set the destination of an agent using a Transform object, instead you can simply set the destination property. Note that when you upgrade, a new AIDestinationSetter component will be automatically created which has a 'target' field. So your existing code will continue to work.
Improved behavior when AIPath/RichAI characters move down slopes. Previously the way gravity was handled could sometimes lead to a 'bouncing' behavior unless the gravity was very high. Old behavior on the left, new behavior on the right.
Improved the grid graph inspector by adding preconfigured modes for different node shapes: square grids, isometric grids and hexagons. This also reduces clutter in the inspector since irrelevant options can be hidden.
For 2D grid graphs the inspector will now show a single rotation value instead of a full 3D rotation which makes it a lot easier to configure.
Improved the performance of the RaycastModifier significantly. Common speedups on grid graphs range from 2x to 10x.
The RaycastModifier now has a quality enum. The higher quality options use a new algorithm that is about the same performance (or slightly slower) compared to the RaycastModifier in previous versions however it often manages to simplify the path a lot more. The quality of the previous RaycastModifier with default settings corresponds to somewhere between the Low and Medium qualities.
Improved support for HiDPI (retina) screens as well as improved visual coherency for some icons.
Improved the 'eye' icon for when a graph's gizmos are disabled to make it easier to spot.
AIPath now works with point graphs in 2D as well (assuming the 'rotate in 2D' checkbox is enabled).
Improved the performance of the RVONavmesh component when used together with navmesh cutting, especially when many navmesh cuts are moving at the same time.
A warning is now displayed in the editor if one tries to use both the AIDestinationSetter and Patrol components on an agent at the same time.
Improved linecasts on recast/navmesh graphs. They are now more accurate (there were some edge cases that previously could cause it to fail) and faster. Performance has been improved by by around 3x for longer linecasts and 1.4x for shorter ones.
Linecast methods will now assign the Pathfinding.GraphHitInfo.node field with the last node that was traversed in case no obstacle was hit.
Linecast on graphs now set the hit point to the endpoint of the line if no obstacle was hit. Previously the endpoint would be set to Vector3.zero. Thanks borluse for suggesting this.
Multithreading is now enabled by default (1 thread).
The DynamicGridObstacle component now works with 2D colliders.
Clicking on the graph name in the inspector will no longer focus the name text field. To edit the graph name you will now have to click the Edit/Pen button to the right of the graph name. Previously it was easy to focus the text field by mistake when you actually wanted to show the graph settings.
Reduced memory usage of the PointGraph when using optimizeForSparseGraph.
Improved the StartEndModifier inspector slightly.
The Seeker inspector now has support for multi-editing.
The AIPath and RichAI scripts now rotate to face the direction they are actually moving with when using local avoidance (RVO) instead of always facing the direction they want to move with. At very low speeds they fall back to looking the direction they want to move with to avoid jitter.
Improved the Seeker inspector. Unified the UI for setting tag penalties and determining if a tag should be traversable.
Reduced string allocations for error messages when paths fail.
Added support for 2D physics to the Pathfinding.RaycastModifier component.
Improved performance of GraphUpdateObjects with updatePhysics=false on rotated navmesh/recast graphs.
Improved the inspector for AILerp.
RVO obstacles can now be visualized by enabling the 'Draw Obstacles' checkbox on the RVOSimulator component.
Reduced allocations in the funnel modifier.
Added a 'filter' parameter to PathUtilities.BFS and PathUtilities.GetReachableNodes.
Added a method called SetPath to all movement scripts.
Added GraphNode.Graph.
Added Pathfinding.MeshNode.ContainsPoint(Vector3) in addition to the already existing MeshNode.ContainsPoint(Int3).
Added Pathfinding.AstarData.FindGraph(predicate).
Added Pathfinding.AstarData.FindGraphWhichInheritsFrom(type).
Added a new class GraphUtilities which has some utilities for extracting contours of graphs.
Added a new method Linecast(GridNodeBase,GridNodeBase) to the GridGraph class which is much faster than the normal Linecast methods.
Added GridGraph.GetNode(int,int).
Added MeshNode.AddConnection(node,cost,edge) in addition to the already existing AddConnection(node,cost) method.
Added a setting to the navmesh graph for using the original mesh normals. This is useful for spherical/curved worlds.DocumentationAdded a documentation page on error messages: error-messages.Added a tutorial on how to create a wandering AI: wander.Added tutorial on bitmasks: bitmasks.You can now right-click on most fields in the Unity Inspector to bring up a link to the online documentation.
Various other documentation improvements and fixes.ChangesHeight or collision testing for grid graphs now never hits triggers, regardless of the Unity Physics setting 'Queries Hit Triggers' which has previously controlled this.Seeker.StartPath will no longer overwrite the path's graphMask unless it was explicitly passed as a parameter to the StartPath method.The built in movement scripts no longer uses a coroutine for scheduling path recalculations. This shouldn't have any impact for you unless you have been modifying those scripts.Replaced the MineBotAI script that has been used in the tutorials with MineBotAnimation. The new script does not inherit from AIPath so in the example scenes there is now one AIPath component and one MineBotAnimation script on each unit.Removed prompt to make the package support UnityScript which would show up the first time you used the package in a new project. Few people use UnityScript nowadays so that prompt was mostly annoying. UnityScript support can still be enabled, see javscript.If deserialization fails, the graph data will no longer be stored in a backup byte array to be able to be recovered later. This was not very useful, but more importantly if the graph data was very large (several megabytes) then Unity's Undo system would choke on it and essentially freeze the Unity editor.The StartEndModifier's raycasting options are now only used if the 'Original' snapping option is used as that's the only one it makes sense for.The RaycastModifier.subdivideEveryIter field has been removed, this is now always enabled except for the lowest quality setting.The RaycastModifier.iterations field has been removed. The number of iterations is now controlled by the quality field. Unfortunately this setting cannot be directly mapped to a quality value, so if you are upgrading all RaycastModifier components will use the quality Medium after the upgrade.The default value for Pathfinding.RVOController.lockWhenNotMoving RVOController.lockWhenNotMoving is now false.Tiles are now enabled by default on recast graphs.
Modifiers now register/unregister themselves with the Seeker component during OnEnable/OnDisable instead of Awake/OnDestroy. If you have written any custom modifiers which defines those methods you may have to add the 'override' modifier to those methods and call base.OnEnable/OnDisable.
When paths fail this is now always logged as a warning in the Unity console instead of a normal log message.
Node connections now store which edge of the node shape that is used for that node. This is used for navmesh/recast graphs.
The velocity property on the RVOController can now be assigned to and that has the same effect as calling ForceSetVelocity.
Deprecated the RVOController.ForceSetVelocity method. You should use the velocity property instead.
All graphs now explicitly implement the IUpdatableGraph interface. This is done to hide those methods (which should not be used directly) and thereby reduce confusion about which methods should be used to update graphs.
Hid several internal methods behind the IGraphInternals interface to reduce clutter in the documentation and IntelliSense suggestions.
Removed NavGraph.UnloadGizmoMeshes because it was not used for anything.
Since 4.0 individual graphs can be scanned using AstarPath.Scan. The older NavGraph.Scan method now redirects to that method which is more robust. This may cause slight changes in behavior, however the recommendation in the documentation has always been to use AstarPath.Scan anyway so I do not expect many to have used the NavGraph.Scan method.
Deprecated the NavGraph.ScanGraph method since it just does the same thing as NavGraph.Scan.
Deprecated the internal methods Path.LogError and Path.Log.
Added the new internal method Path.FailWithError which replaces LogError and Log.
Made the AIPath.TrySearchPath method private, it should never have been public to begin with.
Fixes
Fixed AIPath/RichAI throwing exceptions in the Unity Editor when drawing gizmos if the game starts while they are enabled in a disabled gameObject.
Fixed some typos in the documentation for PathUtilities.BFS and PathUtilities.GetReachableNodes.
For some point graph settings, path requests to points that could not be reached would fail completely instead of going to the closest node that it could reach. Thanks BYELIK for reporting this bug. If you for some reason have been relying on the old buggy behavior you can emulate it by setting A* Inspector -> Settings -> Max Nearest Node Distance to a very low value.
Fixed connection costs were assumed to be equal in both directions for bidirectional connections.
Fixed a compiler error when building for UWP/HoloLens.
Fixed some cases where circles used for debugging could have a much lower resolution than intended (#Pathfinding.Util.Draw.CircleXZ).
Fixed RVO agents which were locked but some script sent it movement commands would cause the RVO system to think it was moving even though it was actually stationary, causing some odd behavior. Now locked agents are always treated as stationary.
Fixed RVO obstacles generated from graph borders (using the RVONavmesh component) could be incorrect if a tiled recast graph and navmesh cutting was used. The bug resulted in an RVO obstacle around the tile that was most recently updated by a navmesh cut even where there should be no obstacle.
Fixed the RVONavmesh component could throw an exception in some cases when using tiled recast graphs.
Fixed a regression in some 4.0.x version where setting RVOController.velocity to make the agent's movement externally controlled would not work properly (the system would always think the agent had a velocity of zero).
Fixed the RichAI movement script could sometimes get stuck on the border between two tiles. (due to a possibility of division by zero that would cause its velocity to become NaN).
Fixed AIPath/RichAI movement not working properly with rigidbodies in Unity 2017.3+ when the new physics setting "Auto Sync Transforms" was disabled. Thanks DougW for reporting this and coming up with a fix.
Fixed a few cases where RichAI would automatically recalculate its path even though canSearch was disabled.
Fixed some compiler warnings when using Unity 2017.3 or later.
Fixed graphical artifacts in the graph visualization line drawing code which could show up at very large coordinate values or steep viewing angles. Differential calculus can be really useful sometimes.
Fixed the MultiTargetPathExample.cs.
Fixed the width/depth fields in the recast graph inspector causing warnings to be logged (introduced in 4.1.7). Thanks NoxMortem for reporting this.
Fixed the Pathfinding.GraphHitInfo.tangentOrigin field was offset by half a node when using linecasting on grid graphs.
Fixed the AIPath script with rotationIn2D would rotate so that the Z axis pointed in the -Z direction instead of as is common for Unity 2D objects: to point in the +Z direction.
Fixed the AILerp script with rotationIn2D would rotate incorrectly if it started out with the Z axis pointed in the -Z direction.
Clamp recast graph bounding box size to be non-zero on all axes.
The DynamicGridObstacle component will now properly update the graph when the object is deactivated since the object just disappeared and shouldn't block the graph anymore. Previously it only did this if the object was destroyed, not if it was deactivated.
Fixed AILerp ceasing to work properly if one of the paths it tries to calculate fails.
Fixed the FunnelModifier could yield a zero length path in some rare circumstances when using custom node links. This could lead to an exception in some of the movement scripts. Thanks DougW for reporting the bug.
Fixed calling Seeker.CancelCurrentPathRequest could in some cases cause an exception to be thrown due to multithreading race conditions.
Fixed a multithreading race condition which could cause a path canceled by Seeker.CancelCurrentPathRequest to not actually be canceled.
Fixed a rare ArrayOutOfBoundsException when using the FunnelModifier with the 'unwrap' option enabled.
Fixed Seeker -> Start End Modifier could not be expanded in the Unity inspector. Thanks Dee_Lucky for reporting this.
Fixed a few compatiblity bugs relating to AIPath/RichAI that were introduced in 4.1.0.
Fixed funnel modifier could sometimes fail if the agent started exactly on the border between two nodes.
Fixed another bug which could cause the funnel modifier to produce incorrect results (it was checking for colinearity of points in 2D instead of in 3D).
Fixed the funnel modifier would sometimes clip a corner near the end of the path.
Fixed ProceduralGridMover would not detect user defined graphs that were subclasses of the GridGraph class. Thanks viveleroi for reporting this.
Fixed enabling and disabling a AIPath or RichAI component a very large number of times could potentially have a negative performance impact.
Fixed AIPath/RichAI would continue searching for paths even when the component had been disabled.
MeshNode.ContainsPoint now supports rotated graphs properly. MeshNode is used in navmesh and recast graphs.
Fixed Linecast for navmesh and recast graphs not working for rotated graphs.
Fixed RVONavmesh component not working properly with grid graphs that had height differences.
Fixed 2D RVO agents sometimes ignoring obstacles.
Fixed RVONavmesh not removing the obstacles it had created when the component was disabled.
Fixed RaycastModifier could miss obstacles when thick raycasting was used due to Unity's Physics.SphereCast method not reporting hits very close to the start of the raycast.
In the free version the inspector for RaycastModifier now displays a warning if graph raycasting is enabled since for all built-in graphs raycasts are only supported in the pro version.
Fixed some cases where the funnel modifier would produce incorrect results.
Fixed typo in a private method in the AstarPath class. Renamed the UpdateGraphsInteral method to UpdateGraphsInternal.
Fixed AIPath.remainingDistance and AIPath.targetReached could be incorrect for 1 frame when a new path had just been calculated (introduced in a previous beta release).
4.0.11 (2017-09-09)
Fixed paths would ignore the ITraversalProvider (used for the turn based utilities) on the first node of the path, resulting in successful paths where they should have failed.
Fixed BlockManager.BlockMode.AllExceptSelector could often produce incorrect results. Thanks Cquels for spotting the bug.
Fixed various bugs related to destroying/adding graphs that could cause exceptions. Thanks DougW for reporting this.
Fixed destroying a grid graph would not correctly clear all custom connections. Thanks DougW for reporting this.
Fixed the MultiTargetPath did not reset all fields to their default values when using path pooling.
Added some additional error validation in the MultiTargetPath class.
Fixed scanning a recast graph that was not using tiles using Unity 2017.1 or later on Windows could block indefinitely. Thanks David Drummond and ceebeee for reporting this.
Improved compatibility with Nintendo Switch. Thanks Noogy for the help.
Fixed GraphUpdateScene would not handle the GameObject's scale properly which could cause it to not update some nodes.
Fixed a regression in 4.0 which could cause the error to be omitted from log messages when paths failed.
Fixed several bugs relating to Pathfinding.NNConstraint.distanceXZ and Pathfinding.NavmeshBase.nearestSearchOnlyXZ. Thanks koirat for reporting this.
Fixed scanning a graph that threw an error would prevent any future scans. Thanks Baste for reporting this.
Added a new get started video tutorial. See Get Started With The A* Pathfinding Project.
The PointGraph.nodeCount property is now protected instead of private, which fixes some compatibility issues.
Improved compatibility with Unity 2017.1, esp. when using the experimental .Net 4.6 target. Thanks Scott_Richmond for reporting the issues.
Fixed DynamicGridObstacle trying to update the graphs even when outside of play mode.
Fixed runtime error when targeting the Windows Store. Thanks cedtat for reporting the bug.
Fixed compilation error when targeting the Windows Store. Introduced in 4.0.3. Thanks cedtat for reporting the bug.
4.0.10 (2017-05-01)
Fixed compiler errors in the free version because the ManualRVOAgent.cs script being included by mistake. Thanks hummerbummer for reporting the issue.
Fixed Unity's scene view picking being blocked by graph gizmos. Thanks Scott_Richmond for reporting the bug.
4.0.9 (2017-04-28)
Significantly improved performance and reduced allocations when recalculating indivudal recast tiles during runtime and there are terrains in the scene.
Fixed the GraphUpdateScene inspector showing a warning for one frame after the 'convex' field has been changed.
Fixed a few compiler warnings in Unity 5.6. Thanks TotalXep for reporting the issue.
Fixed graph drawing could generate large amounts of garbage due to a missing GetHashCode override which causes Mono to have to allocate some dummy objects.
Fixed graph gizmo lines could be rendered incorrectly on Unity 5.6 on mac and possibly on Windows too.
4.0.8 (2017-04-28)
Added rotationIn2D to the AIPath script. It makes it possible to use the Y axis as the forward axis of the character which is useful for 2D games.
Exposed the GridGraph.LayerCount property which works for both grid graphs and layered grid graphs (for grid graphs it always returns 1).
Made the LayerGridGraph.layerCount field internal to discourage its use outside the LayerGridGraph class.
Fixed exception when destroying some graph types (introduced in 4.0.6). Thanks unfalco for reporting the bug.
Fixed exception in GridGraph.GetNodesInRegion when being called with an invalid rectangle or a rectangle or bounds object that was completely outside the graph. Thanks WillG for finding the bug.
Fixed AIPath/RichAI not rotating to the correct direction if they started in a rotation such that the forward axis was perpendicular to the movement plane.
4.0.7 (2017-04-27)
Fixed 2D example scenes had their grids rotated by (90,0,0) instead of (-90,0,0). It doesn't matter for those scenes, but the (-90,0,0) leads to more intuitive axis rotations for most use cases. Thanks GeloMan for noticing this.
Renamed AISimpleLerp to AILerp in the component menu as the documentation only refers to it by the name 'AILerp'.
Added a new documentation page and video tutorial (Pathfinding in 2D) showing how to configure pathfinding in 2D games.
4.0.6 (2017-04-21)
Fixed creating a RichAI and in the same frame setting the target and calling UpdatePath would always result in that path being canceled.
Fixed a race condition which meant that if you called RichAI.UpdatePath, AILerp.SearchPath or AIPath.SearchPath during the same frame that the agent was created then the callback for that path would sometimes be missed and the AI would wait indefinitely for it. This could cause the agents to sometimes never start moving.
Fixed adding a new graph while graph updates were running at the same time could potentially cause errors.
Added NavGraph.exists which will become false when a graph has been destroyed.
Fixed TileHandlerHelper could throw exceptions if the graph it was tracking was destroyed.
Fixed TileHandlerHelper not detecting new NavmeshCut or NavmeshAdd components that were created before the TileHandlerHelper component was created or when it was disabled.
TileHandlerHelper no longer logs an error if it is created before a recast/navmesh graph exists in the scene and when one is created the TileHandlerHelper will automatically detect it and start to update it.
Fixed TileHandlerHelper could throw exceptions if the graph it was tracking changed dimensions.
Fixed recast graphs would always rasterize capsule colliders as if they had their 'direction' setting set to 'Y-axis'. Thanks emrys90 for reporting the bug.
The package now contains a 'documentation.html' file which contains an offline version of the 'Get Started' tutorial.
4.0.5 (2017-04-18)
Improved compatibility with Opsive's Behavior Designer - Movement Pack (https://www.assetstore.unity3d.com/en/#!/content/16853).
The 4.0 update combined with the Movement Pack caused some compiler errors previously.
4.0.4 (2017-04-17)
Fixed the funnel modifier not working if 'Add Points' on the Seeker's Start End Modifier was enabled. Thanks Blaze_Barclay for reporting it.
Fixed code typo in the Writing Modifiers tutorial as well as made a few smaller improvements to it.
Fixed some cases where the LegacyRVOController would not behave like the RVOController before version 4.0.
Fixed LegacyAIPath not using the same custom inspector as the AIPath component.
4.0.3 (2017-04-16)
Improved code style and improved documentation for some classes.
Reduced memory allocations a bit when using the NavmeshAdd component.
Fixed graph types not necessarily being initialized when scanning the graph outside of play mode.
Fixed LayerGridGraph not reporting scanning progress properly. This caused it to not work well with ScanAsync and when scanning the graph in the editor the progress bar would only update once the whole graph had been scanned.
Removed the DebugUtility class which was only used for development when debugging the recast graph.
4.0.2 (2017-04-16)
Fixed a minor bug in the update checker.
Deduplicated code for drawing circles and other shapes using Debug.Draw* or Gizmos.Draw* and moved this code to a new class Pathfinding.Util.Draw.
4.0.1 (2017-04-15)
Improved how AIPath and RichAI work with rigidbodies.
Added option for gravity to AIPath.
Removed the RichAI.raycastingForGroundPlacement field as it is automatically enabled now if any gravity is used.
AIPath and RichAI now inherit from the same base class Pathfinding.AIBase.
4.0 (2017-04-10)
Upgrade Notes
This release contains some significant changes. It is strongly recommended that you back up your project before upgrading.
If you get errors immediately after upgrading, try to delete the AstarPathfindingProject folder and import the package again. Sometimes UnityPackages will leave old files which can cause issues.
Moved some things to inside the Pathfinding namespace to avoid naming collisions with other packages. Make sure you have the line 'using Pathfinding;' at the top of your scripts. Some example scripts have been moved to the Pathfinding.Examples namespace.
The RVOController component no longer handles movement as it turned out that was a bad idea. Having multiple components that handled movement (e.g RichAI and RVOController) didn't turn out well and it was very hard to configure the settings so that it worked well. The RVOController now exposes the CalculateMovementDelta method which allows other scripts to ask it how the local avoidance system thinks the character should move during this frame. If you use the RichAI or AIPath components for movement, everything should work straight away. If you use a custom movement script you may need to change your code to use the CalculateMovementDelta method for movement. Some settings may need to be tweaked, but hopefully it should not be too hard.
Node connections are now represented using an array of structs (of type Connection) instead of one array for target nodes and one array for costs.
When upgrading an existing project legacy versions of the RVOController, RichAI, AIPath and GraphUpdateScene components will be used for compatibility reasons. You will have to click a button in the inspector to upgrade them to the latest versions. I have tried to make sure that the movement scripts behave the same as they did before version 4.0, but it is possible that there are some minor differences. If you have used a custom movement script which inherits from AIPath or RichAI then the legacy components cannot be used automatically, instead the new versions will be used from the start.
New Features And Improvements
Local Avoidance
The RVO system has been cleaned up a lot.
Agents will now always avoid walls and obstacles even if that would put them on a collision course with another agent. This helps with a previous problem of agents being able to be pushed into walls and obstacles (note that RVONavmesh or RVOSquareObstacle still need to be used).
The RVOSimulator can now be configured for XZ space or XY space (2D).
The RVOController no longer handles movement itself as this turned out to be a really bad idea (see upgrade notes section).
The RVOController can now be used to stop at a target much more precisely than before using the SetTarget method.
Agents are now biased slightly towards passing other agents on the right side, this helps resolve some situations with a lot of symmetry much faster.
All fuzzy and hard to adjust parameters from the RVOSimulator component have been removed. It should now be much easier to configure.
The RichAI movement script now works a lot better with the RVOController. Previously the movement could be drastically different when the RVOController was used and local avoidance didn't work well when the agent was at the edge of the navmesh.
Improved gizmos for the RVOController.
Added RVOController.ForceSetVelocity to use when you want agents to avoid a player (or otherwise externally controlled) character.
RVO agents can now have different priorities, lower priority agents will avoid higher priority agents more.
The neighbour distance field is now automatically calculated. This makes it easier to configure the agents and it will also improve performance slightly when the agents are moving slowly (for example in very crowded scenarios).
Added support for grid graphs to RVONavmesh.
Added a new example scene for RVO in 2D
General
Huge increase in the performance of graph gizmos. This was accomplished by bypassing the Unity Gizmos and creating a custom gizmo rendererer that is able to retain the gizmo meshes instead of recreating them every frame (as well as using a lot fewer draw calls than Unity Gizmos). Therefore the graphs usually only need to check if the nodes have changed, and only if they have changed they will rebuild the gizmo meshes. This may cause graph updates to seem like they introduce more lag than they actually do since a graph update will also trigger a gizmo rebuild. So make sure to always profile with gizmos disabled. For a 1000*1000 graph, which previously almost froze the editor, the time per frame went from over 4200 ms to around 90 ms when no nodes had changed.
Improved the style of graph gizmos. A solid surface is now rendered instead of only the connections between the nodes. The previous mode of rendering only connections is of course still available.
Added a new example scene showing how to configure hexagon graphs.
Added gizmos for hexagon graphs (grid graphs with certain settings).
Implemented async scanning. AstarPath.active.ScanAsync is an IEnumerable that can be iterated over several frames so that e.g a progress bar can be shown while calculating the graphs. Note that this does not guarantee a good framerate, but at least you can show a progress bar.
Improved behaviour of the AIPath movement script.
AIPath now works in the XY plane as well. In fact it works with any graph rotation. The Z axis is always the forward axis for the agent, so for 2D games with sprites you may have to attach the sprite to a child object which is rotated for it to show up correctly.
Previously the slowdownDistance had to be smaller than the forwardLook field otherwise the character could slow down even when it had not reached the end of the path.
The agent should stop much more precisely at the end of the path now.
The agent now rotates with a fixed angular speed instead of a varying one as this is often more realistic.
Reduced the likelihood of the agent spinning around when it reaches the end of the path.
It no longer uses the forwardLook variable. It was very tricky to set correctly, now the pickNextWaypointDist variable is used for everything instead and generally this should give you smoother movement.
Improved behaviour of the RichAI movement script.
The agent should stop much more precisely at the end of the path now.
Reduced the likelihood of the agent spinning around when it reaches the end of the path.
Scanning the graph using AstarPath.Scan will now profile the various parts of the graph scanning process using the Unity profiler (Profiler.BeginSample and Profiler.EndSample).
DynamicGridObstacle will now update the graph immediately if an object with that component is created during runtime instead of waiting until it was moved for the first time.
GraphUpdateScene and GraphUpdateShape can now handle rotated graphs a lot better. The rotation of the object the GraphUpdateScene component is attached to determines the 'up' direction for the shape and thus which points will be considered to be inside the shape. The world space option had to be removed from GraphUpdateScene because it didn't really work with rotated graphs. The lockToY option for GraphUpdateScene has also been removed because it wasn't very useful and after this change it would only have had an impact in rare cases.
Improved GraphUpdateScene editor. When editing the points in the scene view it now shows helper lines to indicate where a new point is going to be added and which other points it will connect to as well as several other minor improvements.
GraphUpdateScene now supports using the bounds from 2D colliders and the shape from PolygonCollider2D.
Added opaqueness slider for the gizmos under Inspector -> Settings -> Colors.
Added Path.BlockUntilCalculated which is identical to AstarPath.BlockUntilCalculated.
Added Seeker.CancelCurrentPathRequest.
Added NavGraph.GetNodes(System.Action<GraphNode>) which calls a delegate with each node in the graph. Previously NavGraph.GetNodes(GraphNodeDelegateCancelable) existed which did the same thing but required the delegate to return true if it wanted the graph to continue calling it with more nodes. It turns out this functionality was very rarely needed.
Individual graphs can now be scanned using AstarPath.Scan(NavGraph) and other related overloads.
Improved priority queue performance. On average results in about a 2% overall pathfinding performance increase.
ObjectPool<T> now requires a ref parameter when calling Release with an object to help prevent silly bugs.
'Min Area Size' has been removed. The edge cases are now handled automatically.
Added ObjectPoolSimple<T> as a generic object pool (ObjectPool<T> also exists, but for that T must implement IAstarPooledObject).
RaycastModifier now supports multi editing.
Added GraphNode.RandomPointOnSurface .
Added GraphNode.SurfaceArea .
Int2 and Int3 now implement IEquatable for slightly better performance and fewer allocations in some places.
LocalSpaceRichAI can now be used with any rotation (even things like moving on an object that is upside down).
The funnel modifier can now handle arbitrary graphs (even graphs in the 2D plane) if the new unwrap option is enabled.
The funnel modifier can split the resulting path at each portal if the new splitAtEveryPortal option is enabled.
Recast/Navmesh Graphs
Recast graph scanning is now multithreaded which can improve scan times significantly.
Recast graph scanning now handles large worlds with lots of objects better. This can improve scan times significantly.
Improved performance of nearest node queries for Recast/navmesh graphs.
Editing navmesh cut properties in the inspector now forces updates to happen immediately which makes editing easier.
Long edges in recast graphs are now split at tile borders as well as at obstacle borders. This can in particular help on terrain maps where the tile borders do not follow the elevation that well so the max edge length can be reduced to allow the border to follow the elevation of the terrain better.
Recast graphs can now be rotated arbitrarily.
Navmesh cutting still works!
The RichAI script currently does not support movement on rotated graphs, but the AIPath script does.
Improved performance of navmesh cutting for large worlds with many tiles and NavmeshAdd components.
Navmesh graphs and recast graphs now share the same base code which means that navmesh graphs now support everything that previously only recast graphs could be used for, for example navmesh cutting.
The NavmeshCut inspector now shows a warning if no TileHandlerHelper component is present in the scene. A TileHandlerHelper component is necessary for the NavmeshCuts to update the graphs.
Recast graphs now use less memory due to the BBTree class now using around 70% less memory per node.
Recast graphs now allocate slightly less memory when recalculating tiles or scanning the graph.
Cell height on Recast graphs is now automatically set to a good value.
Navmesh cutting is now a bit better at using object pooling to avoid allocations.
TileHandlerHelper now updates the tiles properly when one or multiple tiles on the recast graph are recalculated due to a graph update or because it was rescanned.
Navmesh cutting now uses more pooling to reduce allocations slightly.
Improved performance of loading and updating (using navmesh cutting) recast tiles with a large number of nodes.
Grid Graphs
Added LevelGridNode.XCoordinateInGrid, LevelGridNode.ZCoordinateInGrid, LevelGridNode.LayerCoordinateInGrid.
Added GridGraph.GetNodesInRegion(IntRect). Also works for layered grid graphs.
Layered grid graphs now have support for 'Erosion Uses Tags'.
Added GridGraph.CalculateConnections(GridNodeBase) which can be used for both grid graphs and layered grid graphs.
Grid graphs can now draw the surface and outline of the graph instead of just the connections between the nodes. The inspector now contains several toggles that can be used to switch between the different rendering modes.
The ProceduralGridMover component now works with LayerGridGraph as well.
Added GridGraph.RecalculateCell(x,y) which works both for grid graphs and layered grid graphs. This replaces the UpdateNodePositionCollision method and that method is now deprecated.
Improved GridGraph.RelocateNodes which is now a lot more resilient against floating point errors.
Added dimetric (60°) to the list of default values for the isometric angle field on grid graphs.
Changing the width/depth of a grid graph will now keep the current pivot point at the same position instead of always keeping the bottom left corner fixed. (the pivot point can be changed to the center/bottom left/top left/top right/bottom right right next to the position field in the grid graph inspector)
Improved fluidity and stability when resizing a grid graph in the scene view. It now snaps to full node increments in size.
Grid graphs now display a faint grid pattern in the scene view even when the graph is not scanned to make it easier to position and resize the graph.
Improved styling of some help boxes in the grid graph inspector when using the dark UI skin.
The size of the unwalkable node gizmo (red cube) on grid graphs is now based on the node size to avoid the gizmos being much larger or much smaller than the nodes.
Implemented special case for paths on grid graphs so that if you request a path to an unwalkable node with several walkable nodes around it, it will now not pick the closest walkable node to the requested target point and find a path to that but it will find the shortest path which goes to any of the walkable nodes around the unwalkable node. Before, After . This is a special case of the MultiTargetPath, for more complicated configurations of targets the multi target path needs to be used to be able to handle it correctly.
Changes
Node connections are now represented using an array of structs (of type Connection) instead of one array for target nodes and one array for costs.
When scanning a graph in the editor, the progress bar is not displayed until at least 200 ms has passed. Since displaying the progress bar is pretty slow, this makes scanning small graphs feel more snappy.
GridGraph and LayerGridGraph classes now have a 'transform' field instead of a matrix and inverseMatrix fields. The GraphTransform class also has various other nice utilities.
Moved mesh collecting code for Recast graphs to a separate class to improve readability.
Refactored out large parts of the AstarPath class to separate smaller classes to improve readability and increase encapsulation.
AstarPath.RegisterSafeUpdate is now implemented using WorkItems. This yields a slightly different behavior (previously callbacks added using RegisterSafeUpdate would always be executed before work items), but that should rarely be something that you would depend on.
Replaced AstarPath.BlockUntilPathQueueBlocked with the more robust AstarPath.PausePathfinding method.
The default radius, height and center for RVOControllers is now 0.5, 2 and 1 respectively.
To reduce confusion. The second area color is now a greenish color instead of a red one. The red color would often be mistaken as indicating unwalkable nodes instead of simply a different connected component. Hopefully green will be a more neutral color.
Renamed AstarPath.astarData to AstarPath.data.
Renamed NavmeshCut.useRotation and NavmeshAdd.useRotation to useRotationAndScale (since they have always affected scale too).
Renamed GridGraph.GenerateMatrix to GridGraph.UpdateTransform to be consistent with recast/navmesh graphs. The GenerateMatrix method is now deprecated.
Renamed AstarPath.WaitForPath to AstarPath.BlockUntilCalculated.
Renamed GridNode.GetConnectionInternal to HasConnectionInDirection.
Renamed NNInfo.clampedPosition to NNInfo.position.
Renamed GridGraph.GetNodesInArea to GetNodesInRegion to avoid confusing the word 'area' for what is used to indicate different connected components in graphs.
Renamed AIPath.turningSpeed to rotationSpeed.
Deprecated Seeker.GetNewPath.
Deprecated NavGraph.matrix, NavGraph.inverseMatrix, NavGraph.SetMatrix and NavGraph.RelocateNodes(Matrix4x4,Matrix4x4). They have been replaced with a single transform field only available on some graph types as well as a few other overloads of teh RelocateNodes method.
Changed the signature of NavGraph.GetNodes(GraphNodeDelegateCancelable) to the equivalent NavGraph.GetNodes(System.Func<GraphNode,bool>).
Replaced all instances of GraphNodeDelegate with the equivalent type System.Action<GraphNode>.
Made a large number of previously public methods internal to reduce confusion about which methods one should use in a class and make the documentation easier to read. In particular the Path class has had its set of public methods reduced a lot.
Made AstarData.AddGraph(NavGraph) private. Scripts should use AstarData.AddGraph(System.Type) instead.
Moved internal fields of NNInfo into a new NNInfoInternal struct to make the API easier to use. Previously NNInfo contained some internal fields, but now they are only in NNInfoInternal.
Moved GetNeighbourAlongDirection to GridNodeBase and made it public.
An overload of the GridGraph.CalculateConnections method has been made non-static.
LayerGridGraph.LinkedLevelNode and LayerGridGraph.LinkedLevelCell are now private classes since they are only used by the LayerGridGraph.
MonoModifier.OnDestroy is now a virtual function.
AstarPath.IsUsingMultithreading and NumbParallelThreads have been made non-static.
AstarPath.inGameDebugPath is now private.
AstarPath.lastScanTime is now read only.
Removed the 'climb axis' field from grid graphs. The axis is now automatically set to the graph's UP direction (which is the only direction that makes sense and all other directions can be transformed to this one anyway).
Removed the 'worldSpace' parameter from RecastGraph.ReplaceTile, it is no longer possible to supply world space vertices to that method since graph space vertices are required for some things.
Removed BBTree.QueryCircle and BBTree.Query since they were not used anywhere.
Removed the Path.searchIterations field because it wasn't very useful even as debug information.
Removed the Path.maxFrameTime field because it was not used.
Removed the Path.callTime property because it was not used.
Removed the ABPath.startHint, ABPath.endHint fields because they were not used.
Removed the ABPath.recalcStartEndCosts field because it was not used.
Removed the RecursiveBinary and RecursiveTrinary modes for RichAI.funnelSimplification because the Iterative mode was usually the best and fastest anyway (also the other two modes had a rare bug where they could get cought in infinite loops).
Removed the Polygon.Subdivide method because it was not used anywhere.
Removed the NavGraph.Awake method because it was not used for anything.
Removed ASTAR_OPTIMIZE_POOLING from Optimization tab. It is now always enabled in standalone builds and always disabled in the Unity editor.
Removed various unused Recast code.
Removed support for forcing the inspector skin to be dark or light. The value provided by EditorGUIUtility.isProSkin is always used now.
Removed multiplication operator for Int3 with a Vector3 because it is a nonstandard operation on vectors (and it is not that useful).
Removed the since long deprecated example script AIFollow.
Removed the AdaptiveSampling algorithm for local avoidance. Only GradientDescent is used now.
Removed empty PostProcess method in NavMeshGraph.
Fixes
Fixed RichAI and AIPath trying to use CharacterControllers even if the CharacterController component was disabled.
Fixed rotated recast/navmesh graphs would ensure each node's vertices were laid out clockwise in XZ space instead of in graph space which could cause parts of the graph to become disconnected from the rest.
Fixed a bug where graphs could fail to be deserialized correctly if the graph list contained a null element
Fixed a bug where the json serializer could emit True/False instead of true/false which is the proper json formatting.
Fixed LayerGridGraphs' "max climb" setting not working properly with rotated graphs.
Fixed LayerGridGraphs' "character height" setting not working properly with rotated graphs.
Fixed LayerGridGraphs assuming there were no obstacles nearby if no ground was found.
Fixed DynamicGridObstacle getting caught in an infinite loop if there was no AstarPath component in the scene when it was created. Thanks MeiChen for finding the bug.
Fixed NodeLink2 deserialization causing exceptions if the node hadn't linked to anything when it was serialized. Thanks Skalev for finding the bug.
Fixed the AlternativePath modifier could crash the pathfinding threads if it logged a warning since it used the Debug.Log(message,object) overload which can only be used from the Unity thread.
Fixed an issue where layer mask fields in graph editors would show 'Nothing' if they only included layers which had no name set.
Fixed potential memory leak. Paths in the path pool would still store the callback which is called when the path has been calculated which that means it would implicitly hold a reference to the object which had the method that would be called. Thanks sehee for pointing this out.
Fixed GridNode.ClosestPointOnNode could sometimes return the wrong y coordinate relative to the graph (in particular when the graph was rotated) and the y coordinate would not snap to the node's surface.
Fixed AstarData.AddGraph would fill *all* empty slots in the graph array with the graph instead of just the first. Thanks bitwise for finding the bug.
Improved compatibility with Unity 5.5 which was need due to the newly introduced UnityEngine.Profiling namespace.
Fixed graph updates on LayeredGridGraphs not respecting GraphUpdateObject.resetPenaltyOnPhysics.
Fixed potential memory leak when calling RecalculateCell on a layered grid graph.
LevelGridNode.ContainsConnection now reports correct values (previously it would only check non-grid connections).
Fixed not being able to deserialize settings saved with some old versions of the A* Pathfinding Project.
Tweaked ListPool to avoid returning lists with a very large capacity when a small one was requested as this could cause performance problems since Clear is O(n) where n is the capacity (not the size of the list).
Fixed GraphUpdateScene causing 'The Grid Graph is not scanned, cannot update area' to be logged when exiting play mode.
Fixed scanning a recast graph could in very rare circumstances throw a 'You are trying to pool a list twice' exception due to a multithreading race condition.
Fixed recast/navmesh graphs could return the wrong node as the closest one in rare cases, especially near tile borders.
Fixed another case of recast/navmesh graphs in rare cases returning the wrong node as the closest one.
Fixed gizmo drawing with 'Show Search Tree' enabled sometimes right after graph updates drawing nodes outside the search tree as if they were included in it due to leftover data from graph updates.
Fixed navmesh and recast graphs would unnecessarily be serialized by Unity which would slow down the inspector slightly.
Fixed AstarEnumFlagDrawer not working with private fields that used the [SerializeField] attribute. This does not impact anything that the A* Pathfinding Project used, but some users are using the AstarEnumFlagDrawer for other fields in their projects. Thanks Skalev for the patch.
Clicking 'Apply' in the Optimizations tab will now always refresh the UI instead of assuming that a recompilation will happen (it will not happen if only defines for other platforms than the current one were modified).
Fixed not being able to multi-edit RVOSquareObstacle components.
Fixed GridNode.ClearConnections(true) not removing all reversed connections and could sometimes remove the wrong ones.
Fixed TileHandlerHelper regularly checking for if an update needs to be done even if TileHandlerHelper.updateInterval was negative even though the documentation specifies that it should not do that (it only disabled updates when updateInterval = -1).
Fixed PathUtilities.GetPointsAroundPointWorld and PathUtilities.GetPointsAroundPoint returning incorrect results sometimes.
Fixed Path.immediateCallback not being reset to null when using path pooling.
TileHandlerHelper will now work even if Scan On Awake in A* Inspector -> Settings is false and you are scanning the graph later.
Fixed AstarWorkItem.init could be called multiple times.
Fixed some documentation typos.
Fixed colliders being included twice in the recast rasterization if the GameObject had a RecastMeshObj attached to it which effectively made RecastMeshObj not work well at all with colliders.
Fixed inspector for RecastMeshObj not updating if changes were done to the fields by a script or when an undo or redo was done.
Fixed SimpleSmoothModifier custom editor would sometimes set all instances of a field to the same value when editing multiple objects at the same time.
Fixed division by zero when the TimeScale was zero in the AstarDebugger class. Thanks Booil Jung for reporting the issue.
Various other small fixes in the AstarDebugger class.
Fixed division by zero when generating a recast graph and the cell size was much larger than the bounds of the graph.
Fixed the recast graph data structures could be invalid while a graph update was running in a separate thread. This could cause API calls like AstarPath.GetNearest to throw exceptions. Now the affected tiles are recalculated in a separate thread and then the updates are applied to the existing graph in the Unity thread.
Fixed some cases where the AlternativePath modifier would apply penalties incorrectly and possibly crash the pathfinding thread.
Fixed IAgent.NeighbourCount would sometimes not be reset to 0 when the agent was locked and thus takes into account no other agents.
Fixed RVO threads would sometimes not be terminated which could lead to memory leaks if switching scenes a lot.
Fixed GridGraph.GetNearest and NavGraph.GetNearest not handling constraint=null.
Internal changes
These are changes to the internals of the system and will most likely not have any significant externally visible effects.
Removed some wrapper methods for the heap in the PathHandler class since they were just unnecessary. Exposed the heap field as readonly instead.
Renamed BinaryHeapM to BinaryHeap.
Renamed ExtraMesh to RasterizationMesh.
Refactored TileHandler.CutPoly to reduce code messiness and also fixed some edge case bugs.
Documentation
Among other things: improved the Writing Graph Generators guide (among other things it no longer uses hard to understand calculations to get the index of each node).
3.8.8.1 (2017-01-12)
Fixes
Fixed the 'Optimization' tab sometimes logging errors when clicking Apply on Unity 5.4 and higher.
More UWP fixes (pro version only).
3.8.8 (2017-01-11)
Fixes
Fixed errors when deploying for the Universal Windows Platform (UWP). This includes the Hololens platform.
It is no longer necessary to use the compiler directive ASTAR_NO_ZIP when deploying for UWP. zipping will be handled by the System.IO.Compression.ZipArchive class on those platforms (ZipArchive is not available on other platforms). If you have previously enabled ASTAR_NO_ZIP it will stay enabled to ensure compatibility.
Changed some comments from the '/**<' format to '/**' since Monodevelop shows the wrong docs when using the '/**<' format.
3.8.7 (2016-11-26)
Fixes
Improved compatibility with Unity 5.5 which was needed due to the newly introduced UnityEngine.Profiling namespace.
3.8.6 (2016-10-31)
Upgrade Notes
Note that a few features and some fixes that have been available in the beta releases are not included in this version because they were either not ready to be released or depended on other changes that were not ready.
Dropped support for Unity 5.1.
Moved some things to inside the Pathfinding namespace to avoid naming collisions with other packages. Make sure you have the line 'using Pathfinding;' at the top of your scripts.
Seeker.StartMultiTargetPath will now also set the enabledTags and tagPenalties fields on the path. Similar to what StartPath has done. This has been the intended behaviour from the start, but bugs happen. See http://forum.arongranberg.com/t/multitargetpath-doesnt-support-tag-constraints/2561/3
The JsonFx library is no longer used, so the Pathfinding.JsonFx.dll file in the plugins folder may be removed to reduce the build size a bit. UnityPackages cannot delete files, so you have to delete it manually.
RecastGraph.UpdateArea (along with a few other functions) is now explicitly implemented for the IUpdatableGraph interface as it is usually a bad idea to try to call those methods directly (use AstarPath.UpdateGraphs instead).
AstarPath.FlushWorkItems previously had pretty bad default values for the optional parameters. By default it would not necessarily complete all work items, it would just complete those that took a single frame. This is pretty much never what you actually want so to avoid confusion the default value has been changed.
New Features and Improvements
The JsonFx library is no longer used. Instead a very tiny json serializer and deserializer has been written. In addition to reducing code size and being slightly faster, it also means that users using Windows Phone no longer have to use the ASTAR_NO_JSON compiler directive. I do not have access to a windows phone however, so I have not tested to build it for that platform. If any issues arise I would appreciate if you post them in the forum.
Improved inspector for NavmeshCut.
NodeLink2 can now be used even when using cached startup or when loading serialized data in other ways just as long as the NodeLink2 components are still in the scene.
LevelGridNode now has support for custom non-grid connections (just like GridNode has).
Added GridNode.XCoordinateInGrid and GridNode.ZCoordinateInGrid.
Improved documentation for GraphUpdateShape a bit.
Changes
Removed EditorUtilities.GetMd5Hash since it was not used anywhere.
Deprecated TileHandler.GetTileType and TileHandler.GetTileTypeCount.
Seeker.StartPath now properly handles MultiTargetPath objects as well.
Seeker.StartMultiTargetPath is now deprecated. Note that it will now also set the enabledTags and tagPenalties fields on the path. Similar to what StartPath has done.
Removed GridGraph.bounds since it was not used or set anywhere.
GraphNode.AddConnection will now throw an ArgumentNullException if you try to call it with a null target node.
Made PointGraph.AddChildren and PointGraph.CountChildren protected since it makes no sense for them to be called by other scripts.
Changed how the 'Save & Load' tab looks to make it easier to use.
Renamed 'Path Debug Mode' to 'Graph Coloring' and 'Path Log Mode' to 'Path Logging' in the inspector.
RecastGraph.UpdateArea (along with a few other functions) is now explicitly implemented for the IUpdatableGraph interface as it is usually a bad idea to try to call those methods directly (use AstarPath.UpdateGraphs instead).
Removed ConnectionType enum since it was not used anywhere.
Removed NodeDelegate and GetNextTargetDelegate since they were not used anywhere.
Fixes
Fixed TinyJson not using culture invariant float parsing and printing. This could cause deserialization errors on systems that formatted floats differently.
Fixed the EndingCondition example script.
Fixed speed being multiplied by Time.deltaTime in the AI script in the get started tutorial when it shouldn't have been.
Fixed FunnelModifier could for some very short paths return a straight line even though a corner should have been inserted.
Fixed typo. 'Descent' (as in 'Gradient Descent') was spelled as 'Decent' in some cases. Thanks Brad Grimm for finding the typo.
Fixed some documentation typos.
Fixed some edge cases in RandomPath and FleePath where a node outside the valid range of G scores could be picked in some cases (when it was not necessary to do so).
Fixed editor scripts in some cases changing the editor gui styles instead of copying them which could result in headers in unrelated places in the Unity UI had the wrong sizes. Thanks HP for reporting the bug.
Fixed NavmeshCut causing errors when cutting the navmesh if it was rotated upside down or scaled with a negative scale.
Fixed TriangleMeshNode.ClosestPointOnNodeXZ could sometimes return the wrong point (still on the node surface however). This could lead to characters (esp. when using the RichAI component) teleporting in rare cases. Thanks LordCecil for reporting the bug.
Fixed GridNodes not serializing custom connections.
Fixed nodes could potentially get incorrect graph indices assigned when additive loading was used.
Added proper error message when trying to call RecastGraph.ReplaceTile with a vertex count higher than the upper limit.
Known Bugs
Calling GetNearest when a recast graph is currently being updated on another thread may in some cases result in a null reference exception being thrown. This does not impact navmesh cutting. This bug has been present (but not discovered) in previous releases as well.
Calling GetNearest on point graphs with 'optimizeForSparseGraph' enabled may in some edge cases return the wrong node as being the closest one. It will not be widely off target though and the issue is pretty rare, so for real world use cases it should be fine. This bug has been present (but not discovered) in previous releases as well.
3.8.3 through 3.8.5 were beta versions
3.8.2 (2016-02-29)
Improvements
DynamicGridObstacle now handles rotation and scaling better.
Reduced allocations due to coroutines in DynamicGridObstacle.
Fixes
Fixed AstarPath.limitGraphUpdates not working properly most of the time. In order to keep the most common behaviour after the upgrade, the value of this field will be reset to false when upgrading.
Fixed DynamicGridObstacle not setting the correct bounds at start, so the first move of an object with the DynamicGridObstacle component could leave some nodes unwalkable even though they should not be. Thanks Dima for reporting the bug.
Fixed DynamicGridObstacle stopping to work after the GameObject it is attached to is deactivated and then activated again.
Fixed RVOController not working after reloading the scene due to the C# '??' operator not being equivalent to checking for '== null' (it doesn't use Unity's special comparison check). Thanks Khan-amil for reporting the bug.
Fixed typo in documentation for ProceduralGridMover.floodFill.
Changes
Renamed 'Max Update Frequency' to 'Max Update Interval' in the editor since it has the unit [second], not [1/second].
Renamed AstarPath.limitGraphUpdates to AstarPath.batchGraphUpdates and AstarPath.maxGraphUpdateFreq to AstarPath.graphUpdateBatchingInterval. Hopefully these new names are more descriptive. The documentation for the fields has also been improved slightly.
3.8.1 (2016-02-17)
Improvements
The tag visualization mode for graphs can now use the custom list of colors that can be configured in the inspector. Thanks Arakade for the patch.
Fixes
Recast graphs now handle meshes and colliders with negative scales correctly. Thanks bvance and peted for reporting it.
Fixed GridGraphEditor throwing exceptions when a user had created a custom grid graph class which inherits from GridGraph.
Fixed Seeker.postProcessPath not being called properly. Instead it would throw an exception if the postProcessPath delegate was set to a non-null value. Thanks CodeSpeaker for finding the bug.
3.8 (2016-02-16)
The last version released on the Unity Asset Store was 3.7, so if you are upgrading from that version check out the release notes for 3.7.1 through 3.7.5 as well.
Breaking Changes
For the few users that have written their own Path Modifiers. The 'source' parameter to the Apply method has been removed from the IPathModifier interface. You will need to remove that parameter from your modifiers as well.
Modifier priorities have been removed and the priorities are now set to sensible hard coded values since at least for the included modifiers there really is only one ordering that makes sense (hopefully there is no use case I have forgotten). This may affect your paths if you have used some other modifier order. Hopefully this change will reduce confusion for new users.
New Features and Improvements
Added NodeConnection mode to the StartEndModifier on the Seeker component. This mode will snap the start/end point to a point on the connections of the start/end node. Similar to the Interpolate mode, but more often does what you actually want.
SimpleSmoothModifier now has support for multi editing.
Added a new movement script called AILerp which uses linear interpolation to follow the path. This is good for games which want the agent to follow the path exactly and not use any physics like behaviour. This movement script works in both 2D and 3D.
Added a new 2D example scene which uses the new AILerp movement script.
All scripts now have a HelpURLAttribute so the documentation button at the top left corner of every script inspector now links directly to the documentation.
Recast graphs can now draw the surface of a navmesh in the scene view instead of only the node outlines. Enable it by checking the 'Show mesh surface' toggle in the inspector. Drawing the surface instead of the node outlines is usually faster since it does not use Unity Gizmos which have to rebuild the mesh every frame.
Improved GUI for the tag mask field on the Seeker.
All code is now consistently formatted, utilising the excellent Uncrustify tool.
Added animated gifs to the Recast graph documentation showing how some parameters change the resulting navmesh. If users like this, I will probably follow up and add similar gifs for variables in other classes.
Fixes
Fixed objects in recast graphs being rasterized with an 0.5 voxel offset. Note that this will change how your navmesh is rasterized (but usually for the better), so you may want to make sure it still looks good.
Fixed graph updates to navmesh and recast graphs not checking against the y coordinate of the bounding box properly (introduced in 3.7.5).
Fixed potential bug when loading graphs from a file and one or more of the graphs were null.
Fixed invalid data being saved when calling AstarSerializer.SerializeGraphs with an array that was not equal to the AstarData.graphs array. The AstarSerializer is mostly used internally (and internally it is always called with the AstarData.graphs array). Thanks munkman for reporting this.
Fixed incorrect documentation for GridNode.NodeInGridIndex. Thanks mfjk for reporting it!
Fixed typo in a recast graph log message (where -> were). Thanks bigdaddio for reporting it!
Fixed not making sure the file is writable before writing graph cache files (Perforce could sometimes make it read-only). Thanks Jørgen Tjernø for the patch.
Fixed RVOController always using FindObjectOfType during Awake, causing performance issues in large scenes. Thanks Jørgen Tjernø for the patch.
Removed QuadtreeGraph, AstarParallel, NavMeshRenderer and NavmeshController from the released version. These were internal dev files but due to typos they had been included in the release. It will also automatically refresh itself if the graph has been rescanned with a different number of tiles.
Fixed SimpleSmoothModifier not always including the exact start point of the path.
Fixed ASTAR_GRID_NO_CUSTOM_CONNECTIONS being stripped out of the final build, so that entry in the Optimizations tab didn't actually do anything.
Fixed performance issue with path pooling. If many paths were being calculated and pooled, the performance could be severely reduced unless ASTAR_OPTIMIZE_POOLING was enabled (which it was not by default).
Fixed 3 compiler warnings about using some deprecated Unity methods.
Changes
Recast graphs' 'Snap To Scene' button now snaps to the whole scene instead of the objects that intersect the bounds that are already set. This has been a widely requested change. Thanks Jørgen Tjernø for the patch.
Moved various AstarMath functions to the new class VectorMath and renamed some of them to reduce confusion.
Removed various AstarMath functions because they were either not used or they already exist in e.g Mathf or System.Math. DistancePointSegment2, ComputeVertexHash, Hermite, MapToRange, FormatBytes, MagnitudeXZ, Repeat, Abs, Min, Max, Sign, Clamp, Clamp01, Lerp, RoundToInt.
PathEndingCondition (used with XPath) is now abstract since it doesn't really make any sense to use the default implementation (always returns true).
A 'Recyle' method is no longer required on path classes (reduced boilerplate).
Removed old IFunnelGraph interface since it was not used by anything.
Removed old ConvexMeshNode class since it was not used by anything.
Removed old script NavmeshController since it has been disabled since a few versions.
Removed Int3.DivBy2, Int3.unsafeSqrMagnitude and Int3.NormalizeTo since they were not used anywere.
Removed Int2.sqrMagnitude, Int2.Dot since they were not used anywhere and are prone to overflow (use sqrMagnitudeLong/DotLong instead)
Deprecated Int2.Rotate since it was not used anywhere.
Deprecated Int3.worldMagnitude since it was not used anywhere.
3.7.5 (2015-10-05)
Breaking changes
Graph updates to navmesh and recast graphs now also check that the nodes are contained in the supplied bounding box on the Y axis. If the bounds you have been using were very short along the Y axis, you may have to change them so that they cover the nodes they should update.
Improvements
Added GridNode.ClosestPointOnNode.
Optimized GridGraph.CalculateConnections by approximately 20%. This means slightly faster scans and graph updates.
Changes
Graph updates to navmesh and recast graphs now also check that the nodes are contained in the supplied bounding box on the Y axis. If the bounds you have been using were very short along the Y axis, you may have to change them so that they cover the nodes they should update.
Fixes
Fixed stack overflow exception when a pivot root with no children was assigned in the heuristic optimization settings.
Fixed scanning in the editor could sometimes throw exceptions on new versions of Unity. Exceptions contained the message "Trying to initialize a node when it is not safe to initialize any node". This happened because Unity changed the EditorGUIUtility.DisplayProgressBar function to also call OnSceneGUI and OnDrawGizmos and that interfered with the scanning.
Fixed paths could be returned with invalid nodes if the path was calculated right before a call to AstarPath.Scan() was done. This could result in the funnel modifier becoming really confused and returning a straight line to the target instead of avoiding obstacles.
Fixed sometimes not being able to use the Optimizations tab on newer versions of Unity.
3.7.4 (2015-09-13)
Changes
AIPath now uses the cached transform field in all cases for slightly better performance.
Fixes
Fixed recast/navmesh graphs could in rare cases think that a point on the navmesh was in fact not on the navmesh which could cause odd paths and agents teleporting short distances.
Documentation Fixes
Fixed the Seeker class not appearing in the documentation due to a bug in Doxygen (documentation generator).
3.7.3 (2015-08-18)
Fixed GridGraph->Unwalkable When No Ground used the negated value (true meant false and false meant true). This bug was introduced in 3.7 when some code was refactored. Thanks DrowningMonkeys for reporting it.
3.7.2 (2015-08-06)
Fixed penalties not working on navmesh based graphs (navmesh graphs and recast graphs) due to incorrectly configured compiler directives.
Removed undocumented compiler directive ASTAR_CONSTANT_PENALTY and replaced with ASTAR_NO_TRAVERSAL_COST which can strip out code handling penalties to get slightly better pathfinding performance (still not documented though as it is not really a big performance boost).
3.7.1 (2015-08-01)
Removed a few cases where exceptions where needed to better support WebGL when exception handling is disabled.
Fixed MultiTargetPath could return the wrong path if the target of the path was the same as the start point.
Fixed MultiTargetPath could sometimes throw exceptions when using more than one pathfinding thread.
MultiTargetPath will now set path and vectorPath to the shortest path even if pathsForAll is true.
The log output for MultiTargetPath now contains the length (in nodes) of the shortest path.
Fixed RecastGraph throwing exceptions when trying to rasterize trees with missing (null) prefabs. Now they will simply be ignored.
Removed RecastGraph.bbTree since it was not used for anything (bbTrees are stored inside each tile since a few versions)
Improved performance of loading and updating large recast graph tiles (improved performance of internal AABB tree).
Removed support for the compiler directive ASTAR_OLD_BBTREE.
3.7 (2015-07-22)
The last version that was released on the Unity Asset Store was version 3.6 so if you are upgrading from that version also check out the release notes for 3.6.1 through 3.6.7.
Upgrade notes
ProceduralGridMover.updateDistance is now in nodes instead of world units since this value is a lot less world scale dependant. So the defaults should fit more cases. You may have to adjust it slightly.
Some old parts of the API that has been marked as deprecated long ago have been removed (see below). Some other unused parts of the API that mostly lead to confusion have been removed as well.
Improvements
Rewrote several documentation pages to try to explain concepts better and fixed some old code.
And some other smaller changes.
Added an overload of Pathfinding.PathUtilities.IsPathPossible which takes a tag mask.
XPath now works again.
The ProceduralGridMover component now supports rotated graphs (and all other ways you can transform it, e.g isometric angle and aspect ratio).
Rewrote GridGraph.Linecast to be more accurate and more performant. Previously it used a sampling approach which could cut corners of obstacles slightly and was pretty inefficient.
Linted lots of files to remove trailing whitespace, fix imports, use 'var' when relevant and various other small tweaks.
Added AstarData.layerGridGraph shortcut.
Fixes
Fixed compilation errors for Windows Store. The errors mentioned ThreadPriority and VolatileRead.
Fixed LayerGridGraph.GetNearest sometimes returning the wrong node inside a cell (e.g sometimes it would always return the node with the highest y coordinate).
This did not happen when the node size was close to 1 and the grid was positioned close to the origin. Which it of course was in all my tests (tests are improved now).Fixed GridGraph.Linecast always returning false (no obstacles) when the start point and end point was the same. Now it returns true (obstacle) if the start point was inside an obstacle which makes more sense.
Linecasts on layered grid graphs now use the same implementation as the normal grid graph.
This fixed a TON of bugs. If you relied on the old (buggy) behaviour you might have to change your algorithms a bit. It will now report more accurate hit information as well.Fixed documentation on LayerGridGraph.Linecast saying that it would return false if there was an obstacle in the way when in fact exactly the opposite was true.
Fixed inspector GUI throwing exceptions when two or more grid graphs or layered grid graphs were visible and thickRaycast was enabled on only one of them.
Fixed a few options only relevant for grid graphs were visible in the layered grid graph inspector as well.
Fixed GridGraph.CheckConnection returned the wrong result when neighbours was Four and dir was less than 4.
All compiler directives in the Optimizations tab are now tested during the package build phase. So hopefully none of them should give compiler errors now.
Improved accuracy of intellisense by changing the start of some documentation comments to /** instead of /**< as the later type is handled well by doxygen but apparently not so well by MonoDevelop and VS.
Fixed the editor sometimes incorrectly comparing versions which could cause the 'New Update' window to appear even though no new version was available.
Changes
Removed code only necessary for compatibility with Unity 4.5 and lower.
Removed a lot of internal unused old code.
Renamed GridGraph.GetNodePosition to GridGraph.GraphPointToWorld to avoid confusion.
Renamed 3rd party plugin license files to prevent the Unity Asset Store from detecting those as the license for the whole package.
Changed Seeker.traversableTags to be a simple int instead of a class.
GridNode and LevelGridNode now inherit from a shared base class called GridNodeBase.
Removed support for the compiler directive ConfigureTagsAsMultiple since it was not supported by the whole codebase and it was pretty old.
Marked a few methods in AstarData as deprecated since they used strings instead of types. If string to type conversion is needed it should be done elsewhere.
Removed some methods which have been marked as obsolete for a very long time.
AstarData.GetNode
PathModifier and MonoModifier.ApplyOriginal
Some old variants of PathModifier.Apply
GridGeneratorEditor.ResourcesField
Int3.safeMagnitude and safeSqrMagnitude
GraphUpdateUtilities.IsPathPossible (this has been since long been moved to the PathUtilities class)
All constructors on path classes. The static Construct method should be used instead since that can handle path pooling.
GraphNode.Position, walkable, tags, graphIndex. These had small changes made to their names (if they use upper- or lowercase letters) a long time ago. (for better or for worse, but I want to avoid changing the names now again to avoid breaking peoples' code)
GridNode.GetIndex.
Removed the Node class which has been marked as obsolete a very long time. This class has been renamed to GraphNode to avoid name conflicts.
Removed LocalAvoidanceMover which has been marked as obsolete a very long time. The RVO system has replaced it.
Removed Seeker.ModifierPass.PostProcessOriginal since it was not used. This also caused Seeker.postProcessOriginalPath to be removed.
Removed support for ASTAR_MORE_PATH_IDS because it wasn't really useful, it only increased the memory usage.
Removed Path.height, radius, turnRadius, walkabilityMask and speed since they were dummy variables that have not been used and are better implemented using inheritance anyway. This is also done to reduce confusion for users.
Removed the old local avoidance system which has long since been marked as obsolete and replaced by the RVO based system.
3.6.7 (2015-06-08)
Fixes
Fixed a race condition when OnPathPreSearch and OnPathPostSearch were called. When the AlternativePath modifier was used, this could cause the pathfinding threads to crash with a null reference exception.
3.6.6 (2015-05-27)
Improvements
Point Graphs are now supported when using ASTAR_NO_JSON.
The Optimizations tab now modifies the player settings instead of changing the source files. This is more stable and your settings are now preserved even when you upgrade the system.
The Optimizations tab now works regardless of the directory you have installed the package in. Hopefully the whole project is now directory agnostic, but you never know.
Changes
Switched out OnVoidDelegate for System.Action. You might get a compiler error because of this (for the few that use it) but then just rename your delegate to System.Action.
Fixes
Fixed recast graphs not saving all fields when using ASTAR_NO_JSON.
3.6.5 (2015-05-19)
Fixes
Fixed recast graphs generating odd navmeshes on non-square terrains.
Fixed serialization sometimes failing with the error 'Argument cannot be null' when ASTAR_NO_JSON was enabled.
The 'Walkable Climb' setting on recast graphs is now clamped to be at most equal to 'Walkable Height' because otherwise the navmesh generation can fail in some rare cases.
Changes
Recast graphs now show unwalkable nodes with a red outline instead of their normal colors.
3.6.4 (2015-04-19)
Fixes
Improved compatibility with WIIU and other big-endian platforms.
3.6.3 (2015-04-19)
Fixes
Fixed RVONavmesh not adding obstacles correctly (they were added added, but all agents ignored them).
3.6.2 (2015-04-14)
Fixes
Fixed null reference exception in the PointGraph OnDrawGizmos method.
Fixed a few example scene errors in Unity 5.
3.6.1 (2015-04-06)
Upgrade notes:
The behaviour of NavGraph.RelocateNodes has changed. The oldMatrix was previously treated as the newMatrix and vice versa so you might need to switch the order of your parameters if you are calling it.
Highlights:
Works in WebGL/IL2CPP (Unity 5.0.0p3). At least according to my limited tests.
Implemented RelocateNodes for recast graphs (however it cannot be used on tiled recast graphs).
Added support for hexagon graphs. Enable it by changing the 'Connections' field on a grid graph to 'Six'.
Fixed AstarData.DeserializeGraphsAdditive (thanks tmcsweeney).
Fixed pathfinding threads sometimes not terminating correctly. This would show up as a 'Could not terminate pathfinding thread...' error message.
Added a version of GridGraph.RelocateNodes which takes grid settings instead of a matrix for ease of use.
Changes:
Removed NavGraph.SafeOnDestroy
Removed GridGraph.scans because it is a pretty useless variable.
Removed NavGraph.CreateNodes (and overriden methods) since they were not used.
Made GridGraph.RemoveGridGraphFromStatic private.
Removed NavMeshGraph.DeserializeMeshNodes since it was not used.
Made Seeker.lastCompletedVectorPath, lastCompletedNodePath, OnPathComplete, OnMultiPathComplete, OnPartialPathComplete private since they really shouldn't be used by other scripts.
Removed Seeker.saveGetNearestHints, Seeker.startHint, Seeker.endHint, Seeker.DelayPathStart since they were not used.
Removed unused methods of little use: AstarData.GuidToIndex and AstarData.GuidToGraph.
Removed RecastGraph.vertices and RecastGraph.vectorVertices since they were obsolete and not used.
Removed some old Unity 4.3 and Unity 3 compatibility code.
Recast graphs' 'Snap to scene' button now takes into account the layer mask and the tag mask when snapping, it now also checks terrains and colliders instead of just meshes (thanks Kieran).
Fixes:
Fixed RecastGraph bounds gizmos could sometimes be drawn with the wrong color.
Fixed a rare data race which would cause an exception with the message 'Trying to initialize a node when it is not safe to initialize any nodes' to be thrown
Tweaked Undo behaviour, should be more stable now.
Fixed grid graph editor changing the center field very little every frame (floating point errors) causing an excessive amount of undo items to be created.
Reduced unecessary dirtying of the scene (thanks Ben Hymers).
Fixed RVOCoreSimulator.WallThickness (thanks tmcsweeney).
Fixed recast graph not properly checking for the case where an object had a MeshFilter but no Renderer (thanks 3rinJax).
Fixed disabling ASTAR_RECAST_ARRAY_BASED_LINKED_LIST (now ASTAR_RECAST_CLASS_BASED_LINKED_LIST) would cause compiler errors.
Fixed recast graphs could sometimes voxelize the world incorrectly and the resulting navmesh would have artifacts.
Fixed graphMask code having been removed from the free version in some cases due to old code which treated it as a pro only feature.
Improved compatibility with Xbox One.
Fixed RVOController layer field not working when multiple agents were selected.
Fixed grid nodes not being able to have custom connections in the free version.
Fixed runtime error on PS4.
3.6 (2015-02-02)
Upgrade notes:
Cache data for faster startup is now stored in a separate file.
This reduces the huge lag some users have been experiencing since Unity changed their Undo system.
You will need to open the AstarPath components which used cached startup, go to the save and load tab and press a button labeled "Transfer cache data to a separate file".
Highlights:
Added support for the Jump Point Search algorithm on grid graphs (pro only).
The JPS algorithm can be used to speed up pathfinding on grid graphs *without any penalties or tag weights applied* (it only works on uniformly weighted graphs). It can be several times faster than normal A*. It works best on open areas.Added support for heuristic optimizations (pro only).
This can be applied on any static graph, i.e any graph which does not change. It requires a rather slow preprocessing step so graph updates will be really slow when using this. However when the preprocessing is done, it can speed up pathfinding with an order of magnitude. It works especially well in mazes with lots of options and dead ends.
Combined with JPS (mentioned above) I have seen it perform up to 20x better than regular A* with no heuristic optimizations.Added PointNode.gameObject which will contain the GameObject each node was created from.
Added support for RVO obstacles.
It is by no means perfect at this point, but at least it works.Undo works reasonably well again.
It took a lot of time working around weird Unity behaviours. For example Unity seems to send undo events when dragging items to object fields (why? no idea).Dragging meshes to the NavmeshGraph.SourceMesh field works again.
See fix about undo above.Extended the max number of possible areas (connected components) to 2^17 = 131072 up from 2^10 = 1024.
No memory usage increase, just shuffling bits around.
Deprecated compiler directive ASTAR_MORE_AREASExtended the max number of graphs in the inspector to 256 up from 4 or 32 depending on settings.
No memory usage increase, just shuffling bits around. I still don't recommend that you actually use this many graphs.Added RecastTileUpdate and RecastTileUpdateHandler scripts for easier recast tile updating with good performance.
When using A* Inspector -> Settings -> Debug -> Path Debug Mode = {G,F,H,Penalties} you previously had to set the limits for what should be displayed as "red" in the scene view yourself, this is now optionally automatically calculated. The UI for it has also been improved.
Improvements:
Added penaltyAnglePower to Grid Graph -> Extra -> Penalty from Angle.
This can be used to increase the penalty even more for large angles than for small angles (more than it already does, that is).ASTAR_NO_JSON now works for recast graphs as well.
Added custom inspector for RecastMeshObj, hopefully it will not be as confusing anymore.
Changes:
FleePath now has a default flee strength of 1 to avoid confusion when the FleePath doesn't seem to flee from anything.
Removed some irrelevant defines from the Optimizations tab.
IAgent.Position cannot be changed anymore, instead use the Teleport and SetYPosition methods.
Exposed GraphUpdateObject.changedNodes.
Deprecated the threadSafe paremeter on RegisterSafeUpdate, it is always treated as true now.
The default value for AstarPath.minAreaSize is now 0 since the number of areas (connected component) indices has been greatly increased (see highlights).
Tweaked ProceduralWorld script (used for the "Procedural" example scene) to reduce FPS drops.
Fixes:
AstarPath.FlushGraphUpdates will now complete all graph updates instead of just making sure they have started.
In addition to avoiding confusion, this fixes a rare null reference exception which could happen when using the GraphUpdateUtilities.UpdateGraphsNoBlock method.Fixed some cases where updating recast graphs could throw exceptions. (message begun with "No Voxelizer object. UpdateAreaInit...")
Fixed typo in RVOSimulator. desiredSimulatonFPS -> desiredSimulationFPS.
RVO agents move smoother now (previously their velocity could change widely depending on the fps, the average velocity was correct however)
Fixed an exception which could, with some graph settings, be thrown when deserializing on iPhone when bytecode stripping was enabled.
Fixed a NullReferenceException in MultiTargetPath which was thrown if the path debug mode was set to "Heavy".
Fixed PathUtilies.BFS always returning zero nodes (thanks Ajveach).
Made reverting GraphUpdateObjects work. The GraphUpdateUtilities.UpdateGraphsNoBlock was also fixed by this change.
Fixed compile error with monodevelop.
Fixed a bug which caused scanning to fail if more than one NavmeshGraph existed.
Fixed the lightweight local avoidance example scene which didn't work previously.
Fixed SimpleSmoothModifier not exposing Roundness Factor in the editor for the Curved Nonuniform mode.
Fixed an exception when updating RecastGraphs and using RelevantGraphSurfaces and multithreading.
Fixed exceptions caused by starting paths from other threads than the Unity thread.
Fixed an infinite loop/out of memory exception that could occur sometimes when graph updates were being done at the start of the game (I hate multithreading race conditions).
Fixed the Optimizations tab not working when JS Support was enabled.
Fixed graph updating not working on navmesh graphs (it was broken before due to a missing line of code).
Fixed some misspelled words in the documentation.
Removed some unused and/or redundant variables.
Fixed a case where graphs added using code might not always be configured correctly (and would throw exceptions when scanning).
Improved Windows Store compatibility.
Fixed a typo in the GridGraph which could cause compilation to fail when building for Windows Phone or Windows Store (thanks MariuszP)
Lots of code cleanups and comments added to various scripts.
Fixed some cases where MonoDevelop would pick up the wrong documention for fields since it doesn't support all features that Doxygen supports.
Fixed a bug which caused the points field on GraphUpdateScene to sometimes not be editable.
Fixed a bug which could cause RVO agents not to move if the fps was low and Interpolation and Double Buffering was used.
Set the execution order for RVOController and RVOSimulator to make sure that other scripts will get the latest position in their Update method.
Fixed a bug which could cause some nearest point on line methods in AstarMath to return NaN. This could happen when Seeker->Start End Modifier->StartPoint and EndPoint was set to Interpolate.
Fixed a runtime error on PS Vita.
Fixed an index out of range exception which could occur when scanning LayeredGridGraphs.
Fixed an index out of range exception which could occur when drawing gizmos for a LayeredGridGraph.
Fixed a bug which could cause ProduralGridMover to update the graph every frame regardless of if the target moved or not (thanks Makak for finding the bug).
Fixed a number of warnings in Unity 5.
3.5.9.7 (3.6 beta 6, 2015-01-28)
3.5.9.6 (3.6 beta 5, 2015-01-28)
3.5.9.5 (3.6 beta 4, 2015-01-27)
3.5.9.1 (3.6 beta 3, 2014-10-14)
3.5.9 (3.6 beta 2, 2014-10-13)
3.5.8 (3.6 beta 1)
See release notes for 3.6
3.5.2 (2013-09-01) (tiny bugfix and small feature release)
Added isometric angle option for grid graphs to help with isometric 2D games.
Fixed a bug with the RVOAgent class which caused the LightweightRVO example scene to not work as intended (no agents were avoiding each other).
Fixed some documentation typos.
Fixed some compilations errors some people were having with other compilers than Unity's.
3.5.1 (2014-06-15)
Added avoidance masks to local avoidance. Each agent now has a layer and each agent can specify which layers it will avoid.
3.5 (2014-06-12)
Added back local avoidance!! The new system uses a sampling based algorithm instead of a geometric one. The API is almost exactly the same so if you used the previous system this will be a drop in replacement. As for performance, it is roughly the same, maybe slightly worse in high density situations and slightly better in less dense situations. It can handle several thousand agents on an i7 processor. Obstacles are not yet supported, but they will be added in a future update.
Binary heap switched out for a 4-ary heap. This improves pathfinding performances by about 5%.
Optimized scanning of navmesh graphs (not the recast graphs) Large meshes should be much faster to scan now.
Optimized BBTree (nearest node lookup for navmesh/recast graphs, pro version only) Nearest node queries on navmesh/recast graphs should be slightly faster now.
Minor updates to the documentation, esp. to the GraphNode class.
3.4.0.7
Vuforia test build
3.4.0.6
Fixed an issue where serialization could on some machines sometimes cause an exception to get thrown.
Fixed an issue where the recast graph would not rasterize terrains properly near the edges of it.
Added PathUtilities.BFS.
Added PathUtilities.GetPointsAroundPointWorld.
3.4.0.5
Added offline documentation (Documentation.zip)
Misc fixes for namespace conflicts people have been having. This should improve compatibility with other packages. You might need to delete the AstarPathfindingProject folder and reimport the package for everything to work.
3.4.0.4
Removed RVOSimulatorEditor from the free version, it was causing compiler errors.
Made PointGraph.nodes public.
3.4.0.3
Removed Local Avoidance due to licensing issues. Agents will fall back to not avoiding each other. I am working to get the local avoidance back as soon as possible.
3.4.0.2
Unity Asset Store forced me to increase version number.
3.4.0.1
Fixed an ArrayIndexOutOfBounds exception which could be thrown by the ProceduralGridMover script in the Procedural example scene if the target was moved too quickly.
The project no longer references assets from the Standard Assets folder (the package on the Unity Asset Store did so by mistake before).
3.4
Fixed a null reference exception when scanning recast graphs and rasterizing colliders.
Removed duplicate clipper_library.dll which was causing compiler errors.
Support for 2D Physics collision testing when using Grid Graphs.
Better warnings when using odd settings for Grid Graphs.
Minor cleanups.
Queued graph updates are no longer being performed when the AstarPath object is destroyed, this just took time.
Fixed a bug introduced in 3.3.11 which forced grid graphs to be square in Unity versions earlier than 4.3.
Fixed a null reference in BBTree ( used by RecastGraph).
Fixed NavmeshGraph not rebuilding BBTree on cached start (causing performance issues on larger graphs).
Includes all changes from the beta releases below
Beta 3.3.14 ( available for everyone! )
All dlls are now in namespaces (e.g Pathfinding.Ionic.Zip instead of just Ionic.Zip ) to avoid conflicts with other packages.
Most scripts are now in namespaces to avoid conflicts with other packages.
GridNodes now support custom connections.
Cleanups, preparing for release.
Reverted to using an Int3 for GraphNode.position instead of an abstract Position property, the tiny memory gains were not worth it.
Beta 3.3.13 ( 4.3 compatible only )
Fixed an issue where deleting a NavmeshCut component would not update the underlaying graph.
Better update checking.
Beta 3.3.12 ( 4.3 compatible only )
Fixed an infinite loop which could happen when scanning graphs during runtime ( not the first scan ).
NodeLink component is now working correctly.
Added options for optimizations to the PointGraph.
Improved TileHandler and navmesh cutting.
Fixed rare bug which could mess up navmeshes when using navmesh cutting.
Beta 3.3.11 ( 4.3 compatible only )
Fixed update checking. A bug has caused update checking not to run unless you had been running a previous version in which the bug did not exist. I am not sure how long this bug has been here, but potentially for a very long time.
Added an update notification window which pops up when there is a new version of the A* Pathfinding Project.
Lots of UI fixes for Unity 4.3
Lots of other UI fixes and imprements.
Fixed gravity for RichAI.
Fixed Undo for Unity 4.3
Added a new example scene showing a procedural environment.
Beta 3.3.10
Removed RecastGraph.includeOutOfBounds.
Fixed a few bugs when updating Layered Grid Graphs causing incorrect connections to be created, and valid ones to be left out.
Fixed a null reference bug when removing RVO agents.
Fixed memory leaks when deserializing graphs or reloading scenes.
Beta 3.3.9
Added new tutorial page about recast graphs.
Recast Graph: Fixed a bug which could cause vertical surfaces to be ignored.
Removed support for C++ Recast.
Fixed rare bug which could mess up navmeshes when using navmesh cutting.
Improved TileHandler and navmesh cutting.
GraphModifiers now take O(n) (linear) time to destroy at end of game instead of O(n^2) (quadratic).
RecastGraph now has a toggle for using tiles or not.
Added RelevantGraphSurface which can be used with RecastGraphs to prune away non-relevant surfaces.
Removed RecastGraph.accurateNearestNode since it was not used anymore.
Added RecastGraph.nearestSearchOnlyXZ.
RecastGraph now has support for removing small areas.
Added toggle to show or hide connections between nodes on a recast graph.
PointNode has some graph searching methods overloaded specially. This increases performance and reduces alloacations when searching point graphs.
Reduced allocations when searching on RecastGraph.
Reduced allocations in RichAI and RichPath. Everything is pooled now, so for most requests no allocations will be done.
Reduced allocations in general by using "yield return null" instead of "yield return 0"
Fixed teleport for local avoidance agents. Previously moving an agent from one position to another could cause it to interpolate between those two positions for a brief amount of time instead of staying at the second position.
Beta 3.3.8
Nicer RichAI gizmo colors.
Fixed RichAI not using raycast when no path has been calculated.
Beta 3.3.7
Fixed stack overflow exception in RichPath
Fixed RichPath could sometimes generate invalid paths
Added gizmos to RichAI
Beta 3.3.6
Fixed node positions being off by half a node size. GetNearest node queries on grid graphs would be slightly inexact.
Fixed grid graph updating could get messed up when using erosion.
... among other things, see below
Beta 3.3.5 and 3.3.6
Highlights
Rewritten graph nodes. Nodes can now be created more easily (less overhead when creating nodes).
Graphs may use their custom optimized memory structure for storing nodes.
Performance improvements for scanning recast graphs.
Added a whole new AI script. RichAI (and the class RichPath for some things): This script is intended for navmesh based graphs and has features such as:
Guarantees that the character stays on the navmesh
Minor deviations from the path can be fixed without a path recalculation.
Very exact stop at endpoint (seriously, precision with something like 7 decimals). No more circling around the target point as with AIPath.
Does not use path modifiers at all (for good reasons). It has an internal funnel modifier however.
Simple wall avoidance to avoid too much wall hugging.
Basic support for off-mesh links (see example scene).
Improved randomness for RandomPath and FleePath, all nodes considered now have an equal chance of being selected.
Recast now has support for tiles. This enabled much larger worlds to be rasterized (without OutOfMemory errors) and allows for dynamic graph updates. Still slow, but much faster than a complete recalculation of the graph.
Navmesh Cutting can now be done on recast graphs. This is a kind of (relatively) cheap graph updating which punches a hole in the navmesh to make place for obstacles. So it only supports removing geometry, not adding it (like bridges). This update is comparitively fast, and it makes real time navmesh updating possible. See video: http://youtu.be/qXi5qhhGNIw.
Added RecastMeshObj which can be attached to any GameObject to include that object in recast rasterization. It exposes more options and is also faster for graph updates with logarithmic lookup complexity instead of linear (good for larger worlds when doing graph updating).
Reintroducing special connection costs for start and end nodes. Before multithreading was introduced, pathfinding on navmesh graphs could recalculate the connection costs for the start and end nodes to take into account that the start point is not actually exactly at the start node's position (triangles are usually quite a larger than the player/npc/whatever). This didn't work with multithreading however and could mess up pathfinding, so it was removed. Now it has been reintroduced, working with multithreading! This means more accurate paths on navmeshes.
Added several methods to pick random points (e.g for group movement) to Pathfinding.PathUtlitilies.
Added RadiusModifier. A new modifier which can offset the path based on the character radius. Intended for navmesh graphs which are not shrinked by the character radius at start but can be used for other purposes as well.
Improved GraphUpdateScene gizmos. Convex gizmos are now correctly placed. It also shows a bounding box when selected (not showing this has confused a lot of people).
AIPath has gotten some cleanups. Among other things it now behaves correctly when disabled and then enabled again making it easy to pool and reuse (should that need arise).
Funnel modifier on grid graphs will create wider funnels for diagonals which results in nicer paths.
If an exception is thrown during pathfinding, the program does no longer hang at quit.
Split Automatic thread count into Automatic High Load and Automatic Low Load. The former one using a higher number of thread.
Thread count used is now shown in the editor.
GridGraph now supports ClosestOnNode (StartEndModifier) properly. SnapToNode gives the previous behaviour on GridGraphs (they were identical before).
New example scene Door2 which uses the NavmeshCut component.
Fixes
Fixed spelling error in GridGraph.uniformWidthDepthGrid.
Erosion radius (character radius, recast graphs) could become half of what it really should be in many cases.
RecastGraph will not rasterize triggers.
Fixed recast not being able to handle multiple terrains.
Fixed recast generating an incorrect mesh for terrains in some cases (not the whole terrain was included).
Linecast on many graph types had incorrect descriptions saying that the function returns true when the line does not intersect any obstacles, it is actually the other way around. Descriptions corrected.
The list of nodes returned by a ConstantPath is now guaranteed to have no duplicates.
Many recast constants are now proper constants instead of static variables.
Fixed bug in GridNode.RemoveGridGraph which caused graphs not being cleaned up correctly. Could cause problems later on.
Fixed an ArgumentOutOfRange exception in ListPool class.
RelocateNodes on NavMeshGraph now correctly recalculates connection costs and rebuilds the internal query tree (thanks peted on the forums).
Much better member documentation for RVOController.
Exposed MaxNeighbours from IAgent to RVOController.
Fixed AstarData.UpdateShortcuts not being called when caching was enabled. This caused graph shortcuts such as AstarPath.astarData.gridGraph not being set when loaded from a cache.
RVOCoreSimulator/RVOSimulator now cleans up the worker threads correctly.
Tiled recast graphs can now be serialized.
Changes
Renamed Modifier class to PathModifier to avoid naming conflicts with user scripts and other packages.
Cleaned up recast, put inside namespace and split into multiple files.
ListPool and friends are now threadsafe.
Removed Polygon.Dot since the Vector3 class already contains such a method.
The Scan functions now use callbacks for progress info instead of IEnumerators. Graphs can now output progress info as well.
Added Pathfinding.NavGraph.CountNodes function.
Removed GraphHitInfo.success field since it was not used.
GraphUpdateScene will now fall back to collider.bounds or renderer.bounds (depending on what is available) if no points are defined for the shape.
AstarPath.StartPath now has an option to put the path in the front of the queue to prioritize its calculation over other paths.
Time.fixedDeltaTime by Time.deltaTime in AIPath.RotateTowards() to work with both FixedUpdate and Update. (Thanks Pat_AfterMoon) You might have to configure the turn speed variable after updating since the actual rotation speed might have changed a bit depending on your settings.
Fixed maxNeighbourDistance not being used correctly by the RVOController script. It would stay at the default value. If you have had trouble getting local avoidance working on world with a large scale, this could have been the problem. (Thanks to Edgar Sun for providing a reproducible example case)
Graphs loaded using DeserializeGraphsAdditive will get their graphIndex variables on the nodes set to the correct values. (thanks peted for noticing the bug).
Fixed a null reference exception in MultiTargetPath (thanks Dave for informing me about the bug).
GraphUpdateScene.useWorldSpace is now false per default.
If no log output is disabled and we are not running in the editor, log output will be discarded as early as possible for performance. Even though in theory log output could be enabled between writing to internal log strings and deciding if log output should be written.
NavGraph.inverseMatrix is now a field, not a property (for performance). All writes to matrix should be through the SetMatrix method.
StartEndModifier now uses ClosestOnNode for both startPoint and endPoint by default.
Known bugs
Linecasting on graphs is broken at the moment. (working for recast/navmesh graph atm. Except in very special cases)
RVONavmesh does not work with tiled recast graphs.
3.2.5.1
Fixes
Pooling of paths had been accidentally disabled in AIPath.
3.2.5
Changes
Added support for serializing dictionaries with integer keys via a Json Converter.
If drawGizmos is disabled on the seeker, paths will be recycled instantly. This will show up so that if you had a seeker with drawGizmos=false, and then enable drawGizmos, it will not draw gizmos until the next path request is issued.
Fixes
Fixed UNITY_4_0 preprocesor directives which were indented for UNITY 4 and not only 4.0. Now they will be enabled for all 4.x versions of unity instead of only 4.0.
Fixed a path pool leak in the Seeker which could cause paths not to be released if a seeker was destroyed.
When using a non-positive maxDistance for point graphs less processing power will be used.
Removed unused 'recyclePaths' variable in the AIPath class.
NullReferenceException could occur if the Pathfinding.Node.connections array was null.
Fixed NullReferenceException which could occur sometimes when using a MultiTargetPath (Issue #16)
Changed Ctrl to Alt when recalcing path continously in the Path Types example scene to avoid clearing the points for the MultiTargetPath at the same time (it was also using Ctrl).
Fixed strange looking movement artifacts during the first few frames when using RVO and interpolation was enabled.
AlternativePath modifier will no longer cause underflows if penalties have been reset during the time it was active. It will now only log a warning message and zero the penalty.
Added Pathfinding.GraphUpdateObject.resetPenaltyOnPhysics (and similar in GraphUpdateScene) to force grid graphs not to reset penalties when updating graphs.
Fixed a bug which could cause pathfinding to crash if using the preprocessor directive ASTAR_NoTagPenalty.
Fixed a case where StartEndModifier.exactEndPoint would incorrectly be used instead of exactStartPoint.
AlternativePath modifier now correctly resets penalties if it is destroyed.
3.2.4.1
Unity Asset Store guys complained about the wrong key image. I had to update the version number to submit again.
3.2.4
Highlights
RecastGraph can now rasterize colliders as well!
RecastGraph can rasterize colliders added to trees on unity terrains!
RecastGraph will use Graphics.DrawMeshNow functions in Unity 4 instead of creating a dummy GameObject. This will remove the annoying "cleaning up leaked mesh object" debug message which unity would log sometimes. The debug mesh is now also only visible in the Scene View when the A* object is selected as that seemed most logical to me (don't like this? post something in the forum saying you want a toggle for it and I will implement one).
GraphUpdateObject now has a toggle specifying if erosion (on grid graphs) should be recalculated after applying the guo. This enables one to add walkable nodes which should have been made unwalkable by erosion.
Made it a bit easier (and added more correct documentation) to add custom graph types when building for iPhone with Fast But No Exceptions (see iPhone page).
Changes
RecastGraph now only rasterizes enabled MeshRenderers. Previously even disabled ones would be included.
Renamed RecastGraph.includeTerrain to RecastGraph.rasterizeTerrain to better match other variable naming.
Fixes
AIPath now resumes path calculation when the component or GameObject has been disabled and then reenabled.
3.2.3 (free version mostly)
Fixes
A UNITY_IPHONE directive was not included in the free version. This caused compilation errors when building for iPhone.
Changes
Some documentation updates
3.2.2
Changes
Max Slope in grid graphs is now relative to the graph's up direction instead of world up (makes more sense I hope)
Note
Update really too small to be an update by itself, but I was updating the build scripts I use for the project and had to upload a new version because of technical reasons.
3.2.1
Fixes
Fixed bug which caused compiler errors on build (player, not in editor).
Version number was by mistake set to 3.1 instead of 3.2 in the previous version.
3.2
Highlights
A complete Local Avoidance system is now included in the pro version!
Almost every allocation can now be pooled. Which means a drastically lower allocation rate (GC get's called less often).
Initial node penalty per graph can now be set. Custom graph types implementing CreateNodes must update their implementations to properly assign this value.
GraphUpdateScene has now many more tools and options which can be used.
Added Pathfinding.PathUtilities which contains some usefull functions for working with paths and nodes.
Added Pathfinding.Node.GetConnections to enable easy getting of all connections of a node. The Node.connections array does not include custom connections which for example grid graphs use.
Seeker.PostProcess function was added for easy postprocessing of paths calculated without a seeker.
AstarPath.WaitForPath. Wait (block) until a specific path has been calculated.
Path.WaitForPath. Wait using a coroutine until a specific path has been calculated.
LayeredGridGraph now has support for up to 65535 layers (theoretically, but don't try it as you would probably run out of memory)
Recast graph generation is now up to twice as fast!
Fixed some UI glitches in Unity 4.
Debugger component has more features and a slightly better layout.
Fixes
Fixed a bug which caused the SimpleSmoothModifier with uniformSegmentLength enabled to skip points sometimes.
Fixed a bug where importing graphs additively which had the same GUID as a graph already loaded could cause bugs in the inspector.
Fixed a bug where updating a GridGraph loaded from file would throw a NullReferenceException.
Fixed a bug which could cause error messages for paths not to be logged
Fixed a number of small bugs related to updating grid graphs (especially when using erosion as well).
Overflows could occur in some navmesh/polygon math related functions when working with Int3s. This was because the precision of them had recently been increased. Further down the line this could cause incorrect answers to GetNearest queries. Fixed by casting to long when necessary.
Navmesh2.shader defined "Cull Off" twice.
Pathfinding threads are now background threads. This will prevent them from blocking the process to terminate if they of some reason are still alive (hopefully at least).
When really high penalties are applied (which could be underflowed negative penalties) a warning message is logged. Really high penalties (close to max uint value) can otherwise cause overflows and in some cases infinity loops because of that.
ClosestPointOnTriangle is now spelled correctly.
MineBotAI now uses Update instead of FixedUpdate.
Use Dark Skin option is now exposed again since it could be incorrectly set sometimes. Now you can force it to light or dark, or set it to auto.
Fixed recast graph bug when using multiple terrains. Previously only one terrain would be used.
Fixed some UI glitches in Unity 4.
Changes
Removed Pathfinding.NNInfo.priority.
Removed Pathfinding.NearestNodePriority.
Conversions between NNInfo and Node are now explicit to comply with the rule of "if information might be lost: use explicit casts".
NNInfo is now a struct.
GraphHitInfo is now a struct.
Path.vectorPath and Path.path are now List<Vector3> and List<Node> respectively. This is done to enable pooling of resources more efficiently.
Added Pathfinding.Node.RecalculateConnectionCosts.
Moved IsPathPossible from GraphUpdateUtilities to PathUtilities.
Pathfinding.Path.processed was replaced with Pathfinding.Path.state. The new variable will have much more information about where the path is in the pathfinding pipeline.
Paths should not be created with constructors anymore, instead use the PathPool class and then call some Setup() method
When the AstarPath object is destroyed, calculated paths in the return queue are not returned with errors anymore, but just returned.
Removed depracated methods AstarPath.AddToPathPool, RecyclePath, GetFromPathPool.
Bugs
C++ Version of Recast does not work on Windows.
GraphUpdateScene does in some cases not draw correctly positioned gizmos.
Starting two webplayers and closing down the first might cause the other one's pathfinding threads to crash (unity bug?) (confirmed on osx)
3.1.4 (iOS fixes)
Fixes
More fixes for the iOS platform.
The "JsonFx.Json.dll" file is now correctly named.
Changes
Removed unused code from DotNetZip which reduced the size of it with about 20 KB.
3.1.3 (free version only)
Fixes
Some of the fixes which were said to have been made in 3.1.2 were actually not included in the free version of the project. Sorry about that.
Also includes a new JsonFx and Ionic.Zip dll. This should make it possible to build with the .Net 2.0 Subset again see: http://www.arongranberg.com/forums/topic/ios-problem/page/1/
3.1.2 (small bugfix release)
Fixes
Fixed a bug which caused builds for iPhone to fail.
Fixed a bug which caused runtime errors on the iPhone platform.
Fixed a bug which caused huge lag in the editor for some users when using grid graphs.
ListGraphs are now correctly loaded as PointGraphs when loading data from older versions of the system.
Changes
Moved JsonFx into the namespace Pathfinding.Serialization.JsonFx to avoid conflicts with users own JsonFx libraries (if they used JsonFx).
Known bugs
Recast graph does not work when using static batching on any objects included.
3.1.1 (small bugfix release)
Fixes
Fixed a bug which would cause Pathfinding.GraphUpdateUtilities.UpdateGraphsNoBlock to throw an exception when using multithreading
Fixed a bug which caused an error to be logged and no pathfinding working when not using multithreading in the free version of the project
Fixed some example scene bugs due to downgrading the project from Unity 3.5 to Unity 3.4
3.1
Fixed bug which caused LayerMask fields (GridGraph inspector for example) to behave weirdly for custom layers on Unity 3.5 and up.
The color setting "Node Connection" now actually sets the colors of the node connections when no other information should be shown using the connection colors or when no data is available.
Put the Int3 class in a separate file.
Casting between Int3 and Vector3 is no longer implicit. This follows the rule of "if information might be lost: use explicit casts".
Renamed ListGraph to PointGraph. "ListGraph" has previously been used for historical reasons. PointGraph is a more suitable name.
Graph can now have names in the editor (just click the name in the graph list)
Graph Gizmos can now be selectively shown or hidden per graph (small "eye" icon to the right of the graph's name)
Added GraphUpdateUtilities with many useful functions for updating graphs.
Erosion for grid graphs can now use tags instead of walkability
Fixed a bug where using One Way links could in some cases result in a NullReferenceException being thrown.
Vector3 fields in the graph editors now look a bit better in Unity 3.5+. EditorGUILayout.Vector3Field didn't show the XYZ labels in a good way (no idea why)
GridGraph.useRaycastNormal is now enabled only if the Max Slope is less than 90 degrees. Previously it was a manual setting.
The keyboard shortcut to scan all graphs does now also work even when the graphs are not deserialized yet (which happens a lot in the editor)
Added NodeLink script, which can be attached to GameObjects to add manual links. This system will eventually replace the links system in the A* editor.
Added keyboard shortcuts for adding and removing links. See Menubar -> Edit -> Pathfinding
Note
Some features are restricted to Unity 3.5 and newer because of technical limitations in earlier versions (especially multi-object editing related features).
3.1 beta (version number 3.0.9.9 in Unity due to technical limitations of the System.Versions class)
Multithreading is now enabled in the free version of the A* Pathfinding Project!
Better support for graph updates called during e.g OnPostScan.
PathID is now used as a short everywhere in the project
G,H and penalty is now used as unsigned integers everywhere in the project instead of signed integers.
There is now only one tag per node (if not the #define ConfigureTagsAsMultiple is set).
Fixed a bug which could make connections between graphs invalid when loading from file (would also log annoying error messages).
Erosion (GridGraph) can now be used even when updating the graph during runtime.
Fixed a bug where the GridGraph could return null from it's GetNearestForce calls which ended up later throwing a NullReferenceException.
FunnelModifier no longer warns if any graph in the path does not implement the IFunnelGraph interface (i.e have no support for the funnel algorithm) and instead falls back to add node positions to the path.
Added a new graph type : LayerGridGraph which works like a GridGraph, but has support for multiple layers of nodes (e.g multiple floors in a building).
ScanOnStartup is now exposed in the editor.
Separated temporary path data and connectivity data.
Rewritten multithreading. You can now run any number of threads in parallel.
To avoid possible infinite loops, paths are no longer returned with just an error when requested at times they should not (e.g right when destroying the pathfinding object)
Cleaned up code in AstarPath.cs, members are now structured and many obsolete members have been removed.
Rewritten serialization. Now uses Json for settings along with a small part hardcoded binary data (for performance and memory). This is a lot more stable and will be more forwards and backwards compatible. Data is now saved as zip files(in memory, but can be saved to file) which means you can actually edit them by hand if you want!
Added dependency JsonFx (modified for smaller code size and better compatibility).
Added dependency DotNetZip (reduced version and a bit modified) for zip compression.
Graph types wanting to serialize members must add the JsonOptIn attribute to the class and JsonMember to any members to serialize (in the JsonFx.Json namespace)
Graph types wanting to serialize a bit more data (custom), will have to override some new functions from the NavGraph class to do that instead of the old serialization functions.
Changed from using System.Guid to a custom written Guid implementation placed in Pathfinding.Util.Guid. This was done to improve compabitility with iOS and other platforms. Previously it could crash when trying to create one because System.Guid was not included in the runtime.
Renamed callback AstarPath.OnSafeNodeUpdate to AstarPath.OnSafeCallback (also added AstarPath.OnThreadSafeCallback)
MultiTargetPath would throw NullReferenceException if no valid start node was found, fixed now.
Binary heaps are now automatically expanded if needed, no annoying warning messages.
Fixed a bug where grid graphs would not update the correct area (using GraphUpdateObject) if it was rotated.
Node position precision increased from 100 steps per world unit to 1000 steps per world unit (if 1 world unit = 1m, that is mm precision). This also means that all costs and penalties in graphs will need to be multiplied by 10 to match the new scale. It also means the max range of node positions is reduced a bit... but it is still quite large (about 2 150 000 world units in either direction, that should be enough).
If Unity 3.5 is used, the EditorGUIUtility.isProSkin field is used to toggle between light and dark skin.
Added LayeredGridGraph which works almost the same as grid graphs, but support multiple layers of nodes.
Note
Dropped Unity 3.3 support.
Known Bugs: The C++ version of Recast does not work on Windows
Documentation Update
Changed from FixedUpdate to Update in the Get Started Guide. CharacterController.SimpleMove should not be called more than once per frame, so this might have lowered performance when using many agents, sorry about this typo.
3.0.9
The List Graph's "raycast" variable is now serialized correctly, so it will be saved.
List graphs do not generate connections from nodes to themselves anymore (yielding slightly faster searches)
List graphs previously calculated cost values for connections which were very low (they should have been 100 times larger), this can have caused searches which were not very accurate on small scales since the values were rounded to the nearest integer.
Added Pathfinding.Path.recalcStartEndCosts to specify if the start and end nodes connection costs should be recalculated when searching to reflect small differences between the node's position and the actual used start point. It is on by default but if you change node connection costs you might want to switch it off to get more accurate paths.
Fixed a compile time warning in the free version from referecing obsolete variables in the project.
Added AstarPath.threadTimeoutFrames which specifies how long the pathfinding thread will wait for new work to turn up before aborting (due to request). This variable is not exposed in the inspector yet.
Fixed typo, either there are eight (8) or four (4) max connections per node in a GridGraph, never six (6).
AlternativePath will no longer cause errors when using multithreading!
Added Pathfinding.ConstantPath, a path type which finds all nodes in a specific distance (cost) from a start node.
Added Pathfinding.FloodPath and Pathfinding.FloodPathTracer as an extreamly fast way to generate paths to a single point in for example TD games.
Fixed a bug in MultiTargetPath which could make it extreamly slow to process. It would not use much CPU power, but it could take half a second for it to complete due to excessive yielding
Fixed a bug in FleePath, it now returns the correct path. It had previously sometimes returned the last node searched, but which was not necessarily the best end node (though it was often close)
Using #defines, the pathfinder can now be better profiled (see Optimizations tab -> Profile Astar)
Added example scene Path Types (mainly useful for A* Pro users, so I have only included it for them)
Added many more tooltips in the editor
Fixed a bug which would double the Y coordinate of nodes in grid graphs when loading from saved data (or caching startup)
Graph saving to file will now work better for users of the Free version, I had forgot to include a segment of code for Grid Graphs (sorry about that)
Some other bugfixes
3.0.8.2
Fixed a critical bug which could render the A* inspector unusable on Windows due to problems with backslashes and forward slashes in paths.
3.0.8.1
Fixed critical crash bug. When building, a preprocessor-directive had messed up serialization so the game would probably crash from an OutOfMemoryException.
3.0.8
Graph saving to file is now exposed for users of the Free version
Fixed a bug where penalties added using a GraphUpdateObject would be overriden if updatePhysics was turned on in the GraphUpdateObject
Fixed a bug where list graphs could ignore some children nodes, especially common if the hierarchy was deep
Fixed the case where empty messages would spam the log (instead of spamming somewhat meaningful messages) when path logging was set to Only Errors
Changed the NNConstraint used as default when calling NavGraph.GetNearest from NNConstraint.Walkable to NNConstraint.None, this is now the same as the default for AstarPath.GetNearest.
You can now set the size of the red cubes shown in place of unwalkable nodes (Settings–>Show Unwalkable Nodes–>Size)
Dynamic search of where the EditorAssets folder is, so now you can place it anywhere in the project.
Minor A* inspector enhancements.
Fixed a very rare bug which could, when using multithreading cause the pathfinding thread not to start after it has been terminated due to a long delay
Modifiers can now be enabled or disabled in the editor
Added custom inspector for the Simple Smooth Modifier. Hopefully it will now be easier to use (or at least get the hang on which fields you should change).
Added AIFollow.canSearch to disable or enable searching for paths due to popular request.
Added AIFollow.canMove to disable or enable moving due to popular request.
Changed behaviour of AIFollow.Stop, it will now set AIFollow.ccanSearch and AIFollow.ccanMove to false thus making it completely stop and stop searching for paths.
Removed Path.customData since it is a much better solution to create a new path class which inherits from Path.
Seeker.StartPath is now implemented with overloads instead of optional parameters to simplify usage for Javascript users
Added Curved Nonuniform spline as a smoothing option for the Simple Smooth modifier.
Added Pathfinding.WillBlockPath as function for checking if a GraphUpdateObject would block pathfinding between two nodes (useful in TD games).
Unity References (GameObject's, Transforms and similar) are now serialized in another way, hopefully this will make it more stable as people have been having problems with the previous one, especially on the iPhone.
Added shortcuts to specific types of graphs, AstarData.navmesh, AstarData.gridGraph, AstarData.listGraph
Known Bugs: The C++ version of Recast does not work on Windows
3.0.7
Grid Graphs can now be scaled to allow non-square nodes, good for isometric games.
Added more options for custom links. For example individual nodes or connections can be either enabled or disabled. And penalty can be added to individual nodes
Placed the Scan keyboard shortcut code in a different place, hopefully it will work more often now
Disabled GUILayout in the AstarPath script for a possible small speed boost
Some debug variables (such as AstarPath.PathsCompleted) are now only updated if the ProfileAstar define is enabled
DynamicGridObstacle will now update nodes correctly when the object is destroyed
Unwalkable nodes no longer shows when Show Graphs is not toggled
Removed Path.multithreaded since it was not used
Removed Path.preCallback since it was obsolate
Added Pathfinding.XPath as a more customizable path
Added example of how to use MultiTargetPaths to the documentation as it was seriously lacking info on that area
The viewing mesh scaling for recast graphs is now correct also for the C# version
The StartEndModifier now changes the path length to 2 for correct applying if a path length of 1 was passed.
The progressbar is now removed even if an exception was thrown during scanning
Two new example scenes have been added, one for list graphs which includes sample links, and another one for recast graphs
Reverted back to manually setting the dark skin option, since it didn't work in all cases, however if a dark skin is detected, the user will be asked if he/she wants to enable the dark skin
Added gizmos for the AIFollow script which shows the current waypoint and a circle around it illustrating the distance required for it to be considered "reached".
The C# version of Recast does now use Character Radius instead of Erosion Radius (world units instead of voxels)
Fixed an IndexOutOfRange exception which could occur when saving a graph with no nodes to file
Known Bugs: The C++ version of Recast does not work on Windows
3.0.6
Added support for a C++ version of Recast which means faster scanning times and more features (though almost no are available at the moment since I haven't added support for them yet).
Removed the overload AstarData.AddGraph (string type, NavGraph graph) since it was obsolete. AstarData.AddGraph (Pathfinding.NavGraph) should be used now.
Fixed a few bugs in the FunnelModifier which could cause it to return invalid paths
A reference image can now be generated for the Use Texture option for Grid Graphs
Fixed an editor bug with graphs which had no editors
Graphs with no editors now show up in the Add New Graph list to show that they have been found, but they cannot be used
Deleted the graphIndex parameter in the Pathfinding.NavGraph.Scan function. If you need to use it in your graph's Scan function, get it using Pathfinding.AstarData.GetGraphIndex
Javascript support! At last you can use Js code with the A* Pathfinding Project! Go to A* Inspector–>Settings–>Editor–>Enable Js Support to enable it
The Dark Skin is now automatically used if the rest of Unity uses the dark skin(hopefully)
Fixed a bug which could cause Unity to crash when using multithreading and creating a new AstarPath object during runtime
3.0.5
List Graphs now support UpdateGraphs. This means that they for example can be used with the DynamicObstacle script.
List Graphs can now gather nodes based on GameObject tags instead of all nodes as childs of a specific GameObject.
List Graphs can now search recursively for childs to the 'root' GameObject instead of just searching through the top-level children.
Added custom area colors which can be edited in the inspector (A* inspector –> Settings –> Color Settings –> Custom Area Colors)
Fixed a NullReference bug which could occur when loading a Unity Reference with the AstarSerializer.
Fixed some bugs with the FleePath and RandomPath which could cause the StartEndModifier to assign the wrong endpoint to the path.
Documentation is now more clear on what is A* Pathfinding Project Pro only features.
Pathfinding.NNConstraint now has a variable to constrain which graphs to search (A* Pro only).
This is also available for Pathfinding.GraphUpdateObject which now have a field for an NNConstraint where it can constrain which graphs to update.StartPath calls on the Seeker can now take a parameter specifying which graphs to search for close nodes on (A* Pro only)
Added the delegate AstarPath.OnAwakeSettings which is called as the first thing in the Awake function, can be used to set up settings.
Pathfinding.UserConnection.doOverrideCost is now serialized correctly. This represents the toggle to the right of the "Cost" field when editing a link.
Fixed some bugs with the RecastGraph when spans were partially out-of-bounds, this could generate seemingly random holes in the mesh
3.0.4 (only pro version affected)
Added a Dark Skin for Unity Pro users (though it is available to Unity Free users too, even though it doesn't look very good). It can be enabled through A* Inspector –> Settings –> Editor Settings –> Use Dark Skin
Added option to include or not include out of bounds voxels (Y axis below the graph only) for Recast graphs.
3.0.3 (only pro version affected)
Fixed a NullReferenceException caused by Voxelize.cs which could surface if there were MeshFilters with no Renderers on GameObjects (Only Pro version affected)
3.0.2
Textures can now be used to add penalty, height or change walkability of a Grid Graph (A* Pro only)
Slope can now be used to add penalty to nodes
Height (Y position) can now be usd to add penalty to nodes
Prioritized graphs can be used to enable prioritizing some graphs before others when they are overlapping
Several bug fixes
Included a new DynamicGridObstacle.cs script which can be attached to any obstacle with a collider and it will update grids around it to account for changed position
3.0.1
Fixed Unity 3.3 compability
3.0
Rewrote the system from scratch
Funnel modifier
Easier to extend the system
x. releases are major rewrites or updates to the system.
.x releases are quite big feature updates
..x releases are the most common updates, fix bugs, add some features etc.
...x releases are quickfixes, most common when there was a really bad bug which needed fixing ASAP.
