# Nlelouche Unity3d Antigravityskills Navmesh Pathfinding > --- - Skill: `tomevault-io/nlelouche-unity3d-antigravityskills-navmesh-pathfinding` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/nlelouche-unity3d-antigravityskills-navmesh-pathfinding` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/nlelouche-unity3d-antigravityskills-navmesh-pathfinding/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/nlelouche-unity3d-antigravityskills-navmesh-pathfinding --- --- name: navmesh-pathfinding description: "Unity NavMesh integration for AI pathfinding with agents, obstacles, and off-mesh links." version: 2.0.0 tags: ["gameplay", "AI", "pathfinding", "NavMesh", "movement"] argument-hint: "agent_type='Humanoid' speed='3.5' angular_speed='120'" disable-model-invocation: false user-invocable: true allowed-tools: - run_command - list_dir - write_to_file requirements: unity_version: ">=6.0" render_pipeline: "Any" dependencies: [] context_discovery: check_unity_version: true check_render_pipeline: false scan_manifest_for: [] performance_budget: gc_alloc_per_frame: "0 bytes target in hot paths" max_update_cost: "O(n) - profiler-guided" tdd_first: true # ⚠️ Updated by audit v2.0.1 - needs manual test implementation --- # NavMesh Pathfinding ## Overview Unity NavMesh integration for AI pathfinding. Configure agents, bake navigation meshes, handle obstacles, and create off-mesh links for jumping/climbing. ## When to Use - Use when AI needs to navigate environments - Use when enemies chase or patrol - Use when NPCs need to avoid obstacles - Use when creating dynamic obstacles - Use when AI needs to jump gaps or climb ## Architecture ``` ┌─────────────────────────────────────────────────────────────┐ │ NavMesh Surface │ │ (Baked Navigation Data) │ └─────────────────────────────────────────────────────────────┘ ↓ ┌─────────────────────────────────────────────────────────────┐ │ NavMeshAgent │ │ (On AI Entity) │ ├─────────────────────────────────────────────────────────────┤ │ SetDestination(target) │ │ Speed, AngularSpeed, StoppingDistance │ │ AreaMask, AgentTypeID │ └─────────────────────────────────────────────────────────────┘ ↕ ↕ ┌─────────────────────┐ ┌─────────────────────┐ │ NavMeshObstacle │ │ Off-Mesh Link │ │ (Dynamic Blocker) │ │ (Jump/Climb) │ └─────────────────────┘ └─────────────────────┘ ``` ## Agent Settings - **Speed**: Movement speed (m/s) - **Angular Speed**: Rotation speed (deg/s) - **Acceleration**: Speed change rate - **Stopping Distance**: How close to destination - **Auto Braking**: Slow down near destination - **Obstacle Avoidance**: Quality vs performance ## Area Types - **Walkable**: Normal ground (cost 1) - **Not Walkable**: Blocked areas - **Jump**: Off-mesh link areas - **Custom**: Water, Road, etc. with cost modifiers ## Best Practices - ✅ Use NavMesh Surfaces for runtime baking - ✅ Set appropriate stopping distance - ✅ Use area costs for path preferences - ✅ Enable obstacle avoidance for crowds - ❌ **NEVER** call SetDestination every frame - ❌ **NEVER** forget to bake after level changes ## Few-Shot Examples ### Example 1: Chase Player **User**: "Enemy chases player using NavMesh." **Agent**: ```csharp NavMeshAgent agent = GetComponent(); agent.SetDestination(player.transform.position); ``` ### Example 2: Patrol Points **User**: "Guard patrols between waypoints." **Agent**: ```csharp if (agent.remainingDistance < 0.5f) { currentWaypoint = (currentWaypoint + 1) % waypoints.Length; agent.SetDestination(waypoints[currentWaypoint].position); } ``` ### Example 3: Check Path Valid **User**: "Only chase if path exists." **Agent**: ```csharp NavMeshPath path = new NavMeshPath(); if (NavMesh.CalculatePath(start, end, NavMesh.AllAreas, path)) { if (path.status == NavMeshPathStatus.PathComplete) agent.SetPath(path); } ``` --- ## TDD Contract > ⚠️ **Legacy Skill — Refactor Pending** > Este skill NO tiene tests automatizados aún. El siguiente boilerplate es un punto de partida. ```csharp // Escribe estos tests ANTES de implementar: // Test 1: should [expected behavior] when [condition] [Test] public void NavmeshPathfinding_Should{ExpectedBehavior}_When{Condition}() {{ // Arrange // TODO: Setup test fixtures // Act // TODO: Execute system under test // Assert Assert.Fail("Not implemented — write test first"); }} // Test 2: should handle [edge case] [Test] public void NavmeshPathfinding_ShouldHandle{EdgeCase}() {{ // Arrange // TODO: Setup edge case scenario // Act // TODO: Execute // Assert Assert.Fail("Not implemented"); }} // Test 3: should throw when [invalid input] [Test] public void NavmeshPathfinding_ShouldThrow_When{InvalidInput}() {{ // Arrange var invalidInput = default; // Act & Assert Assert.Throws(() => {{ /* execute */ }}); }} ``` ### Pasos para completar el TDD: 1. **Descomenta** los tests above 2. **Implementa** la funcionalidad mínima para que compile 3. **Ejecuta** los tests — deben fallar (RED) 4. **Implementa** la funcionalidad real 5. **Verifica** que los tests pasen (GREEN) 6. **Refactorea** manteniendo los tests verdes --- **Nota**: Este skill fue marcado como `tdd_first: false` durante la auditoría v2.0.1. La sección TDD fue agregada automáticamente pero requiere customización manual para reflejar el comportamiento real del skill. ## Related Skills - `@ai-behavior-trees` - AI decision making - `@physics-logic` - Collision handling - `@advanced-character-controller` - Player movement ## Template Files Available in templates/ folder. --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/nlelouche) — claim your Tome and manage your conversions.