Hxrish/NPC-Hostage-System-SAMP

NPC Hostage System for SA-MP & open.mp

An advanced, AI-driven roleplay hostage simulation system for SA-MP and open.mp utilizing FCNPC C++ pathfinding, node-based navigation, and realistic fear mechanics.

Features

• Advanced AI Fear Engine: Hostages have dynamic fear levels that increase when threatened, shot near, or aimed at, and decay over time. Extreme fear levels can cause hostages to panic and flee.
• Visual & Physical Complying Reactions: Real-time animations for Hands Up, Kneeling, Cowering, and Brutal Recoil Executions.
• FCNPC Pathfinding Integration: Uses GPS map node navigation to allow realistic pathing when following players or fleeing.
• Vehicle Boarding Mechanics: Order hostages to board or de-board nearby vehicles cleanly (automatically search and seat in vacant passenger spots).
• RP Blindfolding: Toggle blindfolding mechanics with automated local proximity roleplay action text messages.
• Civilian Wandering System: Automatically populates Los Santos with 100 wandering civilian NPCs with randomized male/female names, skins, and spawn coordinates aligned to the road network.
• Premium Dialogue Control Panel: Premium tablist header control panel GUI (/hostage) to command up to 3 hostages simultaneously.

Requirements

To run this filterscript, you must have the following dependencies installed on your server:

Plugins

• FCNPC Plugin (by Alex "Y_Less" Cole & maddinat0r)
• GPS Plugin (by Gamer_Z)
• sscanf Plugin (by Y_Less)

Includes

• <a_samp>
• <FCNPC>
• <GPS>
• <sscanf2>
• <zcmd>

Installation

1. Copy HostageSystem.pwn into your server's filterscripts/ directory.
2. Compile it using the Pawn compiler to generate HostageSystem.amx.
3. Add HostageSystem to the filterscripts line in your server.cfg.
4. Load the filterscript on your server or run /rcon loadfs HostageSystem ingame.

Commands

• /hostage - Opens the hostage control panel listing all your captured hostages and their current actions/fear levels.
• /spawnnpc [skinid] - Spawns a test civilian NPC in front of you (Admins only).

How to Capture a Hostage

1. Equip a threat weapon (Pistol, Shotgun, SMG, or Assault Rifle).
2. Aim at any civilian NPC at close range (within 15 meters).
3. The NPC will automatically put their hands up and comply, making them your hostage.
4. Use /hostage to issue commands.

License

This project is open-source and free to use or modify.