godot-ai-navigation
Installation
SKILL.md
Decision Trees (MANDATORY script triggers)
1. Node agent vs NavigationServer RID
| Signal | Choice | Pathfinding script (MANDATORY read) |
|---|---|---|
| 2D top-down / side-scroller, < ~50 agents, editor-tweakable | NavigationAgent2D on CharacterBody2D |
smart_navigation_agent.gd |
| 3D floor/slope nav, < ~50 agents, designer-placed regions | NavigationAgent3D on CharacterBody3D |
Same script (3D branch); pair with godot-physics-3d for body collision |
| Hundreds–thousands of simple movers (2D or 3D) | RID agents on NavigationServer | server_navigation_setup.gd + low_level_avoidance.gd |
| Agents stuck / jittering | Stuck recovery before retarget spam | agent_stuck_detection.gd |
2. Bake vs obstacle
| Signal | Choice | Pathfinding script (MANDATORY read) |
|---|---|---|
| Walkable geometry changed (proc gen, doors) | Async parse + bake | async_dynamic_baking.gd |
| Moving platform / shifting region | Dynamic region manager | dynamic_nav_manager.gd |
| Projectile / rolling hazard pushing agents | RVO obstacle (no full rebake) | moving_obstacle_server.gd |
| Prefer roads over mud/water | Region enter/travel costs | terrain_cost_manager.gd |