Browse docs

Configuration

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

Configuration sources

Sky Ambulance Job uses two configuration layers:

LayerPurpose
/jobconfigJob definitions and frequently changed settings stored through Sky Jobs Base
Open files in sky_ambulancejob/configDefaults, fallback job data, medications, locales, and inventory assets

When Config.UseJobConfigurator is enabled (the default), saved Job Configurator values take priority over matching fallback values in config.lua. Editing a fallback value alone may therefore have no visible effect on an already configured server.

Configurator data is stored in the database through Sky Jobs Base (sky_jobs_configurator_jobs, sky_jobs_configurator_settings), not in config.lua.

Opening the Job Configurator

Run /jobconfig in-game and select Ambulance Jobs in the selector. The command is player-only and requires the sky_jobs_base.jobconfig ACE permission, granted through Config.CommandPermissions in sky_jobs_base/config/config.lua:

sky_jobs_base/config/config.lua
Config.CommandPermissions = {
    jobconfig = { "god", "superadmin", "admin" },
    -- ...
}

See the Permissions page for the group bootstrap per framework.

Creating an ambulance job

Add the job

Open /jobconfig, select Ambulance Jobs, and add a new job. Enter the job name, pick the job color, and optionally enable an off-duty job.

The job name must already exist in your framework with the intended grades — the configurator stores job data, it does not create framework jobs.

Configure shop, props, and vehicles

Fill the job shop catalog (item, label, price, minimum grade), configure job props, and add garage vehicles (model, price, trunk capacity, garage type, minimum grade, fuel type, livery, colors, and extras).

Set storage capacities

Configure the job storage sizes used by the hospital storage points.

Enable systems and settings

Switch to the feature toggles and settings sections and configure the death, treatment, and hospital behavior (see below).

Save

Save the configuration. Changes apply live — no resource restart is needed.

Grant boss permissions

After creating a new job, run /setboss <job> <topGrade> once so the highest grade receives every boss permission.

Feature toggles

The Ambulance Jobs section exposes these system toggles:

  • Bleeding
  • Pain
  • Fractures
  • Body Bags
  • Knockout
  • Death Timeout
  • Conscious Blood Pressure
  • Respawn In Bed

Disabling a feature does not remove its old database data. This allows a feature to be enabled again without losing saved records.

Settings sections

Frequently changed settings are grouped into configurator sections, including:

SectionWhat it controls
GeneralPrimary color, hospital blips, and shared UI behavior
Death / Death ScreenDeath injuries, timeouts, respawn, early respawn, and death screen style
TreatmentTreatment flows, medications, CPR, ventilation, and public treatment
DiagnoseDiagnosis, self-diagnose, and imaging (X-ray, MRI, CT) behavior
MinigamesTreatment minigame settings
Medic Carry / Mobility AidsCarry, stretcher, crutch, and wheelchair behavior
Billing / Health InsuranceBilling prices, insurance providers, premiums, and co-pay
RewardsRevive and body bag delivery rewards
Doctor NPCAI medic revive behavior and pricing
Hospital BedsBed animations, revive in bed, and bed respawn
Body Bag / Knockout / Vehicle PullThe remaining death and transport systems

Interactions (markers, blips, NPCs, and animations of the placed points) are edited in the configurator as well.

Hospitals and hospital beds

Hospitals and hospital beds are creator-backed sections inside the configurator: entries are created, placed in the world, and edited from /jobconfig. The standalone /hospitalcreator and /hospitalbeds commands are disabled while the Job Configurator is active.

See Hospital Setup for the placement workflow.

  1. Enable or disable the main systems in /jobconfig.
  2. Configure ambulance jobs, shops, vehicles, treatment settings, billing, and insurance.
  3. Save the configuration and test it without restarting the resource.
  4. Use the open configuration files only for settings that are not exposed in the configurator (for example Custom Medications).
  5. Keep a backup of customized configuration files before every resource update.

Open configuration files

FileUse
config/config.luaFeature defaults, fallback jobs, interactions, medications, death causes, and injuries
config/locales/*.luaTranslations and interface text
config/inventoryIncluded medical item images

Settings that need extra care

Job Configurator ambulance jobs

Ambulance jobs created only through /jobconfig receive the same tablet applications as jobs defined in config.lua. After adding or changing a job, save the Job Configurator entry and ensure the player has the correct job and duty state before checking the tablet.

Command permissions

Changes to Config.CommandPermissions (in sky_jobs_base or sky_ambulancejob) require a resource restart, and players may need to reconnect.

Health insurance

Insurance providers, premiums, and expiration are managed in the Health Insurance configurator section. The database table and integration exports are documented on the Health Insurance page.