godot-navigation-pathfinding — скилл для Claude Code: обзор
Скилл учит ИИ-агента строить поиск путей и логику перемещения в Godot без просадок FPS. Помогает при создании NPC в стратегиях, стелс-играх и Tower Defense.
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-navigation-pathfinding -a claude-codeЧто делает godot-navigation-pathfinding
Инструкция содержит готовые правила работы с NavigationServer2D, NavigationServer3D и связкой узлов навигации. Агент узнаёт типичные грабли движка. Синхронное перезапекание полигонов прямо в геймплее даёт фризы от 100 миллисекунд. Навигация в _ready() молча ломается, если не подождать кадр физики. Скилл заставляет вызывать bake_from_source_geometry_data_async и откладывать первичную инициализацию цели через call_deferred.
В репозитории собраны узкие скрипты под разные механики. Файл async_dynamic_baking.gd фоново обновляет сетку. Для обнаружения застрявших ботов предложен agent_stuck_detection.gd, а для контроля толп без лишних узлов выделен low_level_avoidance.gd. Архитектура опирается на прямые RID сервера, когда на сцене действуют тысячи мобов. Постоянный вызов get_path в каждом кадре перегрузит сборщик мусора. Поэтому запросы оптимизируют переиспользованием объектов через query_path.
Какие задачи решает
- настроить фоновое запекание навигационной сетки без микрофризов
- управлять толпами юнитов через идентификаторы RID сервера
- выявлять застревание персонажей и выводить их из тупика
- настроить обход препятствий через радиус и колбэки RVO
- оптимизировать поиск пути переиспользованием объектов запроса
Примеры запросов агенту
- Напиши контроллер погони для врага в Godot с таймером обновления пути и проверкой финиша
- Покажи, как через NavigationServer3D и RID создать толпу мобов с обходом препятствий без узлов NavigationAgent
- Сделай асинхронную перепечку навигационной сетки на уровне с помощью async_dynamic_baking.gd
Как установить godot-navigation-pathfinding
1Через Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-navigation-pathfinding -a claude-code2Вручную: положить файлы
~/.claude/skills/godot-navigation-pathfinding/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/godot-navigation-pathfinding/
1Через Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-navigation-pathfinding -a codex2Вручную: положить файлы
.agents/skills/godot-navigation-pathfinding/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-navigation-pathfinding -a cursor2Вручную: положить файлы
.cursor/skills/godot-navigation-pathfinding/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install thedivergentai/Game-Dev-Agentic-Skills godot-navigation-pathfinding2Вручную: положить файлы
.github/skills/godot-navigation-pathfinding/SKILL.md1Через Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-navigation-pathfinding -a gemini-cli2Командой платформы
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-navigation-pathfindingВручную: положить файлы
.devin/skills/godot-navigation-pathfinding/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-navigation-pathfinding -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о godot-navigation-pathfinding
Как установить godot-navigation-pathfinding в Claude Code?
Выполните в терминале команду npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-navigation-pathfinding -a claude-code. Агент получит доступ к скриптам и рекомендациям по навигации.
Что делает godot-navigation-pathfinding?
Скилл даёт ассистенту базу готовых паттернов и скриптов для построения навигации в Godot. Он предотвращает частые баги вроде спама пересчёта пути или зависаний при синхронном запекании.
Почему нельзя обновлять target_position в каждом кадре physics_process?
Переназначение цели по 60 раз в секунду забивает процессор пересчётами маршрута. Скилл учит обновлять координаты по таймеру с шагом около 0.2 секунды либо при смещении цели дальше заданного порога.