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.
Quick answer
Which CNPC-npcpathfinding release matches 1.12.2?
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.
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.
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.
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.
- 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.
- 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.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 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.
1.21.1
1 loader build1.20.1
1 loader build1.12.2
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
CNPC-npcpathfinding versions and loaders
npcpathfindinglegacy-1.12.2Forge-2.0.6.jar
22 Nov 2026
NpcPathfindingLegacy-1.12.2-2.0.5.jar
20 Nov 2026
NpcPathfindingLegacy-2.0.0-1.12.2Forge.jar
NpcPathfindingLegacy-1.12.2-2.0.0.jar
13 Nov 2026
NpcPathfindingLegacy-1.0.2-1.12.2.jar
NpcPathfindingLegacy-1.12.2-1.0.2.jar
25 Jul 2026
Looking for an older file? The official CurseForge project page is in Resources.