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.
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.
| Optional | What it adds |
|---|---|
| qb-core, qbx_core or es_extended | Jobs and grades decide each medic's level. Without a framework, levels come from aces and the resource runs standalone. |
| Sal's Kewl Public Safety Simulator | Dispatched EMS calls whose patients become patients here. Use 0.0.27-beta or newer (see Where patients come from). |
| Sal's Kewl Dispatch | The 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-target | Third-eye options on patients, the rig and the cot. The first one running is used. |
| Your medical script | wasabi_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
- Put the
sals_kewlemsfolder in yourresourcesfolder. - Add it to
server.cfgafter your framework and after the simulator if you run it:ensure sals_kewlems - Restart the server. The console prints
[sals_kewlems] started: ...with the number of problems, treatments and medications loaded.emsadmin statusshows which medical script was found. - 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.
config.luato edit. See Settings and updates. - 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
| Key | What 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 patient | The exam screen. |
| E at an ambulance's rear doors | The equipment on the rig. The cot is a row there. |
| E pushing the cot | Park it. At the rig's rear doors, load it, or put it away when it is empty. |
| E at a parked cot | Push it. |
| R on the exam screen | The care report for this patient. |
| G on the exam screen | The 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:
- An ace.
add_ace identifier.license:xxxx sals_kewlems.level.paramedic allow, or a group. Good for certifying people by hand. - Their job and grade, from
Config.Levels.ByJob. Grades not listed use the highest listed grade below them. - The default (
Config.Levels.Default, EMT) for anybody on one of the EMS jobs inConfig.Levels.Jobs. - Fire jobs (
Config.Levels.FireJobs) getFireLevel, 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:
| Value | Meaning |
|---|---|
'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
| Setting | What it does |
|---|---|
| Training > Who gets the coach | Each player turns it on and off (the default), or it is on for everyone and the button is gone. |
| Training > Coach on until turned off | When each player chooses: new players start with the coach on. |
| Parts on or off > The coach | Removes 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 afterChargeHoldseconds 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.
| Item | Lowest level |
|---|---|
| Jump bag | EMR |
| Airway bag | EMT |
| Oxygen (D cylinder) | EMR |
| SK-15 monitor | EMT |
| Drug box | AEMT |
| Portable suction | EMR |
| CPAP | EMT |
| Mechanical CPR | EMT |
| OB kit | EMR |
| Backboard | EMR |
| Scoop stretcher | EMT |
| KED | EMT |
| Traction splint | EMT |
| Stair chair | EMR |
| Cot | EMR (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.
| Kind | Behavior |
|---|---|
'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:
- Get the cot out at the rig's rear doors (E there, or the wheel). You are pushing it.
- Push it to the patient and park it beside them.
- 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.
- 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.HelperReachmeters. You see Loaded. Your patient is in the back. - 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.
- At a hospital in
Config.Hospitals, withinHandoffRadiusmeters (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.Reviveotherwise) whenConfig.Cot.HandoffReviveis 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:
| Treatment | Level | What it is |
|---|---|---|
| Determine obvious death | EMT | Injuries incompatible with life, rigor or lividity. Thirty seconds, no orders needed. Logged as obvious death determined. |
| Termination of resuscitation | Paramedic, needs orders | Patch 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
| Part | Where it comes from |
|---|---|
| Times | Patient contact, loaded, at hospital and transfer of care, read off the call. |
| Crew | Everybody who did something to the patient, the NPC partner included. |
| Vital signs | Download 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. |
| Treatments | Add what you did copies every treatment and medication from the call, with the time and who; edit or delete any of them. |
| Assessment | Add your exam findings copies what your exam found. |
| Chief complaint, impression, acuity, narrative, disposition | Yours 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 indata/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
- 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.
- The flight crew gets the page and the landing zone. One picks Respond and gets a waypoint.
- 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.
- 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.
| Script | Down by | Revived by |
|---|---|---|
| wasabi_ambulance_v2 | wasabi:deathState state bag, isPlayerDead | RevivePlayer export. Its death-screen timer is held while EMS works. |
| wasabi_ambulance | isPlayerDead export, dead state bag | RevivePlayer export and the wasabi_ambulance:revivePlayer event |
| ars_ambulancejob | dead state bag, isDead export | ars_ambulancejob:healPlayer |
| randol_medical | dead and laststand state bags | randol_medical:client:revivePlayer |
| p_ambulancejob | isDead / dead state bags | p_ambulancejob/client/death/revive |
| osp_ambulance | BodyDamage state bag, isDead export | its qb / ESX revive events |
| ak47_ambulancejob | IsPlayerDown export | its client revive event |
| qbx_medical | qbx_medical:deathState state bag | Revive export. Respawn is locked while EMS works. |
| esx_death (ESX 1.16+) | IsDead export, isDead state bag | Revive export |
| qb-ambulancejob | isdead / inlaststand metadata | hospital:client:Revive |
| esx_ambulancejob (before esx_death) | isDead state bag | esx_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):
| Feature | What it controls |
|---|---|
Exam | The exam screen (assess, treat, history). |
Monitor | The SK-15 monitor/defibrillator. |
Equipment | Kit lives on the rig and must be carried in. Off: everything is at hand. |
Partner | The NPC partner. |
MedCommand | Patching to medical command for orders. |
PlayerPatients | EMS can treat real players who go down. Off as shipped; on the Real players page. |
PssPatients | Patients from Public Safety Simulator calls. |
EKey | The E prompt on patients and at the rig's rear doors. |
ThirdEye | Third-eye options. |
ThirdEyeOnPlayers | Our third-eye options on downed players. 'auto': off beside wasabi, which puts its own there. |
WornProps | Collars, masks, pads, leads and the rest on the patient. |
CarriedProps | Bags in the medic's hands. |
ActingProps | Syringes, vials and bottles in the hands while working. |
Acting | Treatments acted out step by step. Off: one plain pose. |
Kneel | The medic stays on a knee at the patient between tasks. |
Cot | The cot. |
Wheel | The EMS slices on the wheel. |
Manikin | The training manikin. |
Proctor | The proctor. |
Reports | The patient care report. |
Nurse | The ER nurse who takes the verbal report at the handoff. |
Coach | The 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.
| Command | Who | What it does |
|---|---|---|
/emsadmin | Admins | EMS settings (also on the admin wheel: Caps Lock > EMS > Settings). |
emsadmin on / off / status | Admins, server console | The 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 console | The 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 console | What the medical script has set on that player: its answer, health, state bags and metadata. For naming Another script. |
/emsmanikin | Admins, sals_kewlems.manikin | Spawn a training manikin. |
/emsproctor <problem> [severity] | Admins, sals_kewlems.proctor | Add a problem to the nearest patient. |
/emspartner / /emspartner dismiss | Medics | Call or dismiss the NPC partner. |
/emskit | Medics | Your kit panel, for anybody who binds it by hand. |
/emsmonitor | Medics | The SK-15 full screen or docked, for anybody who binds it by hand. |
Aces
| Ace | Grants |
|---|---|
command or sals_kewlems.admin | Admin: EMS settings, the on/off switch, the manikin and the proctor. |
sals_kewlems.level.emr / .emt / .aemt / .paramedic / .ccp | That level, ahead of job and grade. |
sals_kewlems.manikin | The training manikin. |
sals_kewlems.proctor | The proctor. |
sals_kewlems.flight | Flight crew, at the flight crew level (air medical, not yet tested in a live game). |
sals_kewlems.lz | Saving 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_kewlemsfolder 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.jsonback and says so in the console. - A
data/settings.jsonthat is not valid JSON is copied todata/settings.broken.jsonand never written over at start; the defaults are used until you save from the panel. defaults.luaholds 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
| Page | What is on it |
|---|---|
| On, off and your medical script | The 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 off | Each part on or off (table above). |
| Who is what level | Level by job and grade, the EMS jobs, the default, fire jobs, on-duty, critical care. |
| Your state's scope | Scope differences and what needs orders. |
| E, third eye and the wheel | The E key and its distance, the third eye and which resources count, the wheel and its default key. |
| The rig and the kit | Your ambulance models; reach, how many items in hand, set-down behavior; every item with its level and prop; the rig menu order. |
| The cot | Which 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 monitor | Energies, default energy, charge time and hold, the cuff cycle, pacer range and current, the share distance. |
| Medical command | On or off, hosted or protocol book, the dispatch resource, timeout, order life, the base station's name. |
| Care reports | The patient care report medics write, and where it goes when they submit it. |
| The ER nurse and the voices | The nurse at the handoff, how the nurse and the doctor sound, and whether patients answer out loud. |
| Air medical | Flight 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. |
| Hospitals | Destinations with coordinates (Use my position fills them in) and what each can take: trauma, cath lab, stroke, burns, obstetrics. |
| Public Safety Simulator calls | On or off, the poll, problems by call and by how the patient looks. |
| Real players who go down | EMS 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 partner | On or off, level, names, model, how far it looks for the rig. |
| Training | Who gets the coach; who may use the manikin and the proctor, and their reach. |
| Worn props | Where 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(...):
| Export | Returns |
|---|---|
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.JobsandByJob, and that they are on duty ifRequireOnDutyis 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.RigReachmeters 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.