Sal’s Kewl Korner

Home / Documentation / Sal's Kewl EMS

Sal's Kewl EMS — owner's manual

Interactive EMS for FiveM. Your players are EMRs, EMTs, AEMTs and paramedics, and what each can do follows their certification. They are dispatched to calls from Sal's Kewl Public Safety Simulator and to real players who are down, examine patients head to toe, read a cardiac monitor that works like the one on a real rig, treat within their scope with real kit, and call medical command for orders. This manual covers installation, configuration, daily use and troubleshooting.

documents resource version 0.5.1-beta↓ PDF

Beta. This is the first public build. It is complete and tested, but config keys and commands may still change before 1.0.0. The CHANGELOG inside the download calls out every breaking change.

Overview

Sal's Kewl EMS turns a medical call into something to do. Every patient has problems (a heart attack, a collapsed lung, anaphylaxis, a bleed, a stroke, an overdose, and dozens more) running on a physiology model underneath, and nothing about them is shown until a medic measures it. Two medics checking vitals a minute apart get numbers that agree with each other and with how the patient is doing.

Three ideas carry the whole resource:

  • A patient is a person with problems nobody on scene can see. Medics find out what is wrong by examining them.
  • A level is what a medic is certified to do: EMR, EMT, AEMT, paramedic, and critical care paramedic if you turn it on. Every treatment has a minimum level. Some need orders from medical command first.
  • The equipment lives on the ambulance. A medic grabs the bags, the monitor and the oxygen at the rear doors and carries them in. Forgetting the monitor is a walk back to the truck.

Everything is reachable three ways: the wheel on Caps Lock, E on a patient or at the rig, and your third-eye resource. There are no commands to remember.

What ships

  • A full body exam on an anatomical figure, plus the primary survey, AVPU and GCS, pupils, blood sugar, BE-FAST, pain, temperature, SAMPLE and OPQRST questions, and a rapid trauma assessment.
  • Scope of practice from the National EMS Scope of Practice Model, with one table for your state's differences.
  • Airway, oxygen, BVM, CPAP, nebulizers, needle decompression, chest seals, CPR, defibrillation, cardioversion, pacing, IV and IO, fluids, tourniquets, wound packing, splints, traction, pelvic binders, spinal motion restriction, burns, cooling, warming, childbirth, and a full formulary with real concentrations, doses and maximums.
  • The SK-15 cardiac monitor/defibrillator, with 4-lead and 12-lead ECG, pads, SpO2 with pleth, EtCO2 with capnography, NIBP, manual and AED modes, synchronized cardioversion, transcutaneous pacing, alarms, a CPR metronome, 12-lead interpretation and a code summary.
  • Medical command: patch to the doctor for orders from the exam screen.
  • Kit on the rig, 99 props of our own with no brand names, and worn props that line up with each patient's skeleton.
  • The cot, in powered, manual and bariatric kinds, worked the way a crew works it, through to the hospital handoff.
  • An NPC partner, a training manikin and a proctor.
  • Patients from Sal's Kewl Public Safety Simulator calls and, when an admin turns it on, from real players who go down. No medical script is required, and it works beside wasabi_ambulance, qbx_medical, qb-ambulancejob, esx_death, esx_ambulancejob, ars_ambulancejob and others.
  • Air medical, new in 0.5.0-beta: flight medics and flight nurses, helicopters as air ambulances, landing zones, and requesting a helicopter from the wheel. It has not been tested in a live game yet. See Air medical before you rely on it.

Requirements

Sal's Kewl EMS is included with a Sal's Kewl Gold subscription. It will be sold on its own soon.

  • A FiveM server artifact with OneSync.

Everything else is optional and found at runtime. Nothing below has to be installed for the resource to start.

OptionalWhat it adds
qb-core, qbx_core or es_extendedJobs and grades decide each medic's level. Without a framework, levels come from aces and the resource runs standalone.
Sal's Kewl Public Safety SimulatorDispatched EMS calls whose patients become patients here. Use 0.0.27-beta or newer (see Where patients come from).
Sal's Kewl DispatchThe AI physician on medical command, the AI ER nurse and their voices, through your community's NPC voice AI (Sal's Kewl Dispatch 3.14.5 or newer). Without it, medical command answers from the built-in protocol book and the nurse works from a checklist.
Sal's Kewl CAD (sals_kewlcadbridge)Submitted care reports become PCRs in the CAD for review. Without it, reports are filed in data/reports-YYYY-MM-DD.json.
ox_target, qb-target, qtarget or fusion-targetThird-eye options on patients, the rig and the cot. The first one running is used.
Your medical scriptwasabi_ambulance (v1 or v2), qbx_medical, qb-ambulancejob, esx_death, esx_ambulancejob, ars_ambulancejob, randol_medical, p_ambulancejob, osp_ambulance and ak47_ambulancejob are found automatically; any other can be named in settings. That script decides who is down and does every revive; EMS adds the exam, the monitor and the treatments on top. See Running beside your medical script.

Installation

  1. Put the sals_kewlems folder in your resources folder.
  2. Add it to server.cfg after your framework and after the simulator if you run it:
    ensure sals_kewlems
  3. Restart the server. The console prints [sals_kewlems] started: ... with the number of problems, treatments and medications loaded. emsadmin status shows which medical script was found.
  4. In game, as an admin, open EMS settings: hold Caps Lock and pick EMS > Settings, or type /emsadmin. The usual changes:
    • Who is what level: your EMS job names and which grade is which level.
    • The rig and the kit: your ambulance spawn names.
    • The cot: which cot your rigs carry, and whether they have a power-load system.
    • Your state's scope: your state's scope differences.
    • Hospitals: stand at each ambulance entrance and press Use my position.
    There is no config.lua to edit. See Settings and updates.
  5. As an admin, hold Caps Lock in game, pick Training > Training manikin, then press E on the manikin. You are looking at the exam screen.

Updating

Copy the new folder over the old one and restart. The data/ folder holds your server's own records and is never replaced by an update. Read the CHANGELOG first: a breaking config change is always called out there.

With Sal's Kewl Public Safety Simulator: use 0.0.27-beta or newer. Its wheel carries the EMS slices, and its "Load them up" step stands aside for the cot. An older simulator still works, but its patients are not handed to the cot at the rig, and Caps Lock opens two wheels at once, because the older one cannot carry our slices.

Keys and the wheel

KeyWhat it does
Caps Lock (hold)The wheel: everything you can do right here. Tap it to keep it open; 1 to 8 pick a slice.
E near a patientThe exam screen.
E at an ambulance's rear doorsThe equipment on the rig. The cot is a row there.
E pushing the cotPark it. At the rig's rear doors, load it, or put it away when it is empty.
E at a parked cotPush it.
R on the exam screenThe care report for this patient.
G on the exam screenThe coach on or off.

The wheel is built from where the medic is standing: the patient in front of them, the cot, the rig, their kit, their partner, training. With Sal's Kewl Public Safety Simulator running, the EMS slices go on its wheel, so one key and one ring cover everything. Without it, this resource draws the same ring itself.

Players can change the wheel key in Settings > Key Bindings > FiveM. The key is Config.Wheel.Key (CAPITAL by default). No other key is bound: a key of ours is a key some other resource on your server already uses. The emskit and emsmonitor commands exist for anybody who wants to bind one by hand.

The third eye offers the same actions on patients, the rig's rear doors and the cot. Set Config.Interaction.UseTarget = false to use E only.

Levels and scope of practice

Every medic has a level: EMR, EMT, AEMT or paramedic, with critical care paramedic as an option (Config.Levels.CriticalCare, off unless your server runs critical care transport). The first rule that answers decides a player's level:

  1. An ace. add_ace identifier.license:xxxx sals_kewlems.level.paramedic allow, or a group. Good for certifying people by hand.
  2. Their job and grade, from Config.Levels.ByJob. Grades not listed use the highest listed grade below them.
  3. The default (Config.Levels.Default, EMT) for anybody on one of the EMS jobs in Config.Levels.Jobs.
  4. Fire jobs (Config.Levels.FireJobs) get FireLevel, EMR by default. Everybody else is a member of the public: CPR, the AED, bleeding control and the recovery position.

RequireOnDuty = true means an off-duty medic is treated as public.

Your state's scope

Every treatment ships with its level from the National EMS Scope of Practice Model, and the exam shows that level beside each one. States differ, so the Your state's scope page of EMS settings changes a minimum level. Add a row, pick the treatment (the box suggests every treatment id, and every medicine as med:<id>; use med:<id>:<form> for one form of a medicine), and pick the lowest level that may do it. For example, supraglottic at EMT if your state lets EMTs place an i-gel, or med:fentanyl at AEMT.

Needs orders, on the same page, takes the same names and makes a treatment need medical command's orders even when the shipped scope says standing orders are enough.

A treatment below a medic's level is on the screen with a lock and the level it needs. A wrong but allowed treatment is not stopped: the patient answers it.

Where patients come from

Sal's Kewl Public Safety Simulator

The simulator pages EMS already. With this resource running, every patient on one of its calls becomes a patient here, and Examine sits at the top of the patient's E menu. Config.PSS.ByScenario maps a call id (or the start of one) to the problems the patient gets when the call does not say what is wrong; a list picks one at random, and severity runs from 0 to 1. The shipped table covers cardiac arrest, chest pain, overdose, diabetic, stroke, seizure, breathing, allergic, fall, lift assist, MVC, crash, pedestrian, shooting, stabbing, assault, fire, drowning, heat, cold, welfare and animal calls. ByCondition is the fallback by the call's own word for how they look.

When the cot goes into the rig, the call marks the patient transported, and the patient is removed at the hospital handoff. This needs simulator 0.0.27-beta or newer.

Real players

Off as shipped. An admin turns it on in EMS settings > Real players > EMS can treat real players. It takes effect at once, with no restart: players already down become patients, and turning it off lets them go.

With it on, a player who goes down is a patient exactly like one from a call: the exam, the SK-15, the cot, the partner, the coach, the AI doctor on medical command and the ER nurse all work on them.

  • Their injuries come from every hit they took before going down: a round to the chest and a knife to the leg are two problems. Their age and sex are their character's (qb, qbx and ESX).
  • They answer for themselves. When a medic asks a question, the downed player is shown it, with what their character would say, and answers out loud over voice. The medic's screen records the answer as it does for an NPC, so the coach, the doctor, the nurse and the care report keep working. They are also told what is being done to them and by whom, and when they are unresponsive or cannot talk (Tell the downed player what is happening).
  • They pick their own history. When they go down they get a short form, once, to pick their character's allergies, medications and conditions from a list. The medic hears it when they ask, and it counts: an aspirin allergy reacts to aspirin, Viagra rules out nitro, high blood pressure runs higher. Pick lists only: nobody can type anything into another player's screen (Players pick their own history).
  • The respawn timer waits for EMS. The first medic to touch them tells them who is working on them and asks them not to respawn. With wasabi_ambulance_v2 or qbx_medical the timer is also held while EMS works (Hold the respawn timer while EMS works); other medical scripts cannot be held from outside.
  • A hospital bill, optional: Hospital bill takes that many dollars from the player's bank or cash when EMS hands them over at the ER. 0, as shipped, is no bill. qb, qbx and ESX.

Who is down, and how they get up, belongs to your medical script when one runs (see Running beside your medical script). With none, a player at or below Config.Players.DownHealth (120 on a default ped; 200 is full) is down, and how they get back up once EMS has them stable is Config.Players.Revive:

ValueMeaning
'self'This resource revives the ped where it lies.
'event'Triggers your own revive event, ReviveEvent, on the ReviveSide you name, with the player's id.
'none'Nothing. The EMS work is recorded and your medical script decides.

The exam

Press E on a patient, or pick them on the wheel. The exam screen has the patient's name, age and weight at the top, the running task, the crew on them, and tabs for Assess, Findings, Treat, Vitals and History.

  • Quick assessments: AVPU, blood glucose, Glasgow Coma Scale, interpret the rhythm or 12-lead, lung sounds, manual vital signs, medication list, OPQRST, pain scale, primary survey (XABCDE), pulse check, pupils, rapid trauma assessment, SAMPLE history, skin signs, stroke scale (BE-FAST, LAMS), temperature.
  • Whole body: general impression, mental status, skin, chest.
  • Region by region on the anterior and posterior figure: inspect, palpate, listen and percuss. A clean check is a finding too, and every finding goes on the chart.

Vitals are measured, not handed out. A manual set takes time and a pair of hands; the SK-15 measures continuously once it is connected. Everything measured is on the Vitals tab with who took it and when, so the trend is visible.

Opening the exam at a patient sets the carried bags down beside them (Config.Equipment.SetDownAtPatient). Pressing Esc closes the screen; the patient keeps going.

Patients answer out loud

Ask a question on the History tab and the patient says the answer, in a voice that fits their age and sex, and scared when they are hurting. Everybody near the patient hears it, and the words are on screen as before. It uses the same voice AI as the doctor and the nurse, so it needs Sal's Kewl Dispatch 3.14.5 or newer with your community's voice AI on. Without them, the answer is on screen only. The ER nurse and the voices > Patients answer out loud in EMS settings turns it off.

The coach

Most players who put on the EMS job have never run a call. The coach tells them what to do next, in plain words. It is for anybody, a bystander included, and each player turns it on and off for themselves:

  • on the wheel (Coach: turn on),
  • with the Coach button on the exam screen, or
  • with G on the exam screen.

The choice is remembered on that player's own machine.

What it shows

  • The next step, and why. A card at the top of the exam names one thing to do and gives the reason: Start CPR. No pulse. The heart has stopped, and only compressions move blood to the brain. Its button does the step (Do it), opens the right card (Show me), asks the question (Ask) or opens medical command with the request filled in (Call). When the kit for the step is not at hand, the card says what is missing.
  • What a finding means. Findings and answers get a plain-language line under them: Crackles: fluid in the lungs, often from heart failure.
  • Warnings when something critical is being missed: no CPR on a patient without a pulse, CPR on a patient who has one, life-threatening bleeding that is not controlled, an airway that is not clear, a patient who is not breathing enough, low oxygen with no oxygen on, a drug given before anybody asked about allergies, and a patient who needs a paramedic or an ambulance.

What it does not do

  • It does not know the diagnosis. The coach sees what the player has found, measured and asked, and nothing else. It cannot say "heart attack" about a patient nobody has examined.
  • It never suggests what the player may not do. Every step is checked against the player's level and your scope settings. When a drug needs orders, the step is to call medical command for them. When the right care is above the player's level, it says so and moves on to what they can do.
  • It is advice. Nothing is blocked and nothing is done for the player. A wrong treatment is still theirs to give.
  • It uses no AI and no credits. It runs on the built-in protocol book, with or without Sal's Kewl Dispatch.

The care report lists who had the coach on.

Settings

SettingWhat it does
Training > Who gets the coachEach player turns it on and off (the default), or it is on for everyone and the button is gone.
Training > Coach on until turned offWhen each player chooses: new players start with the coach on.
Parts on or off > The coachRemoves the coach from the server.

The SK-15 monitor

The SK-15 is a cardiac monitor/defibrillator with real keys and the real workflow. It comes off the rig like any other kit (monitor in Config.Equipment.Items, EMT and up), and one SK-15 is shared by everybody working the same patient. It runs full screen or docked in the corner while you work; both are on the wheel.

Connections

From the exam, attach the 4-lead ECG, the 12-lead ECG, the defibrillation pads, the SpO2 probe, EtCO2 and the blood pressure cuff. Each takes a few seconds and puts the prop on the patient. The monitor shows what is connected and says CONNECT NIBP CUFF and the like when you press a key for something that is not.

What it does

  • Rhythm with heart rate, SpO2 with pleth, EtCO2 with capnography and respiratory rate, NIBP on a cuff cycle (Config.Monitor.NibpSeconds) with the last reading and its time kept on screen. A cycle on a patient with no pressure reports NIBP CANNOT MEASURE.
  • 12-lead acquisition, a printed view with the interpretation (for example ACUTE MI SUSPECTED), and Transmit to the hospital. The screen returns to the live view 20 seconds after the printout, and at once on a lethal rhythm or a shock.
  • Manual defibrillation: energy select (Config.Monitor.Energies, 200 J by default), charge, and shock. A charge takes about 7 seconds to 360 J and is dumped after ChargeHold seconds unused.
  • AED mode: analyze, a shock advisory, and the same charge and shock keys.
  • Synchronized cardioversion and transcutaneous pacing with rate, current and capture.
  • Alarms with silence, a CPR metronome, an event log and a code summary.

Anybody on the same patient within Config.Monitor.ShareDistance meters sees the monitor's screen in the corner.

The SK-15 is modeled on the real class of device and uses no manufacturer's name or mark. The waveforms, numbers and alarms come from the patient's physiology, so what the screen shows is what the patient is doing.

Treatments and medical command

The Treat tab lists every treatment by category, with the level it needs and whether it needs orders. A treatment takes seconds, needs its kit in the medic's hands or set down next to the patient, and is acted out with the right prop (a syringe, a vial, a mask, a collar). The patient's physiology answers it, right or wrong.

  • Airway: OPA, NPA, supraglottic airway, intubation, surgical cricothyrotomy, suction, BVM with handoffs between crew.
  • Breathing: oxygen by cannula and non-rebreather, CPAP, nebulizers, needle decompression, chest seals.
  • Circulation: CPR with handoffs and a mechanical CPR device, defibrillation, cardioversion, pacing, IV and IO access, fluids, tourniquets, wound packing with hemostatic gauze, pressure dressings, pelvic binders.
  • Trauma and environment: splints, traction splints, spinal motion restriction, burn dressings, cooling, warming, eye irrigation, childbirth with the OB kit.
  • The formulary: real concentrations, doses and maximums for every medicine, by route and form. A missed IV says why ("Missed: the vein blew") and is charted.

Medical command

Med command on the exam screen patches to the doctor at the base station (Config.MedCommand.Station, "Pillbox medical control" by default). Ask for orders and get them, or get told why not. An order unlocks the treatments that need it, at the dose given, for OrderMinutes (30 by default).

With Sal's Kewl Dispatch running, your community's NPC voice AI on and Hosted = true, the doctor is an AI emergency physician. The physician answers the question you actually asked, asks for what you left out ("what's the systolic before I give you nitro?"), reads back every order with the dose and route, and speaks over your radio in a brisk, clear voice. Their words are always on screen too.

The doctor only orders what your protocols allow. The built-in protocol book decides first, and the physician may grant only the orders it allows, at its doses, or decline them. When the book says no, the answer is no. Without Dispatch, or when the doctor has not answered within TimeoutMs (15 seconds by default), the protocol book answers on its own. It always answers. No API key is in this resource and none is needed.

Equipment on the rig

Config.Rigs names the vehicle models that are ambulances. Add every add-on ambulance your EMS drives: a vehicle not on the list has no prompt at its back doors. E at the rear doors (within Config.Equipment.RigReach meters of the rear bumper, measured from each model's own length) opens the rig menu, with every item and Take beside it. A medic may take what their level allows and carry up to MaxCarry items at once.

ItemLowest level
Jump bagEMR
Airway bagEMT
Oxygen (D cylinder)EMR
SK-15 monitorEMT
Drug boxAEMT
Portable suctionEMR
CPAPEMT
Mechanical CPREMT
OB kitEMR
BackboardEMR
Scoop stretcherEMT
KEDEMT
Traction splintEMT
Stair chairEMR
CotEMR (its own row: pushed, not carried)

A set-down item counts for any treatment within Reach meters of the patient, and a crew shares what is set down. Bags hang from their handles, so each has a lift that puts it on the ground; change one only if a bag floats or sinks on your map.

Config.Features.Equipment = false removes the whole kit system: everything is at hand, everywhere.

The cot

Every rig carries one cot. Get it out at the rear doors, push it to the patient, lower it, move them on with Load on the cot from the exam (the cot lowers to meet them and they are buckled in; somebody not breathing goes on flat), raise it, push it back and load it. The patient rides in the back, and the crew keeps working them on the way. At a hospital in Config.Hospitals, within HandoffRadius meters, unload and hand off to the ER.

KindBehavior
'power'A powered cot: raises and lowers itself on a button and locks into a power-load system, so one medic can do it all.
'manual'A manual cot: with a patient on it, it takes two to raise, lower or lift into the rig. Another medic, or your NPC partner.
'bari'A bariatric powered cot: wider, rated for heavier patients, powered like 'power' and slower.

Config.Cot.Default picks the cot for every rig and ByRig changes it per vehicle model. PowerLoad = false means your rigs have no power-load system, so every cot is lifted in by two, the powered ones too. Seconds sets how long each job takes per kind.

A player handed off at the ER gets back up through your medical script (its own revive when one runs, Config.Players.Revive otherwise) when HandoffRevive is on, and is billed if Hospital bill is set.

If the cot sits wrong

Each state of each cot is its own model. If the cot floats or sinks in your ambulance, tune Config.Cot.RigSpot for that vehicle model (meters right, forward and up from the vehicle's center). If a patient floats or sinks on the cot, tune Config.Cot.Pose.

Using another script's stretcher (in testing)

If an ambulance came with a stretcher script of its own, both can stay installed, and its stretcher can stand in for our cot. In EMS settings > The cot > Other stretchers, add a row with the model name that script spawns for its stretcher (a prop or a small vehicle). Then:

  • That stretcher beside a patient counts as a cot for the treatments that need one.
  • Load on the cot lays the patient on it. They go wherever that script takes the stretcher, including into its ambulance.
  • At the hospital, Hand off to the ER works from it, on the wheel and the third eye, the same as from our own cot.

Pushing, raising, lowering and loading that stretcher stay with the script that owns it; ours offers none of them on it. The row's Right, Forward and Up say where the middle of the mattress is, in meters from the model's center: start with Up at 0.9 and adjust until the patient lies on the mattress. Turn is for a patient lying the wrong way around.

If that script deletes its stretcher when it goes into the ambulance, the patient moves to another listed stretcher that appeared in its place, or onto our cot inside the ambulance beside it (if the ambulance is on Ambulance models), or to the ground. A script that changes models as the stretcher is raised and lowered needs a row for each model.

This is in testing: it has been checked against our own test world, not yet against a particular stretcher script. Tell us which one you run and what happens. Our own cot remains the one every feature is built on.

Finishing with the patient

A call ends one of four ways. The run log records which, with who did it and when.

Transport and hand off at the ER

This is the normal ending, and the one the whole cot workflow leads to. In order:

  1. Get the cot out at the rig's rear doors (E there, or the wheel). You are pushing it.
  2. Push it to the patient and park it beside them.
  3. Load on the cot from the exam's Movement drawer. The cot lowers to meet the patient, they are moved over and buckled in. Somebody who is not breathing goes on flat; CPR needs the backrest flat.
  4. Raise the cot, push it back to the rig and Load into the rig at the rear doors. A manual cot with a patient on it takes two here: another medic or your partner within Config.Cot.HelperReach meters. You see Loaded. Your patient is in the back.
  5. Ride in back if you want to keep working them on the way. The patient is still a patient; the exam and the monitor still work.
  6. At a hospital in Config.Hospitals, within HandoffRadius meters (60 by default), Unload the cot at the rear doors, then Hand off to the ER. The charge nurse comes to the cot to take your report (below).

Giving report to the ER nurse

Give report the way you would at a real emergency department: age and sex, what you were called for and what happened, mental status, vitals, what you found, what you did and how they responded, allergies and home medications, and for the patients it applies to, the 12-lead, the mechanism, or the down time and ROSC. Talk (hold V or the mic button; it needs your community's voice AI) or type it.

When you stop, the nurse asks for whatever you did not give, one question at a time. When she has everything, she takes the patient and the handoff completes: Report given. Pillbox Hill Medical Center has your patient. The care report records who took report and what she had to ask for. Not now backs out without handing off.

With Dispatch and the voice AI, the nurse understands the report however you say it and asks in her own words, out loud. Without them, she works from a checklist of the same items, on screen. Turn her off (Parts on or off > The ER nurse) for the old timed handoff, which takes Seconds.Handoff seconds.

The handoff is where the call is done. The log reads care transferred to <hospital> emergency department, report given, and then:

  • A patient from the Public Safety Simulator was marked transported when the cot went into the rig, and is removed from the world at the handoff. The simulator closes its call.
  • A player gets back up through your medical script (its own revive when one runs, Config.Players.Revive otherwise) when Config.Cot.HandoffRevive is on.

"Hand off to the ER" is only offered with the cot unloaded and a hospital in range. There is no hospital here means you are too far from any entry in Config.Hospitals; add your own hospitals there, with coordinates, if your map has others. Then put the cot away at the rear doors.

Treated and released on scene

A player patient does not have to be transported. Once EMS has them stable enough to get up, they get up the way Config.Players.Revive says, and the log reads that the patient is up. A player who gets up some other way (your hospital respawn, an admin revive) simply stops being a patient. With a medical script running, that script does every revive and decides when they are up.

A simulator patient who is treated but not transported stays with the simulator's call: every change in their condition is reported to it, and the call closes the simulator's own way. If you run an older simulator or turn the cot off, the simulator's own "Load them up" does the transport instead.

The patient does not survive

Two treatments on the Treat tab, under Cardiac, end a resuscitation:

TreatmentLevelWhat it is
Determine obvious deathEMTInjuries incompatible with life, rigor or lividity. Thirty seconds, no orders needed. Logged as obvious death determined.
Termination of resuscitationParamedic, needs ordersPatch to medical command and ask. Logged as resuscitation terminated on order of medical command.

After either, the patient is deceased: no further treatment is accepted except removing a device. A simulator patient's condition is reported to the simulator, which closes the call its own way. A player patient is in your medical script's hands from here, exactly as before this resource was installed.

The training manikin

Training > Put the manikin away on the wheel removes the manikin you spawned. A manikin is never transported or handed off.

Housekeeping. Put the cot away at the rear doors (The cot is back in the rig) and put your kit back on the rig before the next call. A rig that is deleted with a cot out takes the cot and its patient record with it.

The care report

Every patient a medic works gets a draft patient care report. It stays after the handoff, so the crew can finish it at the hospital or back at station. Open it from the exam (Care report, or R) or from the wheel (EMS > Care reports, which lists your drafts and today's reports). Anybody who worked the patient can edit it, and so can an admin.

What fills itself in, and what does not

PartWhere it comes from
TimesPatient contact, loaded, at hospital and transfer of care, read off the call.
CrewEverybody who did something to the patient, the NPC partner included.
Vital signsDownload from the SK-15 when the monitor was on the patient: its trend (heart rate, SpO2, EtCO2, rhythm and blood pressure, every Config.Monitor.TrendSeconds seconds), its event log (shocks, analyses, pacing) and every 12-lead. Otherwise, Add a set by hand for each set you took.
TreatmentsAdd what you did copies every treatment and medication from the call, with the time and who; edit or delete any of them.
AssessmentAdd your exam findings copies what your exam found.
Chief complaint, impression, acuity, narrative, dispositionYours to write. Nothing about the patient that you did not find goes into a report on its own.

A report submits only when it has a chief complaint, an impression, an acuity, a disposition (with a destination and transport mode when transported), a narrative of at least Config.Reports.MinNarrative characters and at least one set of vitals. The bottom bar says what is still missing. A submitted report cannot be changed.

Where submitted reports go

  • Every report is filed in data/reports-YYYY-MM-DD.json, one file a day, for the server owner.
  • With Sal's Kewl CAD's game bridge running, it becomes a PCR in the CAD for review, and the medic is told its PCR number when the CAD files it; they open it in the CAD to review it. A medic with no CAD account linked is told why instead.
  • On a simulator call, a one-line summary goes on the call.

The partner

An ambulance runs with two. A medic without a second player can call an NPC partner from the wheel or the Partner button on the exam. The partner follows them, rides in the rig, and works the patient when asked: compressions and the handoff, bagging, a set of vitals, a bag from the rig, and the second pair of hands on a manual cot.

The partner works at Config.Partner.Level (EMT by default) and never above it. The one exception is fetching kit: carrying a bag is not treating, so the partner brings the medic who sent them anything that medic may take from the rig (an EMT partner fetches a paramedic's drug box). Their work goes on the run log under their name, drawn from Names. Dismiss on the wheel, or /emspartner dismiss, sends them back to station.

Training: the manikin and the proctor

The training manikin

Training > Training manikin on the wheel spawns a patient in front of you to practice on. Admins always may; give others the sals_kewlems.manikin ace. The /emsmanikin command does the same.

The proctor

For training officers. Training > Change the patient on the wheel, or /emsproctor <problem> [severity], adds a problem to the nearest patient within Config.Proctor.Reach meters, mid-scenario: "he just went into VF". Problem ids are the ones in shared/conditions.lua. Admins always may; give others the sals_kewlems.proctor ace.

Air medical

Not yet tested in a live game. Air medical is new in 0.5.0-beta. It passes our automated checks, but nobody has flown a call with it on a running server yet. Expect things to be wrong: door and cot positions on the helicopter, prompts that do not appear, a handoff that does not complete. Try it on a test server first, and tell us what you find. If it gets in the way, turn it off in EMS settings > Parts on or off > Air medical; nothing else in EMS depends on it.

A ground medic at a patient asks for a helicopter. Every flight crew member on duty is paged with the landing zone; one responds and gets a waypoint to it. On scene the ground medic hands the patient to the flight crew, who load them through the aircraft's door and fly them to a hospital's helipad, where the ER takes them the same way as at the ambulance entrance.

Flight crew

Flight crew are the jobs in EMS settings > Air medical > Flight crew jobs (airmed, flight, flightmedic and flightnurse as shipped), or anyone with the ace sals_kewlems.flight. They work at critical care (blood, the transport ventilator, the RSI drugs) whether or not your ground crews do. Flight nurse jobs names the ones the run log calls flight nurse; the rest are flight medics.

Air ambulances

EMS settings > Air medical > Air ambulances lists the helicopters that are rigs: the spawn name, where the doors are (both sides, one side, or rear clamshell doors), and where the cot rides inside. The kit and the cot come out at the aircraft's door, as they do at an ambulance's back doors. The stock Maverick ships on the list, so air medical needs no add-on aircraft.

Untested numbers. The Maverick's door and cot positions are estimates that have not been checked in game. If the prompt does not appear at the door, or the cot sits in the wrong place, adjust that aircraft's row, and expect to do the same for any helicopter you add.

Landing zones

  • Saved landing zones are placed ahead of time. An admin (or the ace sals_kewlems.lz, or a job named in Who may save landing zones) stands on the spot and picks Caps Lock > EMS > Air medical > Landing zones > Save a landing zone here, and names it. Stand in one and pick Remove to take it away. They are kept in data/landing_zones.json, which an update never touches.
  • Field landing zones are set up on the spot by any medic, firefighter or flight crew member, and by the jobs in Who else may set up a field landing zone (police and sheriff as shipped): Set up a landing zone here. Cones go out, it shows on the flight crew's map, and it clears itself after an hour. You get a warning if something is overhead.
  • A request takes the nearest field landing zone, then the nearest saved one. A field landing zone set up after the request is attached to it.

The call

  1. At the patient, the ground medic picks Request air medical (wheel or third eye). With no flight crew on duty, they are told to transport by ground.
  2. The flight crew gets the page and the landing zone. One picks Respond and gets a waypoint.
  3. When the flight crew reaches the patient, the ground medic picks Hand off to the flight crew. The run log says who took the patient.
  4. The flight crew loads the patient through the aircraft's door and hands them to the ER on a helipad.

Helipads and rotor safety

EMS settings > Air medical > Helipads lists where a flown patient is handed to the ER. Pillbox Hill's roof pad ships on the list; stand on a pad and press Use my position to add yours. A patient cannot be loaded or unloaded with the rotors turning unless Hot loads is on, and anyone on foot walking toward a running aircraft's tail rotor is warned.

Once more, because it matters: none of this section has been run on a live server. Treat air medical as a preview until a later release says it has been tested.

Running beside your medical script

Your medical script (EMS settings > On, off and your medical script; Config.Medical.System) is Automatic by default, which finds the first of these that is running. Whichever it finds:

  • decides who is down, by its own export, state bag or the framework metadata it writes, never by health;
  • does every revive. This resource never resurrects a player beside it;
  • owns your keys while you are down on its death screen.
ScriptDown byRevived by
wasabi_ambulance_v2wasabi:deathState state bag, isPlayerDeadRevivePlayer export. Its death-screen timer is held while EMS works.
wasabi_ambulanceisPlayerDead export, dead state bagRevivePlayer export and the wasabi_ambulance:revivePlayer event
ars_ambulancejobdead state bag, isDead exportars_ambulancejob:healPlayer
randol_medicaldead and laststand state bagsrandol_medical:client:revivePlayer
p_ambulancejobisDead / dead state bagsp_ambulancejob/client/death/revive
osp_ambulanceBodyDamage state bag, isDead exportits qb / ESX revive events
ak47_ambulancejobIsPlayerDown exportits client revive event
qbx_medicalqbx_medical:deathState state bagRevive export. Respawn is locked while EMS works.
esx_death (ESX 1.16+)IsDead export, isDead state bagRevive export
qb-ambulancejobisdead / inlaststand metadatahospital:client:Revive
esx_ambulancejob (before esx_death)isDead state bagesx_ambulancejob:revive

qbx_medical, qb-ambulancejob, esx_death, esx_ambulancejob and ars_ambulancejob were checked against their source code; wasabi, randol_medical, p_ambulancejob, osp_ambulance and ak47_ambulancejob against their makers' documentation. None of them is used through its own job-checked revive event, which would refuse (or, in qb-ambulancejob's case, ban) a call from another resource.

A medical script that is not on the list

Pick Another script and fill in what it has, under Show advanced: a state bag that is true while down, qb metadata keys, or a "is down?" export, and a revive event or export. One way to tell "down" and one way to revive is enough. To find the names, have a player go down and type emsadmin probe <their id> in your F8 console as an admin (or the server console): it prints the medical script found, its answer, the player's health, every state bag on the player and the usual metadata flags. Run it again once they are up; what changed is the signal.

'none' is standalone: health decides who is down and Config.Players.Revive decides how they get up. The wasabi names in Config.Medical.Wasabi are only for a renamed folder or a wasabi update that renames them.

Turning it off, or parts of it

Sal's Kewl EMS is on, the first setting in EMS settings, turns the whole interface off: no E prompt, no third-eye options, no screens, no props, no patients. Your medical script runs exactly as before. emsadmin off and emsadmin on, in game or in the server console, and the admin wheel do the same without a restart, and the choice is saved.

The Parts on or off page turns single parts on or off (Config.Features):

FeatureWhat it controls
ExamThe exam screen (assess, treat, history).
MonitorThe SK-15 monitor/defibrillator.
EquipmentKit lives on the rig and must be carried in. Off: everything is at hand.
PartnerThe NPC partner.
MedCommandPatching to medical command for orders.
PlayerPatientsEMS can treat real players who go down. Off as shipped; on the Real players page.
PssPatientsPatients from Public Safety Simulator calls.
EKeyThe E prompt on patients and at the rig's rear doors.
ThirdEyeThird-eye options.
ThirdEyeOnPlayersOur third-eye options on downed players. 'auto': off beside wasabi, which puts its own there.
WornPropsCollars, masks, pads, leads and the rest on the patient.
CarriedPropsBags in the medic's hands.
ActingPropsSyringes, vials and bottles in the hands while working.
ActingTreatments acted out step by step. Off: one plain pose.
KneelThe medic stays on a knee at the patient between tasks.
CotThe cot.
WheelThe EMS slices on the wheel.
ManikinThe training manikin.
ProctorThe proctor.
ReportsThe patient care report.
NurseThe ER nurse who takes the verbal report at the handoff.
CoachThe coach.

Each is true, false, or 'auto', meaning on unless your medical script already does it. emsadmin status prints what is on and which medical script was found.

Commands and permissions

Nothing needs a command: all of it is on the wheel. These exist for the console, for admins and for anybody who prefers typing.

CommandWhoWhat it does
/emsadminAdminsEMS settings (also on the admin wheel: Caps Lock > EMS > Settings).
emsadmin on / off / statusAdmins, server consoleThe whole script on or off, live and saved. status prints the master switch, the medical script found and every feature.
emsadmin diag / emsadmin diag <id>Admins, server consoleThe diagnostics report (also on the admin wheel: Caps Lock > EMS > Diagnostics). From the console, diag prints the server's half and diag <id> asks that player's game for the rest. See Diagnostics.
emsadmin probe <id>Admins, server consoleWhat the medical script has set on that player: its answer, health, state bags and metadata. For naming Another script.
/emsmanikinAdmins, sals_kewlems.manikinSpawn a training manikin.
/emsproctor <problem> [severity]Admins, sals_kewlems.proctorAdd a problem to the nearest patient.
/emspartner / /emspartner dismissMedicsCall or dismiss the NPC partner.
/emskitMedicsYour kit panel, for anybody who binds it by hand.
/emsmonitorMedicsThe SK-15 full screen or docked, for anybody who binds it by hand.

Aces

AceGrants
command or sals_kewlems.adminAdmin: EMS settings, the on/off switch, the manikin and the proctor.
sals_kewlems.level.emr / .emt / .aemt / .paramedic / .ccpThat level, ahead of job and grade.
sals_kewlems.manikinThe training manikin.
sals_kewlems.proctorThe proctor.
sals_kewlems.flightFlight crew, at the flight crew level (air medical, not yet tested in a live game).
sals_kewlems.lzSaving and removing landing zones.
add_ace group.ems_training sals_kewlems.proctor allow
add_ace identifier.license:0123456789abcdef sals_kewlems.level.paramedic allow

Settings and updates

Every setting is changed in game, in EMS settings. As an admin, hold Caps Lock and pick EMS > Settings, or type /emsadmin. The panel has a page per topic, a search box (it finds a setting by its words or by the Config. name this manual uses), plain-language help beside every setting, and Reset to default on anything you changed. Show advanced reveals the settings whose wrong value is hard to notice, such as animation names and where props sit.

Nothing is saved until you press Save, and a save is all or nothing: if one value is out of range, the panel marks it in red, says why, and saves none of them. Most changes take effect the moment you save. The few that are read once at start (command names, the wheel's default key, which third-eye resource to use) are marked Needs a restart.

Your settings survive every update

  • Your settings are saved in data/settings.json, and only the ones you changed. The download never contains that file, so an update cannot overwrite it, and a better default in a later release still reaches every setting you never touched.
  • To update, copy the new sals_kewlems folder over the old one and restart. data/ stays.
  • The server keeps its own copy. If the folder is deleted and replaced anyway, the next start puts data/settings.json back and says so in the console.
  • A data/settings.json that is not valid JSON is copied to data/settings.broken.json and never written over at start; the defaults are used until you save from the panel.
  • defaults.lua holds the shipped defaults. Read it if you like, but do not edit it: every update replaces it.

Coming from 0.1.x: your config.lua

Leave your config.lua in the folder when you copy the new version over. On the next start, everything you changed in it is imported into data/settings.json. Values that were only the shipped default of an older release are recognized and skipped. The original is kept as config.lua.imported, config.lua becomes a short note, and the panel says how many settings were imported. A config.lua you paste in later is imported the same way.

What's new

The first time an admin opens EMS settings after an update, the panel opens on What's new: the release notes of every version since that admin last looked. A setting that a release adds carries a New badge, and one whose default a release changes carries Default changed, until that admin has seen the release. An admin who joins after an update is told once. The console says updated from x to y on the first start of a new version.

The pages

PageWhat is on it
On, off and your medical scriptThe whole script on or off; your medical script (automatic, one by name, another script with its names, or none); the language; console detail.
Parts on or offEach part on or off (table above).
Who is what levelLevel by job and grade, the EMS jobs, the default, fire jobs, on-duty, critical care.
Your state's scopeScope differences and what needs orders.
E, third eye and the wheelThe E key and its distance, the third eye and which resources count, the wheel and its default key.
The rig and the kitYour ambulance models; reach, how many items in hand, set-down behavior; every item with its level and prop; the rig menu order.
The cotWhich cot per rig, power load, reach, seconds per job, the handoff radius and revive, where the cot rides in each rig, how it is pushed and how a patient lies on it.
The SK-15 monitorEnergies, default energy, charge time and hold, the cuff cycle, pacer range and current, the share distance.
Medical commandOn or off, hosted or protocol book, the dispatch resource, timeout, order life, the base station's name.
Care reportsThe patient care report medics write, and where it goes when they submit it.
The ER nurse and the voicesThe nurse at the handoff, how the nurse and the doctor sound, and whether patients answer out loud.
Air medicalFlight crew jobs and level, air ambulances, hot loads, who may save or set up landing zones, helipads. Not yet tested in a live game; see Air medical.
HospitalsDestinations with coordinates (Use my position fills them in) and what each can take: trauma, cath lab, stroke, burns, obstetrics.
Public Safety Simulator callsOn or off, the poll, problems by call and by how the patient looks.
Real players who go downEMS can treat real players (off as shipped); telling the downed player what is happening; their own history; holding the respawn timer; the hospital bill; the down threshold and how they get back up with no medical script.
The NPC partnerOn or off, level, names, model, how far it looks for the rig.
TrainingWho gets the coach; who may use the manikin and the proctor, and their reach.
Worn propsWhere worn props sit on a patient. Tune a position only if a prop floats or sinks on your peds.

For developers: exports and events

Server exports, each exports.sals_kewlems:Name(...):

ExportReturns
GetPatient(idOrNetIdOrSrc)A patient's public view, only what medics found, or nil.
GetPatients()Every patient's public view.
IsPatientPed(netId), IsPlayerPatient(src)true or false.
GetPatientChart(idOrNetIdOrSrc)What the patient would say: { canTalk, conditions, answers = { { q, a } }, text }, or nil. The condition names are for an AI to stay consistent with, not for the patient to say. Sal's Kewl Public Safety Simulator uses it so an NPC patient answers questions the way the exam does. New in 0.5.1-beta.
GetLevel(src)'public', 'emr', 'emt', 'aemt', 'paramedic' or 'ccp'.
IsMedic(src)true or false.
CreatePatient({ netId, problems = { id = severity }, demo, history })The new patient's id.
AddProblem(patientId, problemId, severity)true or false.
RemovePatient(patientId)true or false.
GetReport(id), GetReportsFor(src)A care report, or that medic's reports.
OpenReport(src, reportIdOrNil)Opens the care report screen for that player.
Enabled()The master switch.

Server events, for AddEventHandler: sals_kewlems:patientCreated (view), sals_kewlems:patientRemoved (patientId, why), sals_kewlems:treatment (patientId, src, treatmentId, text), sals_kewlems:handoff (patientId, src, hospital, handoff) and sals_kewlems:reportSubmitted (report, src).

Troubleshooting

Diagnostics: start here

When something does not work and nothing is in F8, as an admin open the wheel and pick EMS > Diagnostics (or type emsadmin diag), standing where the trouble is. The report opens with what looks wrong: a vehicle nearby that is not on the ambulance list, a job that is not an EMS job, a part switched off, props that did not load. Below that it lists what is on, your job and level, every vehicle within 25 m and whether it is an ambulance here, and the cots and kit that are out.

It is printed to your F8 console and the server console and saved to data/diagnostics.txt in the resource folder. Send us that file with a support request. It holds no identifiers, keys or addresses.

Nothing happens on E or Caps Lock

  • Run emsadmin status. If the first word is OFF, somebody switched it off: emsadmin on.
  • The player is not a medic. Check their job against Config.Levels.Jobs and ByJob, and that they are on duty if RequireOnDuty is on. A member of the public still gets CPR, the AED and bleeding control, nothing more.
  • Another resource holds Caps Lock. Players can rebind the wheel in Settings > Key Bindings > FiveM.

Air medical does not work as described

Air medical shipped in 0.5.0-beta without a test on a live server, so this is the part most likely to be wrong. Run Diagnostics standing at the aircraft and send us data/diagnostics.txt with what you did and what happened. To take it out of play meanwhile, turn off EMS settings > Parts on or off > Air medical.

Two wheels open at once

Your Public Safety Simulator is older than 0.0.27-beta and cannot carry our slices. Update it, or set Config.Features.Wheel = false here and use E and the third eye.

Nothing happens at my ambulance

An add-on ambulance has to be on EMS settings > The rig and the kit > Ambulance models, by the name you spawn it with. Until it is, it has no equipment and no cot at its back doors, the wheel offers nothing there, the partner has nowhere to fetch kit from, and nothing is printed in F8, because nothing has failed.

  • The quick way. As an admin, stand at the back doors of the ambulance, open the wheel (Caps Lock) and pick Add as an ambulance. It is saved to your settings and works at once, with no restart.
  • You are told. A medic who gets out of an emergency vehicle that is not on the list and walks to its back doors is told why nothing is offered, once per vehicle model. The wheel shows Not an EMS ambulance there for everybody else.
  • Another script's stretcher is not our cot until you list it. See Using another script's stretcher.
  • If the ambulance is on the list, stand within Config.Equipment.RigReach meters of the rear doors.

The partner will not fetch the drug box

Fixed in 0.4.1-beta: the partner now fetches anything the medic who sent them may take. On 0.4.0-beta, raise Config.Partner.Level to AEMT or paramedic.

A treatment is locked

The lock shows the level it needs. Raise the player's level in ByJob or with an ace, or lower the treatment's level in Config.Scope if your state allows it. If it says orders are needed, patch to medical command first.

A treatment says the kit is missing

The bag it lives in is on the rig. Take it from the rear doors and carry it to the patient, or send the partner for it. Set-down kit counts within Config.Equipment.Reach meters. Or turn the kit system off with Config.Features.Equipment = false.

A downed player never becomes a patient

EMS settings > Real players > EMS can treat real players is off as shipped; turn it on. If it is on, run emsadmin status: it names the medical script found. If yours is not on the list, pick Another script and use emsadmin probe <id> on a downed player to find its names.

Downed players show two sets of options

With wasabi_ambulance running, set Config.Features.ThirdEyeOnPlayers = 'auto' (the default) so wasabi's own options are the only ones on a downed player.

The cot or a prop floats or sinks

The cot in the rig: Config.Cot.RigSpot for that vehicle model. A patient on the cot: Config.Cot.Pose. A bag on the ground: its lift in Config.Equipment.Items. A worn prop on a patient: its pos in Config.PropAttach.

Medical command never answers from the AI doctor

The AI doctor needs Sal's Kewl Dispatch 3.14.5 or newer running on the same server, your community's NPC voice AI turned on, and Config.MedCommand.Hosted = true. Without them, the protocol book answers, which is correct behavior, not a fault. The same goes for the ER nurse: without them she works from her checklist, on screen.

The doctor and the nurse are silent

Their voices need your community's NPC voice AI and Voices on (EMS settings > The ER nurse and the voices). Their words are on screen either way.

Checking what was found

The console prints [sals_kewlems] started: ... with the number of problems, treatments and medications loaded. emsadmin status, in game or in the console, prints the master switch, the medical script found (or standalone) and every feature. If a resource you expected is missing, it was not running when this resource started: order server.cfg so it comes after your framework, your medical script and the simulator.

Support

Questions, bugs, and requests land on Discord. Documentation fixes ship fast. If something on this page is missing, wrong or unclear, say so.

The resource is licensed for use on the servers you own or administer. The full license is in the download.

Didn’t find it? Ask Squawky, or open a ticket on Discord and tell us what you already tried.