|
|
||
|---|---|---|
| .github | ||
| DebugUtils | ||
| Detour | ||
| DetourCrowd | ||
| DetourTileCache | ||
| Docs | ||
| Recast | ||
| RecastDemo | ||
| Tests | ||
| .clang-format | ||
| .clang-tidy | ||
| .editorconfig | ||
| .gitignore | ||
| CHANGELOG.md | ||
| CMakeLists.txt | ||
| CODE_OF_CONDUCT.md | ||
| CONTRIBUTING.md | ||
| Doxyfile | ||
| License.txt | ||
| README.md | ||
| recastnavigation-config.cmake.in | ||
| recastnavigation.pc.in | ||
| version.h.in | ||
Recast Navigation
State-of-the-art navmesh generation and navigation for games.
🚀 Features
- 🤖 Automatic - Recast can generate a navmesh from any level geometry you throw at it
- 🏎️ Fast - swift turnaround times for level designers
- 🧘 Flexible - detailed customization options and modular design let you tailor functionality to your specific needs
- 🚫 Dependency-Free - building Recast & Detour only requires a C++98-compliant compiler
- 💪 Industry Standard - Recast powers AI navigation features in Unity, Unreal, Godot, O3DE and countless AAA and indie games and engines
Recast Navigation is divided into multiple modules, each contained in its own folder:
Recast/- Navmesh generationDetour/- Runtime loading of navmesh data, pathfinding, navmesh queriesDetourTileCache/- Navmesh streaming. Useful for large levels and open-world gamesDetourCrowd/- Agent movement, collision avoidance, and crowd simulationDebugUtils/- API for drawing debug visualizations of navigation data and behaviorTests/- Unit testsRecastDemo/- Standalone, comprehensive demo app showcasing all aspects of Recast & Detour's functionality
⚡ Getting Started
Check out BuildingAndIntegrating.md for information on how to build the comprehensive RecastDemo project, as well as guidance on integrating Recast & Detour into your own project.
If you are new to Recast & Detour, check out Sample_SoloMesh.cpp in RecastDemo to get started with building navmeshes and NavMeshTesterTool.cpp for building paths with Detour.
⚙ How it Works
Recast constructs a navmesh through a multi-step mesh rasterization process.
- First Recast rasterizes the input triangle meshes into voxels.
- Voxels in areas where agents would not be able to move are filtered and removed.
- The walkable areas described by the voxel grid are then divided into sets of polygonal regions.
- The navigation polygons are generated by re-triangulating the generated polygonal regions into a navmesh.
You can use Recast to build a single navmesh, or a tiled navmesh. Single meshes are suitable for many simple, static cases and are easy to work with. Tiled navmeshes are more complex to work with but better support larger, more dynamic environments. Tiled meshes enable advance Detour features like re-baking, heirarchical path-planning, and navmesh data-streaming.
📚 Documentation & Links
Official documentation is available at recastnav.com
Docs are generated via Doxygen from source file comments and from markdown files in the Docs/ directory.
❤ Community
Ask questions, voice ideas, or request new features over on Github Discussions or on our old Google Group list.
Check out the Development Roadmap to see what features and functionality you might be able to help with, and the Contribution Guidelines for information on how to make contributions.
Our Code of Conduct applies to all Recast Navigation community channels.
⚖ License
Recast & Detour is licensed under the ZLib license. See License.txt for more.