# unreal-behavior-trees

Скилл помогает собирать AI NPC в Unreal Engine 5 через Behavior Trees и Blackboards. Нужен для врагов, патрулей и реактивных веток поведения.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 5200 установок · ★ 4506
- Автор: gamedev-skills
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/gamedev-skills/awesome-gamedev-agent-skills/tree/HEAD/skills/unreal/unreal-behavior-trees/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/unreal-behavior-trees

## Что делает

Скилл описывает рабочую схему AI для Unreal Engine 5.8: Blackboard хранит ключи вроде `TargetActor` и `LastKnownLocation`, Behavior Tree задаёт логику, а `AAIController` запускает дерево через `RunBehaviorTree(BT)`. Ветки строятся из Selector, Sequence и Simple Parallel.

Decorators проверяют условия Blackboard, Services обновляют состояние активной ветки, а Tasks возвращают `Succeeded`, `Failed` или `InProgress`. Для отладки используется Behavior Tree debugger в PIE, где видны выполняемый узел и текущие значения Blackboard. Скилл также разбирает C++-код для `BTTask` и обновления ключей из контроллера.

Проекту нужен Unreal Engine 5.8 и связка `BT_`/`BB_` с `AAIController`. Без Nav Mesh `MoveTo` завершится с ошибкой, а задача, которая оставила `InProgress` без `FinishLatentTask`, повиснет. Если в проекте уже применяются StateTree, это повод проверить архитектуру до добавления Behavior Tree.

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

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill unreal-behavior-trees -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill unreal-behavior-trees -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill unreal-behavior-trees -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gamedev-skills/awesome-gamedev-agent-skills unreal-behavior-trees
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill unreal-behavior-trees -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/gamedev-skills/awesome-gamedev-agent-skills --path skills/unreal/unreal-behavior-trees
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill unreal-behavior-trees -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/gamedev-skills/awesome-gamedev-agent-skills/tree/HEAD/skills/unreal/unreal-behavior-trees/SKILL.md

## Когда брать
- собрать `BT_` и `BB_` для AI NPC
- развести ветки атаки, преследования и патруля
- связать Blackboard с `AAIController`
- написать собственный `BTTask` или `BTService`
- найти причину сбоя `MoveTo` или зависшей задачи

## Примеры запросов агенту
- Собери для врага Behavior Tree с приоритетом: атака по `TargetActor`, затем поиск в `LastKnownLocation`, затем патруль.
- Напиши C++-класс `BTTask` для перемещения к `TargetActor` и корректно заверши latent-задачу.
- Проверь, почему `MoveTo` сразу завершается с ошибкой, и покажи, что нужно проверить в Nav Mesh и Blackboard.

## Похожие
- [ue-state-trees](https://affpapa.org/nevibecode/skills/ue-state-trees.md) — скилл · 1100 установок
- [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 установок
- [unreal-engine-skills-for-claude-code](https://affpapa.org/nevibecode/plugins/unreal-engine-skills-for-claude-code.md) — плагин · ★ 1634
- [game-developer](https://affpapa.org/nevibecode/skills/game-developer.md) — скилл · 6400 установок
- [ue-cpp-foundations](https://affpapa.org/nevibecode/skills/ue-cpp-foundations.md) — скилл · 1400 установок

Из того же набора: [gamedev-skills/awesome-gamedev-agent-skills](https://affpapa.org/nevibecode/by/gamedev-skills/awesome-gamedev-agent-skills.md) — 77 карточек

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

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