⚠️ CNPCPlus is mainly a creator-focused improvement mod. It does not add new blocks or items. Most changes improve existing CustomNPCs systems.

CNPCPlus 主要是一个面向创作者的改进模组。它不添加新的方块或物品。大多数变化都是为了改进现有的 CustomNPCs 系统。

CNPCPlus

English

CNPCPlus is a community-maintained enhancement project for CustomNPCs, designed for adventure maps, RPG servers, modpacks, and Minecraft storytelling projects.

CNPCPlus does not replace CustomNPCs.

Instead, it improves the original CustomNPCs experience by providing:

Bug fixes.
Compatibility improvements.
Workflow improvements for creators.
New customization options.
Better support for complex modded environments.

Most features work silently in the background.

If you are looking for new blocks, items, or visible content, you may not notice changes immediately. CNPCPlus focuses on improving the systems used by map creators, server developers, and CustomNPCs users.

Features

Recipe System Improvements

CNPCPlus greatly improves the CustomNPCs recipe editing experience.

Recipe Editor Fixes

Improvements include:

Fixed recipe item position shifting when saving custom recipes.
Improved recipe editing stability.
Reworked recipe systems in some versions.

Recipe Browser Sidebar

When editing CustomNPCs crafting recipes, CNPCPlus adds a collapsible recipe sidebar.

Features:

Quickly view available custom recipes.
Preview required ingredients.
Automatically fill recipe ingredients.
Supports Workbench 3×3 recipes.
Supports Carpenter Bench 4×4 recipes.

This makes creating large RPG maps and custom crafting systems much easier.

Recipe Compatibility Improvements

CustomNPCs recipes often have compatibility problems with modded items containing complex NBT data.

CNPCPlus improves this system by adding:

Fuzzy Matching
Name Only Checking

These options can be configured in the config file.

This improves compatibility with mods where items contain changing NBT data.

Examples:

Weapons with ammunition data.
Items with durability information.
Mods that store additional information inside items.

Compatible examples:

TACZ weapons.
Other NBT-heavy modded items.

NPC Customization Improvements

NPC Scale Expansion

Original CustomNPCs NPC scaling is limited.

CNPCPlus expands NPC scaling:

50% ~ 150% → 0% ~ 1000%

This allows creators to make:

Extremely small NPCs.
Giant NPCs.
Abnormal creatures.
Special visual effects.

No custom model is required for many effects.

Puppet Job Improvements

CNPCPlus adds more control options for Puppet NPCs.

Added:

XYZ separation distance.

This allows creators to create:

Floating body parts.
Separated limbs.
Special cinematic effects.

Useful for:

Boss scenes.
Story events.
Special map designs.

Equipment and Body Part Control

NPC equipment now has more independent control.

Supports:

Armor pieces.
Main hand items.
Off-hand items.

Controls:

Scale.
Rotation.
Separation distance.

This provides more possibilities for:

Cinematic scenes.
Boss NPCs.
Special character designs.

Creator Workflow Improvements

CNPCPlus adds several quality-of-life improvements for map creators and developers.

NPC Inventory Improvements

Added:

Shift + Left Click to quickly equip NPC items.
NPC head slots can render non-armor items.

Example:

TACZ weapons can be displayed on NPCs.

Bank Job Improvements

For players:

Shift + Left Click can quickly place items into NPC Bank Jobs.

This improves the experience of storage NPCs.

Cross-Version Community Project

CNPCPlus is maintained for multiple Minecraft versions:

Forge 1.12.2
Forge 1.20.1
NeoForge 1.21.1

The goal is to keep useful improvements synchronized between versions while respecting each version's differences.

Previously Integrated Features

Some CNPCPlus features for 1.20.1 have already been accepted and merged into upstream CustomNPCs.

These features are no longer included in CNPCPlus because they are already provided by newer CustomNPCs versions.

Integrated features:

NPC health values can exceed normal limits without AttributeFix.
Additional NPC drop modes.
Global recipe save button.
Support for "&" color codes in NPC names.
Extended NPC aggression distance.
Merchant fuzzy matching and name-only checking.
Extended combat attribute limits.

Community Feedback

CNPCPlus welcomes feedback about:

CustomNPCs bugs.
Compatibility problems.
Missing creator tools.
Feature suggestions.

If you find problems in:

CustomNPCs 1.12.2.
CustomNPCs 1.20.1.
CustomNPCs 1.21.1.

Feel free to report them.

CNPCPlus aims to make CustomNPCs better for every creator.

简体中文

CNPCPlus

CNPCPlus 是一个由社区维护的 CustomNPCs 增强项目。

主要面向：

地图作者。
冒险地图制作者。
RPG 服务器开发者。
整合包作者。
CustomNPCs 脚本开发者。

CNPCPlus 不会替代 CustomNPCs。

它的目标是在保留 CustomNPCs 原有设计理念的基础上：

修复问题。
提升兼容性。
优化制作流程。
增加 NPC 自定义能力。

许多功能不会直接添加新的方块或物品，而是在后台改善 CustomNPCs 的使用体验。

功能特点

合成表系统增强

CNPCPlus 大幅改善 CustomNPCs 的合成表制作体验。

合成表修复

包括：

修复保存自定义合成表时物品自动移位问题。
提升大量配方编辑时的稳定性。
部分版本重写合成表相关系统。

合成表侧栏

在编辑 CustomNPCs 合成表时：

新增可折叠侧栏。

功能：

快速查看已有自定义配方。
查看详细材料需求。
一键填入材料。

支持：

工作台 3×3 合成。
木工台 4×4 合成。

让大型 RPG 地图制作更加方便。

合成表兼容性增强

CustomNPCs 原版合成表对于复杂 Mod 物品支持较差。

例如：

武器弹药数据。
物品内部 NBT 数据。
自动变化的物品信息。

CNPCPlus 添加：

模糊匹配
仅名字检查

并支持配置文件调整。

可以改善：

TACZ 枪械。
大量 NBT 物品。
复杂 Mod 武器。

导致的无法合成问题。

NPC 自定义增强

NPC 缩放扩展

原版 NPC 缩放：

50% ~ 150%

CNPCPlus 扩展至：

0% ~ 1000%

可以制作：

微型 NPC。
巨型 NPC。
肢体异常角色。
特殊剧情效果。

无需特殊模型即可实现大量视觉效果。

木偶 Job 增强

新增：

XYZ 脱离距离控制。

可以实现：

身体部件分离。
悬浮效果。
特殊演出效果。

装备与身体部件独立控制

现在可以单独控制：

NPC 全套盔甲。
主手物品。
副手物品。

支持：

缩放。
旋转。
脱离距离。

方便制作：

剧情演出。
Boss NPC。
特殊场景。

制作者便利功能

NPC 物品管理优化

新增：

Shift + 左键快速给 NPC 穿戴物品。
NPC 头部可以渲染非盔甲物品。

例如：

TACZ 枪械可以直接显示在 NPC 身上。

Bank Job 优化

玩家现在可以：

Shift + 左键快速向 NPC Bank Job 放入物品。

提高仓储 NPC 的使用体验。

多版本社区维护

CNPCPlus 当前维护：

Forge 1.12.2。
Forge 1.20.1。
NeoForge 1.21.1。

目标是在多个 Minecraft 版本中同步维护实用改进。

已被 CustomNPCs 合并的功能

CNPCPlus 1.20.1 曾经包含部分功能。

这些功能目前已经被上游 CustomNPCs 接收，因此不再重复维护。

包括：

无需 AttributeFix 即可提高 NPC 最大生命值。
更多 NPC 掉落模式。
全局配方保存按钮。
NPC 名字支持 "&" 颜色符号。
NPC 仇恨距离扩展。
商人模糊匹配与仅名字检查。
战斗属性数值限制扩展。

这些功能现在由新版 CustomNPCs 提供。

社区反馈

欢迎反馈：

CustomNPCs 本体问题。
Mod 兼容问题。
制作者需求。
新功能建议。

如果你在：

CustomNPCs 1.12.2。
CustomNPCs 1.20.1。
CustomNPCs 1.21.1。

中发现问题，欢迎提交反馈。

CNPCPlus 希望让 CustomNPCs 对每一位创作者都更加好用。

CNPC-plus-Fix