zcnpci/README.md

# Z-City NPC Integration

Adds better NPC integration for the Garry's Mod addon Z-City. While Z-City has a convar that enables the custom health system on NPCs, it really isn't the best or most advanced thing in the world. This has irritated me since I first started using Z-City. Therefore, I've decided to take care of the problem myself with my own plugin.

- NPCs can be ragdolled like players can, and will wiggle around on the ground. They can get back up, too!
- It takes all elements of Z-City's health system into account, such as unconsciousness and pain.
- Various configurable settings are included, allowing you to tweak the mod to your liking.

This mod is built to perform reasonably well, thus it includes optimizations, configurable performance settings, and an automatic corpse remover.

This addon is based off of Kazarei's Euphoria, which in turn is a fork of Fedhoria by Rama. Credits to them for making the cool thing.

## Known issues

- Kicking NPCs does not knock them down. The same goes for many melee attacks. This is not something I know how to easily fix -- I would have to override code in Z-City, which I would rather not do. If you do know how to easily fix this, reach out, I would love to add it.
- Bandages, tourniquets, etc. that are on the ragdoll or NPC body will not be there when they get back up.

- NPCs currently instantly get up, with no animation. I plan on remedying this in the future.
- Enemy NPCs will not target living downed NPCs like how they do players. This will be fixed.

## Incompatibilities

- Any mod that modifies the behavior of death ragdolls (Reagdoll, Artagdoll, Fedhoria)
- Mods that automatically remove death ragdolls (it will delete all ragdolled NPCs, even if they're still alive! Try the built-in automatic corpse removal instead.)

## Future plans

No guarantees any of this will become real.

- NPCs will back out of combat when injured.
- Friendly NPCs can heal each other.
- NPCs can heal themselves.