ESX

AI Paramedic Documentation for ESX

Introduction

AI Paramedic is an advanced automatic medical rescue system for FiveM servers with ESX framework. The script introduces intelligent AI paramedics who respond to calls from players in critical condition, adapting the rescue vehicle type to the player's location.

Key Features

• 3 rescue types: ambulance, helicopter, boat

• Intelligent vehicle selection based on location

• 2 rescue modes: normal (on-site resuscitation) and advanced (hospital transport)

• Bucket system for player isolation during transport

• Realistic surgery simulation with NUI interface

• ETA system with arrival time calculation

• 11 languages: English, German, Spanish, French, Dutch, Polish, Portuguese, Thai, Turkish, Arabic, Chinese

System Requirements

Required

• FiveM Server (latest version)

• ESX Framework (Legacy or newer)

• es_extended (imported in manifest)

• esx_progressbar (for progress bars)

Optional Resources

Included in package:

• polmav - helicopter model

• emsprops - medical props (stretcher, AED)

• strykergurney - stretcher model

• loweredstrykergurney - lowered stretcher model

Technical Requirements

• Server RAM: minimum 2GB free memory

• Processor: 2+ cores

• OneSync: recommended for bucket stability

Installation

Step 1: Prepare Files

Extract archive to resources folder:

cd resources
unzip ylean_aiparamedic.zip

File structure should look like:

ylean_aiparamedic/
├── config.lua
├── death_causes.lua
├── fxmanifest.lua
├── src/
│   ├── client.lua
│   └── server.lua
├── locales/
│   ├── en.lua
│   ├── pl.lua
│   └── ...
└── nui/
    ├── index.html
    ├── script.js
    ├── style.css
    ├── locales/
    │   ├── en.json
    │   ├── pl.json
    │   └── ...
    └── media/
    

Step 2: Install Dependencies

In server.cfg add in order:

ensure es_extended
ensure esx_progressbar
ensure emsprops      -- optional
ensure polmav        -- optional
ensure ylean_aiparamedic

Step 3: Database Configuration

✅ Note: Script DOES NOT REQUIRE database changes - works without additional tables.

Step 4: Verify Installation

Test command in F8 console:

/callambulance

If message appears, installation is successful.

Configuration

Basic Settings

Framework and Localization

Ylean.Locales = "en"  -- Interface language
Ylean.ReviveEvent = "esx_ambulancejob:revive"  -- ESX revive event
Ylean.ProgressBarResource = "esx_progressbar"  -- Progress bar resource
Ylean.Debug = true  -- Debug mode (false on production!)

NUI Language Setting

To change the surgery interface (NUI) language, edit file nui/script.js:

// Find line at the beginning of file:
let currentLanguage = 'en';

// Change to chosen language, e.g.:
let currentLanguage = 'pl';  // Polish
let currentLanguage = 'de';  // German
let currentLanguage = 'fr';  // French
// etc.

ℹ️ Available language codes: en, de, es, fr, nl, pl, pt, th, tr, ar, cn

Medic Limits

Ylean.MedicsOnline = 0  -- Max medics online for AI to work
-- 0 = AI always available
-- 1 = AI unavailable when 2+ medics online
-- 2 = AI unavailable when 3+ medics online

Special Rescue

Ylean.CanDrownBeRescued = true     -- Drowning rescue (boat)
Ylean.AllowRemoteRescue = true     -- Remote area rescue (helicopter)

Job Whitelist

Ylean.WhitelistedJobs = {
    "police",      -- Police can call for free
    "ambulance",   -- Medics can always call
    "mechanic"     -- Add your own jobs
}

Rescue Modes

Normal Mode

Ylean.RescueMode = "normal"

• Medic resuscitates on site

• Uses AED defibrillator

• Resuscitation time: 10 seconds

Advanced Mode

Ylean.RescueMode = "advanced"

• Medic examines player (10 seconds)

• If injuries severe → transport to hospital

• If injuries minor → resuscitation on site

Payment System

Ylean.CallAmbulance = {
    Price = 500,               -- Call cost (0 = free)
    WayOfPayment = "cash",     -- "cash" or "bank"
    Cooldown = 120,            -- Time between calls (seconds)
    NotifyAfterCooldownEnds = true,
    CanMove = false            -- false = movement cancels rescue
}

Vehicle Configuration

Ambulance

Ylean.Ambulance = {
    SpawnRadius = 350,         -- Spawn radius (max 350!)
    Model = "ambulance",       -- Vehicle model
    Paramedic = "s_m_m_paramedic_01",
    drivingStyle = 8650758,    -- Driving style (aggressive)
    Stretcher = {
        model = "strykergurney",
        placement = {
            xPos = -1.3,
            yPos = 1.5,
            zPos = 0.0,
            xRot = 90.0,
            yRot = 100.0,
            zRot = 0.0
        }
    }
}

Helicopter

Ylean.AirAmbulance = {
    SpawnRadius = 150,
    Model = "polmav",
    WinchHeight = 4.5,         -- Winch usage height
    WinchingDuration = 5000,   -- Winching time (ms)
    LandingSpot = vector4(351.88, -588.42, 73.17, 70.1),
    Entrance = vector4(338.58, -583.91, 73.17, 69.7)
}

Boat

Ylean.WaterAmbulance = {
    Model = "dinghy",
    Speed = 10.0,
    BringLength = 10.0,        -- Water extraction distance
    BringingDuration = 5000    -- Extraction time (ms)
}

Hospital Locations

-- Hospital beds (after surgery)
Ylean.Beds = {
    {coords = vector4(353.1, -584.6, 43.11, 152.08), model = 1631638868},
    -- Add more beds as needed
}

-- Destination points
Ylean.AdvancedRescueConfig.Modes = {
    patientTransportForSurgery = {
        active = true,
        HospitalParkingPlace = vector3(359.34, -596.13, 27.61),
        HospitalEntrance = vector4(359.54, -584.81, 27.82, 73.11),
        SurgeryTime = 15  -- seconds
    }
}

Rescue Systems

Decision System

Script automatically selects rescue vehicle type:

Player Location	Vehicle Type
In water	Rescue boat
Remote area	Helicopter
Road/city	Ambulance

Rescue Flow

1. Player dies → System checks location

2. Vehicle selection → Ambulance/Helicopter/Boat

3. Rescue mode:

   • Normal → On-site resuscitation

   • Advanced → Examination → Transport (if needed)

4. Completion → Player revival

Death Causes Requiring Transport

File death_causes.lua defines categories:

Ylean.AdvancedRescueConfig.DeathCause = {
    Melee = true,      -- Melee weapons
    Knife = true,      -- Knives
    Bullet = true,     -- Gunshot
    Explosion = true,  -- Explosion
    Burn = true,       -- Burns
    FallDamage = false -- Fall
}

ETA System

Factors affecting estimated arrival time:

• Straight-line distance

• Terrain type (city/highway/mountains)

• Traffic density

• AI driving style

• Terrain height

• Time of day (rush hours)

Real speeds:

• City (traffic): 8.0 m/s

• Suburban: 22.0 m/s

• Highway: 30.0 m/s

• Mountains: 15.0 m/s

Technical Architecture

Bucket System

Bucket flow:

1. Player default in bucket 0

2. During transport → bucket 10000-20000 (random)

3. AI vehicles moved to same bucket

4. After completion → return to bucket 0

Monitoring System

Element	Frequency
Player state	every 1 second
Vehicle position	every 250ms
Distance to target	every 500ms
Bucket state	every 5 seconds
ETA timeout	dynamically

API and Events

Client Events

-- Start rescue process
TriggerEvent('ylean_aiparamedic:triggerCallAmbulanceProcess')

ESX Callbacks

-- Check medics online
ESX.TriggerServerCallback('ylean_aiparamedic:medicOnline', function(medicCount)
    -- medicCount: number of medics online
end)

Admin Commands

Command	Description	Access
restore_buckets	Restores all buckets	Server console

Troubleshooting

Problem: Ambulance doesn't arrive

Diagnostics:

-- Enable debug in config.lua
Ylean.Debug = true

Solutions:

• Reduce SpawnRadius (try 200-250)

• Check map collisions nearby

• Verify vehicle model exists

• Ensure ESX is working properly

Problem: Surgery doesn't start

Check:

• NUI files in nui/media/ (mp4, mp3)

• File read permissions

• Browser console errors (F12)

Problem: Buckets don't reset

-- In server console:
restore_buckets

-- Or restart resource:
restart ylean_aiparamedic

Performance Optimization

Performance Settings

-- config.lua for better performance:
Ylean.Debug = false                -- Disable debug
Ylean.Ambulance.SpawnRadius = 200  -- Smaller radius

Best Practices

Production Configuration

-- Recommended settings for production server:
Ylean.Debug = false
Ylean.MedicsOnline = 1
Ylean.CallAmbulance.Price = 1000
Ylean.CallAmbulance.Cooldown = 300
Ylean.RescueMode = "advanced"

Adding Translations

The locales/ folder contains 11 ready translations. To add your own language:

1. Copy file locales/en.lua

2. Rename e.g. to locales/custom.lua

3. Translate all keys

4. In config.lua set: Ylean.Locales = "custom"

5. In nui/script.js set: let currentLanguage = 'custom';

Technical Support

Type	Information
Discord	Click here
Version	1.0.1
Debug	Ylean.Debug = true

License

⚠️ Prohibited:

• Code distribution

• Resale

• Modification of encrypted parts

✅ Allowed:

• Configuration file modification

• Location customization

• Integration with own systems

---

This documentation covers all aspects of the AI Paramedic script. For questions, contact technical support.