QB

AI Paramedic Documentation for QBCore/Qbox

Introduction

AI Paramedic is an advanced automatic medical rescue system for FiveM servers with QBCore/Qbox 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)

• QBCore/Qbox Framework (latest version)

• qb-core/qbx_core (exported in manifest)

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 qb-core  # or qbx_core for Qbox
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 = "hospital:client:Revive"  -- QBCore/Qbox revive event
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')

QB Callbacks

-- Check medics online
QBCore.Functions.TriggerCallback('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 QB 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.