DotRecast 项目教程

1. 项目的目录结构及介绍

DotRecast 是一个 C# 版本的 Recast & Detour 导航网格工具集，适用于 .NET、C#、Unity3D 游戏和服务器。项目的目录结构如下：

DotRecast/
├── resources/
├── src/
│   ├── DotRecast.Core/
│   ├── DotRecast.Recast/
│   ├── DotRecast.Detour/
│   ├── DotRecast.Detour.TileCache/
│   ├── DotRecast.Detour.Crowd/
│   ├── DotRecast.Detour.Dynamic/
│   ├── DotRecast.Detour.Extras/
│   ├── DotRecast.Recast.Toolset/
│   └── DotRecast.Recast.Demo/
├── test/
├── .editorconfig
├── .gitignore
├── BuildingAndIntegrating.md
├── CHANGELOG.md
├── DotRecast.sln
├── LICENSE.txt
└── README.md

目录结构介绍

• resources/: 项目资源文件夹。
• src/: 项目源代码文件夹，包含多个模块：
  • DotRecast.Core: 核心工具类。
  • DotRecast.Recast: 导航网格生成模块。
  • DotRecast.Detour: 导航网格数据加载、路径查找和导航网格查询模块。
  • DotRecast.Detour.TileCache: 导航网格流式加载模块，适用于大型关卡和开放世界游戏。
  • DotRecast.Detour.Crowd: 代理移动、碰撞避免和群体模拟模块。
  • DotRecast.Detour.Dynamic: 动态导航网格支持模块，结合预构建体素和动态对象。
  • DotRecast.Detour.Extras: 导入 A* Pathfinding Project 创建的导航网格的简单工具。
  • DotRecast.Recast.Toolset: 所有模块的集合。
  • DotRecast.Recast.Demo: 独立的综合演示应用程序，展示 Recast & Detour 的所有功能。
• test/: 单元测试文件夹。
• .editorconfig: 编辑器配置文件。
• .gitignore: Git 忽略文件配置。
• BuildingAndIntegrating.md: 构建和集成指南。
• CHANGELOG.md: 项目更新日志。
• DotRecast.sln: 项目解决方案文件。
• LICENSE.txt: 项目许可证文件。
• README.md: 项目介绍和使用说明。

2. 项目的启动文件介绍

DotRecast 项目的启动文件主要是 DotRecast.Recast.Demo 模块中的 Program.cs 文件。该文件负责启动演示应用程序，展示 Recast & Detour 的所有功能。

启动文件路径

src/DotRecast.Recast.Demo/Program.cs

启动文件介绍

Program.cs 文件包含了演示应用程序的主入口点。它初始化并启动演示应用程序，允许用户交互式地测试和查看导航网格生成、路径查找等功能。

3. 项目的配置文件介绍

DotRecast 项目的主要配置文件是 .editorconfig 和 .gitignore 文件。

.editorconfig

.editorconfig 文件用于配置代码编辑器的格式化规则，确保代码风格的一致性。它定义了缩进、换行符、编码等规则。

.gitignore

.gitignore 文件用于指定 Git 版本控制系统应忽略的文件和目录。它确保不会将不必要的文件（如编译输出、临时文件等）提交到版本库中。

配置文件路径

.editorconfig
.gitignore

配置文件介绍

• .editorconfig: 配置代码编辑器的格式化规则。
• .gitignore: 配置 Git 忽略的文件和目录。

通过以上配置文件，可以确保项目代码风格的一致性和版本控制的整洁性。