Back to mods
CNPC-npcpathfinding project artwork

CurseForge · Minecraft mod

CNPC-npcpathfinding

A smarter NPC pathfinding system for CustomNPCs. Adds an advanced optional pathfinder with parkour, sprinting, interception, better performance, and configurable block whitelist/blacklist support. Compatible with original CNPC pathfinding.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which CNPC-npcpathfinding release matches 1.12.2?

Updated today
Best match for your filters npcpathfindinglegacy-1.12.2Forge-2.0.6.jar
Game version 1.12.2
Loader Forge

CNPC-npcpathfinding npcpathfindinglegacy-1.12.2Forge-2.0.6.jar targets 1.12.2 with Forge. The project page does not say whether this file belongs on the client, dedicated server, or both. 2 required mods need a matching file.

Where it goes

Is CNPC-npcpathfinding required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does CNPC-npcpathfinding npcpathfindinglegacy-1.12.2Forge-2.0.6.jar need?

npcpathfindinglegacy-1.12.2Forge-2.0.6.jar on 1.12.2. Every mod below is checked against that same setup.

2 required mods need a matching file

Install CNPC-plus-Fix, Custom NPCs, CustomNPCs-Unofficial first, but 2 required mods have no matching file for this setup. Do not mix loader builds to force a match.

CNPC-plus-Fix Needed by CNPC-npcpathfinding npcpathfindinglegacy-1.12.2Forge-2.0.6.jar
required
Matching file found Matched file: cnpcplus-4.1.0shaders-fix-1.12.2Forge.jar
Custom NPCs Needed by CNPC-npcpathfinding npcpathfindinglegacy-1.12.2Forge-2.0.6.jar
required
No matching file
CustomNPCs-Unofficial Needed by CNPC-npcpathfinding npcpathfindinglegacy-1.12.2Forge-2.0.6.jar
required
No matching file

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add CNPC-npcpathfinding without breaking your instance.

Built for CNPC-npcpathfinding npcpathfindinglegacy-1.12.2Forge-2.0.6.jar on 1.12.2. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use npcpathfindinglegacy-1.12.2Forge-2.0.6.jar. It targets 1.12.2 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install CNPC-plus-Fix, Custom NPCs, CustomNPCs-Unofficial first, but 2 required mods have no matching file for this setup. Do not mix loader builds to force a match.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside npcpathfindinglegacy-1.12.2Forge-2.0.6.jar. It opens that exact file at the source.

About this project

What does CNPC-npcpathfinding add?

My Discord Group:https://discord.gg/rSaFbj89Te

About This Mod

CNPC-NPC-Pathfinding is an NPC pathfinding optimization mod designed specifically for Minecraft map makers.

It adds a new button to the NPC AI settings, allowing users to independently switch the pathfinding system for each individual NPC.

It also completely reworks the Tactical Variants system, providing NPCs with more advanced combat capabilities.

Additionally, it provides a configuration file that allows individual blocks to be added to a blacklist or whitelist, determining whether NPCs should treat them as passable or impassable.


Main Features

1. Multiple Pathfinding Systems

A new button has been added to the NPC AI settings, allowing users to independently configure the pathfinding AI of each NPC.

Currently, 8 additional pathfinding methods are available, providing more choices for different environments and gameplay scenarios.

2. Tactical Variants Rework and Expansion

The Tactical Variants system has been completely rewritten and expanded, providing:

  • 9 group tactics.
  • 10 individual tactics.

These tactics allow NPCs to adopt more diverse combat strategies and behave more intelligently in battle.

3. Special Block Passability Detection

Through the provided configuration file, users can define how NPCs interact with specific blocks across all pathfinding modes.

  • Whitelist: NPCs treat listed blocks as passable and attempt to move through them. Examples include water, ladders, and banners.
  • Blacklist: NPCs treat listed blocks as impassable and attempt to avoid them. Examples include lava, fire, and cobwebs.

4. Backward Compatibility with Existing Worlds

This mod can be safely installed into existing worlds.

All NPCs default to the original CNPC pathfinding system when generated, and removing the mod will not cause destructive damage to existing world data.


Why Are There So Many Additional Pathfinding Methods?

The original CNPC pathfinding system has several limitations:

  • NPCs always prioritize the shortest route. This often causes them to get stuck on partial blocks and blocks added by other mods.
  • NPCs generally calculate their paths only once. When blocked by partial blocks or other modded blocks, they continue trying to move forward instead of adjusting their route.
  • NPCs do not actively use diagonal movement, significantly reducing their movement efficiency in certain maps and pursuit scenarios.
  • NPCs consider most blocks impassable. Even ladders and other normally traversable blocks can cause repeated movement attempts.
  • NPCs cannot sprint and lack pathfinding capabilities for basic parkour scenarios.
  • NPCs repeatedly generate new paths while searching for targets but often fail to make effective use of them, resulting in significant performance issues when multiple NPCs are fighting.

Additional pathfinding methods provide more flexibility, allowing users to choose different systems for different NPCs and scenarios.


Tactical Variants

Tactical Variants Selection Interface

Why Was the Tactical Variants System Rewritten?

The original Tactical Variants system in CNPC-NPC-Pathfinding was far from satisfactory. In fact, this feature was relatively incomplete in versions other than 1.20.1.

The original CNPC Tactical Variants system also suffered from serious memory leaks, and many of its features simply did not work correctly. In version 1.21.1, this system was removed entirely by upstream.

This mod restores and fixes the functionality while expanding its capabilities, allowing users to create more sophisticated combat experiences without relying on scripts.

Project description from CurseForge.

Pick your setup

CNPC-npcpathfinding by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

3 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

CNPC-npcpathfinding versions and loaders

4 of 12 releases match
Clear filters

Looking for an older file? The official CurseForge project page is in Resources.