# ue-ai-navigation

Скилл для написания C++ ИИ в Unreal Engine 5.8: контроллеры, деревья поведения, восприятие, navmesh и EQS. Пригодится, когда агент пишет код ИИ и путает API.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1100 установок · ★ 405
- Автор: quodsoler
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/quodsoler/unreal-engine-skills/tree/HEAD/skills/ue-ai-navigation/SKILL.md
- Обновлён: 2026-09-28
- HTML: https://affpapa.org/nevibecode/skills/ue-ai-navigation

## Что делает

Скилл описывает классический стек ИИ Unreal: серверный `AAIController`, который держит `UBehaviorTreeComponent`, `UBlackboardComponent`, `UAIPerceptionComponent` и `UPathFollowingComponent`. Внутри — примеры кода и таблицы выбора: когда брать `MoveToActor` или `MoveToLocation`, а когда `MoveTo` с `FAIMoveRequest` и указателем на путь. Есть разделы по блэкборду, узлам деревьев поведения, восприятию, запросам к навигации, областям и off-mesh links, EQS и Smart Objects.

API сверены с заголовками UE 5.8, устаревшие формы вынесены отдельно с пометкой не использовать. Модули подключаются вручную: `AIModule`, `NavigationSystem` и `GameplayTasks` нужно добавить в `PublicDependencyModuleNames` в `.Build.cs`. Smart Objects, ZoneGraph, MassAI и NavCorridor — опциональные плагины, и в 5.8 ZoneGraph, MassAI и NavCorridor помечены как Experimental. Это повод проверить, готовы ли вы тянуть экспериментальные подсистемы в продакшен.

Скилл заглядывает в `.agents/ue-project-context.md`, если тот есть, и не останавливается, когда файла нет. Смежные темы вынесены в отдельные скиллы: State Tree — в `ue-state-trees`, Mass-толпы — в `ue-mass-entity`, движение по путям — в `ue-character-movement`.

## Требования
- Работает с: Unreal Engine

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add quodsoler/unreal-engine-skills --skill ue-ai-navigation -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/ue-ai-navigation/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/ue-ai-navigation/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add quodsoler/unreal-engine-skills --skill ue-ai-navigation -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/ue-ai-navigation/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add quodsoler/unreal-engine-skills --skill ue-ai-navigation -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/ue-ai-navigation/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install quodsoler/unreal-engine-skills ue-ai-navigation
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/ue-ai-navigation/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add quodsoler/unreal-engine-skills --skill ue-ai-navigation -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/quodsoler/unreal-engine-skills --path skills/ue-ai-navigation
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/ue-ai-navigation/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add quodsoler/unreal-engine-skills --skill ue-ai-navigation -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/quodsoler/unreal-engine-skills/tree/HEAD/skills/ue-ai-navigation/SKILL.md

## Когда брать
- написать `AAIController`, который запускает дерево поведения и реагирует на восприятие
- связать стимулы восприятия с ключами блэкборда через `FAIStimulus`
- выбрать между `MoveToActor`, `MoveToLocation` и `MoveTo` с `FAIMoveRequest`
- подключить нужные модули в `.Build.cs` для ИИ и навигации
- развести задачи между скиллами: State Tree, Mass, движение персонажа

## Примеры запросов агенту
- Напиши `AMyAIController`, который в `OnPossess` запускает дерево поведения и подписывается на `OnTargetPerceptionUpdated`
- Добавь кастомный `UBTTaskNode` с `ExecuteTask` и `FinishLatentTask` для перемещения к цели
- Настрой `UAISenseConfig_Sight` и запиши последнюю известную позицию цели в блэкборд

## Похожие
- [unreal-cpp-gameplay](https://affpapa.org/nevibecode/skills/unreal-cpp-gameplay.md) — скилл · 5300 установок
- [unreal-niagara](https://affpapa.org/nevibecode/skills/unreal-niagara.md) — скилл · 5200 установок
- [unreal-engine-cpp-pro](https://affpapa.org/nevibecode/skills/unreal-engine-cpp-pro.md) — скилл · 1400 установок
- [unreal-engine](https://affpapa.org/nevibecode/skills/unreal-engine.md) — скилл · 511 установок
- [initialize-ai-navigation](https://affpapa.org/nevibecode/skills/initialize-ai-navigation.md) — скилл · 5400 установок
- [cli-anything-unrealinsights](https://affpapa.org/nevibecode/skills/cli-anything-unrealinsights.md) — скилл · 434 установки

Из того же набора: [quodsoler/unreal-engine-skills](https://affpapa.org/nevibecode/by/quodsoler/unreal-engine-skills.md) — 25 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md