Step 1: Download Project Archive (.zip) Шаг 1: Скачивание zip-архива проекта

Download the source code archive directly from the GitHub repository: Скачайте архив исходного кода напрямую из репозитория GitHub:

Download Repository (.zip) Скачать репозиторий (.zip) View on GitHub Открыть на GitHub

Option A: Windows Вариант A: Windows

Extract the downloaded fps-starter-box3d-recast-behaviortree-opengl-sdl3-desktop-main.zip archive so that its files reside in: Распакуйте скачанный архив fps-starter-box3d-recast-behaviortree-opengl-sdl3-desktop-main.zip так, чтобы его содержимое находилось в:

C:\projects\fps-starter-box3d-recast-behaviortree-opengl-sdl3-desktop

Option B: Ubuntu (Terminal) Вариант B: Ubuntu (Терминал)

On Ubuntu, you can download and extract the repository in your terminal using wget and unzip: В Ubuntu вы можете скачать и распаковать репозиторий в терминале с помощью wget и unzip:

sudo apt update && sudo apt install -y wget unzip

mkdir -p ~/projects
cd ~/projects

wget https://github.com/ivan-enzhaev/fps-starter-box3d-recast-behaviortree-opengl-sdl3-desktop/archive/refs/heads/main.zip -O fps-starter-box3d-recast-behaviortree-opengl-sdl3-desktop-main.zip
unzip -o fps-starter-box3d-recast-behaviortree-opengl-sdl3-desktop-main.zip
mv fps-starter-box3d-recast-behaviortree-opengl-sdl3-desktop-main fps-starter-box3d-recast-behaviortree-opengl-sdl3-desktop
rm -f fps-starter-box3d-recast-behaviortree-opengl-sdl3-desktop-main.zip

cd ~/projects/fps-starter-box3d-recast-behaviortree-opengl-sdl3-desktop

Step 2: Project Structure Overview Шаг 2: Обзор структуры проекта

The extracted directory contains the complete source code, assets, and ready-to-use build scripts: Распакованная директория содержит полный исходный код, ассеты и готовые скрипты сборки:

fps-starter-box3d-recast-behaviortree-opengl-sdl3-desktop/
├── assets/
│   └── models/
│       └── cube/
│           ├── check-grid-cube.glb
│           └── check-grid-512.jpg
├── src/
│   ├── app.h               # Core state struct & OpenGL handles
│   ├── enemy_ai.h          # Recast NavMesh & BehaviorTree enemy declarations
│   ├── enemy_ai.cpp        # Detour crowd updates & BT logic implementation
│   ├── fps_controller.h    # WASD movement, jumping & mouse look
│   ├── fps_controller.cpp
│   ├── model_utils.h       # cgltf loader & ground plane generator
│   ├── model_utils.cpp
│   ├── physics_debug.h     # Box3D debug shape drawing callbacks & line helpers
│   ├── physics_debug.cpp
│   ├── shader_utils.h      # Shader programs for textured meshes & debug lines
│   ├── shader_utils.cpp
│   ├── texture_utils.h     # SDL3 texture loader (GL_REPEAT tiling)
│   ├── texture_utils.cpp
│   └── main.cpp            # SDL3 callbacks (Init, Event, Iterate, Quit)
├── build-bin.sh            # Ubuntu build script
├── build-exe.bat           # Windows build script
├── CMakeLists.txt          # CMake configuration
├── config-bin.sh           # Ubuntu configure script
├── config-exe.bat          # Windows configure script
├── run-bin.sh              # Ubuntu execution script
└── run-exe.bat             # Windows execution script

Step 3: Build & Run the Application Шаг 3: Сборка и запуск приложения

The repository already includes pre-configured scripts to configure, build, and run the project. Репозиторий уже содержит готовые скрипты для конфигурации, сборки и запуска проекта.

Windows (Command Prompt / PowerShell)

Run the batch scripts sequentially from the project root folder: Последовательно запустите командные файлы из корневой папки проекта:

config-exe.bat
build-exe.bat
run-exe.bat

Ubuntu (Terminal)

Grant execution permissions to the shell scripts first, then run them sequentially: Сначала предоставьте права на исполнение shell-скриптам, затем последовательно запустите их:

chmod +x config-bin.sh build-bin.sh run-bin.sh

./config-bin.sh
./build-bin.sh
./run-bin.sh

Step 4: Controls & Expected Output Шаг 4: Управление и ожидаемый результат

When launched, you are placed in a 60×60m arena with enemy cubes navigating towards you using Detour Crowd pathfinding and BehaviorTree logic. При запуске вы появляетесь на арене 60×60м с вражескими кубами, которые перемещаются к вам с помощью поиска путей Detour Crowd и логики BehaviorTree.

Debug Visuals Legend (when active): Легенда отладочной визуализации (при включении):