AssistanceNeeded v4.0
by Gamecock Tomahawk
=====================

A RagePluginHook plugin for GTA V that summons fire, EMS, and police units
through a single menu. Formerly "FireResponse" — now expanded to cover all
three emergency services plus absorbed features from the TooFar and
CarTooFar mods.

REQUIREMENTS
------------
- RagePluginHook (ragepluginhook.net)
- RAGENativeUI (github.com/alexguirre/RAGENativeUI)

INSTALLATION
------------
1. Copy AssistanceNeeded.dll and AssistanceNeeded.ini into your
   GTA V "plugins" folder.
2. Load via RagePluginHook.

CONTROLS
--------
LShift + F     Open/close the main menu
Hold Enter     Cancel en-route units OR dismiss all on-scene units
Hold Backspace Unstick (warp) any en-route unit to a nearby road

Ladder placement (active after selecting Summon Ladder):
  "."  (period)  Add a section
  ","  (comma)   Remove the top section
  Arrow keys   Nudge position
  Enter        Confirm placement
  Escape       Cancel

MENU STRUCTURE
--------------
Fire
  Call for Fire         Summon a fire truck with 4 firefighters to your
                        location
  Summon Ladder         Place an extendable ladder where you are standing;
                        extend upward with "." or shorten with "," — arrow
                        keys nudge position — Enter to confirm; green/blue
                        teleport cylinders appear at bottom/top
  Extract Ped           Firefighter walks to the nearest occupied vehicle
                        and pries the door with a crowbar to extract the
                        first occupant
  Eval Ped              Crew member evaluates the nearest ped to you
  Resuscitate Ped       Two firefighters perform CPR on the nearest
                        unconscious ped to you
  Extinguish Fire       All 4 firefighters equip extinguishers and spray
                        the nearest fires to you (loops until none remain)

EMS
  Call for EMS          Summon an ambulance with 2 paramedics to your
                        location
  Eval Ped              Paramedic evaluates the nearest ped to you
  Transport Ped         Stretcher-transport the nearest ped to you to
                        the ambulance
  Resuscitate Ped       Both paramedics perform CPR on the nearest
                        unconscious ped to you

Police
  Call for Code 2       Summon a cop to your location — no lights or
                        siren, parks in a clock-position around your
                        vehicle
  Call for Code 3       Summon a cop to your location — lights and siren,
                        parks at the right-side road edge
  Guard Suspect         Assign an on-scene officer to guard the nearest
                        cuffed suspect to you (reacts to threats, follows
                        if suspect moves)
  Ride to Personal      Get a ride to your last personal vehicle
    Vehicle

FEATURES
--------
- Jurisdiction-aware spawning: Metro (LSPD), County (BCSO), Highway (CHP)
  vehicles and ped models selected automatically based on zone.
- Intelligent road-node spawning with water/terrain validation.
- Stall detection and auto-reverse for stuck vehicles.
- Crew stuck detection: peds that haven't moved in 4 seconds get
  redirected sideways.
- Invisible traffic-stopper peds around parked emergency vehicles make
  ambient traffic stop realistically.
- Vehicle reposition detection: if crew wanders >5 m from vehicle edge,
  the on-scene flow is automatically re-run.
- Collision despawning: ambient vehicles touching the fire truck or
  ambulance are removed.
- Multiple police units can be active simultaneously.
- Paramedic component variations from Menyoo XML for visual variety.
- Firefighter gear (helmet, coat, pants) preserved after vehicle exit.
