Browse docs

Installation

Install Sky Ambulance Job, prepare its dependencies and database, and complete the first server setup.

Requirements

Before installing Sky Ambulance Job, update both required resources from the same CFX Portal account:

sky_base
sky_jobs_base

Keep both dependencies up to date when updating the ambulance resource. Start your framework, inventory and targeting resources before the Sky resources.

Remove conflicting resources

Before installing, stop and remove any other medical/ambulance resources from your server.cfg. These will conflict with Sky Ambulance Job and cause crashes or unexpected behavior:

qbx-medical / qbx_medical
qbx-ambulancejob / qbx_ambulancejob
esx_ambulancejob
qb-ambulancejob

QBox users: You must remove bothqbx-ambulancejobandqbx-medical. Removing only one is not enough — both resources interfere with the death, injury, and respawn systems.

The script prints a red warning in your server console if it detects any of these resources still running.

Install the resource

Deploy the files

Place the sky_ambulancejob resource in your server resources directory. Do not rename its resource folder.

Configure the start order

Add the resource to server.cfg after its dependencies. A typical order is your framework and integrations first, followed by sky_base, sky_jobs_base, and finally sky_ambulancejob.

Prepare the database

Config.AutoExecuteQuery is enabled by default in config/config.lua. With this option enabled, the resource creates and updates its database tables automatically.

Import the included import.sql manually only if you disable automatic queries.

Set up media uploads

Images & videos in the tablet are uploaded to FiveManage. The capture runs directly in the tablet UI — no extra server resource is required.

Create an account at FiveManage and generate a Media API Key from your dashboard.
Enter your Media API Key in sky_jobs_base/config/webhooks.lua:

sky_jobs_base/config/webhooks.lua

Webhooks = {
    fivemanage = {
        apiKey = "your_media_api_key_here",
        baseUrl = "https://api.fivemanage.com/api/v3/file",
        timeoutMs = 10000
    }
}

Saving images & videos will break if you restart the script while your server runs. Make sure you test after doing a full server restart.

Add medical items

Add the following items to your inventory script. Use the preview images inside sky_ambulancejob/config/inventory so they match the UI. For ready-to-copy definitions, see the Inventory Items page.

gauze
blood_infusion
crutch
wheelchair
glucose
rescue_backpack
saline_infusion
quickclot
tourniquet
ibuprofen
oxycodon
morphine
bp_medication

Install the wheelchair model

Make sure the wheelchair that medics can use in-game exists on your server:

Pick a source: Download the add-on from gta5-mods.com or grab the files from AndreIakko/wheelchair.
Add it as a resource: Place the files inside a new resource folder (for example, resources/[vehicles]/wheelchair) with the supplied fxmanifest.lua and stream contents.

Sky Jobs Base pays salaries for configured jobs. Set the framework salary values for every ambulance grade to 0 (for example in the job_grades table) — leaving both salary systems active produces duplicate payments.

If you prefer to keep your framework or an external payroll system instead, disable the built-in payroll by setting Config.Salary.enabled = false in sky_jobs_base/config/config.lua.

Configure administrator access

Install the global permissions bootstrap, assign your administrator group, and review the Permissions page.

Grant boss permissions

Run /setboss once for the highest ambulance grade after a fresh installation or after clearing sky_job_permissions.

For example, an ambulance job whose highest grade is 4 should be configured with /setboss ambulance 4.

Configure the job

Restart the server, run /jobconfig, and select Ambulance Jobs. Configure jobs and enabled systems before placing hospital points. See the Configuration page for the full workflow.

Build the hospital

Hospitals and hospital beds are placed through the Job Configurator. Follow the Hospital Setup page to place the hospital position, duty terminal, and treatment points.

First-start checklist

The server console shows no missing dependency, conflict, or database errors.
/jobconfig lists Ambulance Jobs.
The ambulance job and its highest grade exist in the framework.
Required items exist in the selected inventory.
The wheelchair model loads in-game.
The EMS tablet shows the expected applications.
A test player can die, be revived, and respawn correctly.

Most day-to-day settings are managed through /jobconfig when Config.UseJobConfigurator is enabled. Static and advanced settings remain in the open config directory.

Next steps

Support

Need help? Our support team is always ready to assist.

Join Discord

Overview

Start here for an overview of Sky Ambulance Job, its main systems, setup path, and documentation sections.

Configuration

Understand the Job Configurator, how to create an ambulance job, feature toggles, and the safe configuration workflow.