DESCRIPTION
Simple generator for NPCs, which takes care that not too many NPCs exist at the same time, so that other NPCs and animals can spawn (keyword "entity overflow").
For example, you have a shop or quest script without NPC support? Then you can place NPCs for it with nss_npc.
FEATURES
- Creates static NPCs at specific coordinates.
- Performance-system to prevent "entity overflow".
- NPCs spawn on client if player reach a certain distance.
- Wild animals and herds (new since 1.2.0)
- Animals wander around an anchor point, optionally as a herd and with real wild behaviour.
- Optional respawn: hunted animals come back after a delay, away from every player, never in front of one.
- No spawn zones for ambient peds (new since 1.2.0)
- Stop the engine from placing new ambient peds in an area, e.g. inside your saloon.
- Setup helper for admins (new since 1.2.0)
/npcdevshows herd anchors, roaming areas and zone centers as markers and map blips./npcposprints your position ready to paste.
- All configurable!
- Scale
- Model and outfit
- Spawn radius
- Spawn type (optional)
- Place NPC automatically on ground or stick him at coords.
- Helps to prevent NPC stuck in ground, e.g. in custom buildings.
- Animations (optional)
- So many animations as you want per NPC.
- Create timed animation chains.
- Time windows (optional)
- So many time windows as you want per NPC.
- E.g. NPC only spawn between 8am - 12am and 2pm - 8pm.
- Weapons (optional)
- Enable weapons for NPC.
- Blips (optional)
- Blip color changes if NPC is visible between time window.
- Prompts (optional)
- So many prompts as you want per NPC.
- Prompts grouped in tabs/pages.
- Prompt callbacks to trigger events or commands or whatever you want.
- NPC definition validator to help you out if you make a mistake in your config.
- Never miss updates again:
- Automatic version check included.
- Automatic dependency version check included.
- Know how it works: Everything is documented in detail in the README.md and commented in the config.demo.lua file as well as in the demo npc, animal and zone config files.
DEPENDENCIES
- nss_libs 0.38.0 (or higher)
SUPPORT & INFO
- Discord
- Read the README.md for setup.
- This script is encrypted.
- The price of the product will increase the more features are added.
CHANGELOG
- v1.2.1 (2026-10-26)
- Fix: leaving the spawn radius and coming back, or reconnecting, no longer skips
respawn_delay_in_ms. Every lost animal locks its slot for the delay, and the delay starts with the kill. - Fix: the cleanup no longer deletes carcasses, a catch on the horse stays.
- Fix: the cleanup only touches animals of the herd, never an entity that took over a reused network id.
- Fix: leaving the spawn radius and coming back, or reconnecting, no longer skips
- v1.2.0 (2026-08-28)
- New: wild animals and herds. Put them in the
animalsfolder and list them inconfig_animals.lua. They wander around an anchor point, optionally as a herd and with real wild behaviour. - New: optional respawn for herds, see
respawn_delay_in_ms. Replacements appear away from every player, never in front of one. - New: no spawn zones for ambient peds. Put them in the
zonesfolder and list them inconfig_zones.lua. A zone deletes nothing, it stops the engine from placing new ambient peds inside it. - New: setup helper for admins, see
config_dev.lua./npcdevdraws herd anchors and zone centers as markers and as map blips, including a radius blip for the roaming area of a herd,/npcposprints your position ready to paste. Regular players see nothing and no thread runs for them. - Change: a broken or empty
Config.NpcListno longer stops animals and zones from loading. The three parts are independent now.
- New: wild animals and herds. Put them in the
- v1.1.2 (2023-08-03)
- Fix blip title.
- v1.1.1 (2023-04-03)
- Use new
nss_libsversion 0.23.0 withnpcmodule update for better performance.
- Use new
- v1.1.0 (2023-03-30)
- New
prevent place on groundfeature (addprevent_place_on_groundto NPC config). - Add
nameas required property to NPC config. - Add prompt support (add
promptsproperty to NPC config). - Add dependency check.
- New
- v1.0.2 (2023-03-14)
- Prevent encrypting files in
npcsfolder.
- Prevent encrypting files in
- v1.0.1 (2023-02-17)
- Add blip support.
- v1.0.0 (2023-02-17)
- Initial release.