roblox-npcs

roblox-npcs

Official sources (always check these for the latest):

• https://create.roblox.com/docs/en-us/characters/pathfinding
• https://create.roblox.com/docs/en-us/workspace/streaming
• Engine classes: PathfindingService, Path, PathWaypoint, PathfindingModifier, PathfindingLink, Humanoid

This skill covers navigation mesh pathfinding and the AI patterns that use it. It does not cover custom A* implementations unless absolutely necessary — PathfindingService is the official, optimized solution.

When to use this skill

Activate when:

• Building zombies, guards, pets, companions, or any AI that walks/follows/patrols.
• Tuning agent size, jump/climb ability, or preferred terrain.
• Handling dynamic obstacles and blocked paths.
• Using PathfindingModifier regions/links for doors, traps, ladders, boats.
• Scaling pathfinding for many agents.

Cross-reference:

• roblox-core/SKILL.md for services and Humanoid basics.
• roblox-networking/SKILL.md for server-authoritative AI.
• roblox-physics/SKILL.md for custom non-humanoid rigs and mover constraints.
• roblox-testing/SKILL.md for profiling AI cost.

PathfindingService basics

Create a path:

local PathfindingService = game:GetService("PathfindingService")

local path = PathfindingService:CreatePath({
    AgentRadius = 2,
    AgentHeight = 5,
    AgentCanJump = true,
    AgentCanClimb = false,
    WaypointSpacing = 4,
    Costs = {
        Water = 20,
        DangerZone = math.huge,
    }
})
path.CalculationSecondsTimeout = 1

Compute and follow:

local humanoid = character:WaitForChild("Humanoid")
local rootPart = character:WaitForChild("HumanoidRootPart")

local success, err = pcall(function()
    path:ComputeAsync(rootPart.Position, endPos)
end)

if success and path.Status == Enum.PathStatus.Success then
    local waypoints = path:GetWaypoints()
    -- follow waypoints with Humanoid:Move()
end