Description

CustomNPCs NPCs can equip armor, but normal NPC damage handling does not always behave like vanilla living entities. In many setups, armor may appear visually equipped while the incoming damage is not reduced in the expected vanilla way.

CNPC Real Armor fixes that by hooking into the CustomNPCs damage pipeline and applying vanilla-style armor calculation to NPC armor slots. It is designed as a separate damage extension mod, not as part of a gun or weapon bridge.

Main Features

Applies armor reduction to normal CustomNPCs NPCs.
Uses armor item stats instead of manually subtracting health.
Optional armor toughness calculation.
Optional Protection enchantment calculation.
Optional armor knockback resistance support.
Configurable CustomNPCs resistance and vanilla armor calculation order.
Optional companion armor override.
Optional split NPC armor damage for humanoid EntityCustomNpc NPCs.
Optional armor durability damage.
Optional in-game debug messages for hit location and damage values.
In-game config screen through the Forge Mods menu.
Runtime commands for quick testing and tuning.

Split NPC Armor Damage

When split NPC armor damage is enabled, humanoid CustomNPCs NPCs use different armor slots depending on hit location:

Head hits use the helmet slot.
Chest hits use the chestplate slot.
Leg hits use leggings and boots.

The split system is limited to EntityCustomNpc humanoid NPCs. It uses CustomNPCs model part scale data to estimate head, chest, and leg regions. Non-humanoid NPCs fall back to normal full-armor calculation.

In-game Commands

Requires permission level 2.

/cnpc_real_armor status
/cnpc_real_armor split true
/cnpc_real_armor split false
/cnpc_real_armor durability true
/cnpc_real_armor durability false
/cnpc_real_armor debug true
/cnpc_real_armor debug false

These commands apply immediately while the game is running.

Config

The config can be changed from the Forge Mods menu in-game. Most options apply immediately after being changed.

Important options:

Enable vanilla armor calculation
Enable armor toughness
Enable Protection enchantments
Enable armor knockback resistance
Enable split NPC armor damage
Damage armor items
Debug damage messages
Override companion armor behavior
Armor stat source
CustomNPCs resistance order

Debug Mode

Debug mode is disabled by default.

When enabled, the mod sends in-game messages showing the attacker, target NPC, detected body part, damage source, original damage, and final armor-adjusted damage. This is useful for tuning hit detection and armor behavior in modpacks.

Compatibility

Built for:

Minecraft 1.20.1
Minecraft Forge 47.x
CustomNPCs 1.20.1 GBPort Unofficial

This mod is independent from TACZ Fire. If TACZ or another weapon mod sends damage through the normal Minecraft or CustomNPCs damage pipeline, CNPC Real Armor can apply to that damage. If another mod fully replaces, cancels, or rewrites damage outside that pipeline, behavior may vary.

Known Limits

FirstAid compatibility is not implemented yet.
Same-faction damage cancel override is not included in the first release.
Body-part detection is best-effort and currently supports head, chest, and legs only.
Installing or updating the mod jar still requires restarting Minecraft. Config changes after launch do not require a restart.