# Introduction to NavigationPlugin V2

> Learn about NavigationPlugin V2

Source: https://doc.babylonjs.com/features/featuresDeepDive/crowdNavigation/v2Intro

## Why are there two versions of the Navigation plugins?

V1 uses an old and unmaintained JavaScript package, which often causes issues when used with ES6 and bundlers. V1 is being deprecated.

V2 uses the remarkable [recast-navigation-js](https://github.com/isaac-mason/recast-navigation-js) library by Isaac Mason (thank you Isaac!), which is fully ES6-compliant, up to date, and well maintained.

V2 will eventually replace V1 after it gets thoroughly tested. That is why V2 is in `ADDONS` and not already in the `core` package. Since the two versions should be fully compatible and only the internal implementation details and the underlying Recast/Detour libraries have changed, you can easily switch to V2 without rewriting your code.

There is one change, though. You need to initialize the plugin by calling an `async` factory function instead of using a constructor, as in V1.

## How to use the navigation plugin V2?

```javascript
const navigationPlugin = await ADDONS.CreateNavigationPluginAsync(); // uses WASM under the hood
const navigationPlugin = await ADDONS.CreateNavigationPluginWorkerAsync(); // under construction
```

This call will dynamically load the `recast-navigation-js` library and initialize it.

### The new async createNavMeshAsync function

You can create a navmesh by calling the new async function:
```ts
const result = createNavMeshAsync(meshes: Array<Mesh>, parameters: INavMeshParametersV2): Promise<CreateNavMeshResult>;
```

Important! A worker version is not supported yet, but we are working on it. In a production environment, you would use a pregenerated nav mesh, so this should not be an issue. You can use [NavMesh generator](https://navmesh-generator.babylonjs.xyz/) to generate your nav meshes, or use the `navigationPlugin.getNavmeshData(): Uint8Array` (present in V1 as well) or `navigationPlugin.getTileCacheData(): Uint8Array` (new) functions to get the navmesh binary data. You can import the exported data using:

```ts
navigationPlugin.buildFromNavmeshData(data: Uint8Array): void
navigationPlugin.buildFromTileCacheData(tileCacheData: Uint8Array, tileCacheMeshProcess?: TileCacheMeshProcess): void
```

## ES6 example

```
npm i @babylonjs/addons @recast-navigation/core @recast-navigation/generators
```

```ts
import { CreateNavigationPluginAsync } from "@babylonjs/addons";
import * as RecastCore from "@recast-navigation/core";
import * as RecastGenerators from "@recast-navigation/generators";

await RecastCore.init();
const navigationPlugin = await CreateNavigationPluginAsync({
    instance: {
        ...RecastCore,
        ...RecastGenerators,
    },
});
```

Since you are injecting the `recast-navigation` libraries yourself, you can also use the plugin with the `NullEngine` on a server, because when an instance is injected this way, the libraries will not be loaded using an HTML &lt;script&gt; tag.

## Recommended links not just for first time users

Most of the functions in the navigation plugin interface are self-explanatory, even for first-time users. It is recommended to get familiar with concepts at Recast: [https://recastnav.com/](https://recastnav.com/).

Since the navigation plugin V2 acts as a facade around `recast-navigation-js`, it is recommended to visit the recast-navigation-js [GitHub repo](https://github.com/isaac-mason/recast-navigation-js) as well.

To easily generate your NavMesh and/or TileCache, use the [NavMesh generator](https://navmesh-generator.babylonjs.xyz/)

## Pages in this section

- [Introduction to what's new in NavigationPlugin V2](https://doc.babylonjs.com/features/featuresDeepDive/crowdNavigation/v2Intro/v2WhatsNew.md): Learn about the new features of NavigationPlugin V2, including new mesh parameters, improved utilities, and performance optimizations.