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:

NavMeshAgent agent = GetComponent<NavMeshAgent>();
agent.SetDestination(player.transform.position);

Example 2: Patrol Points

User: "Guard patrols between waypoints."

Agent:

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:

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.

// 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<Exception>(() => {{ /* 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 — claim your Tome and manage your conversions.