Oxide Medical

oxide-medical is the medical layer for a FiveM roleplay server: the system that decides what is actually wrong with a player, and keeps it wrong until somebody treats it.

Every character gets a persistent medical record — blood type, DNA, an immune stat, and a live list of conditions. Getting shot, stabbed, mauled, blown up or thrown off a building produces specific injuries chosen from what hit you and where it landed: a broken leg that makes you limp, a laceration that bleeds on the ground, a retained bullet only a surgeon can extract. Getting rained on, going hungry, or standing next to somebody with the flu produces illnesses that get worse over hours and spread to other people. Staying out in the cold brings on hypothermia, and breathing a fire's smoke brings on smoke inhalation. On top of it all sits a vitals simulation — pulse, blood pressure, blood oxygen — driven by a blood-volume model, where enough blood loss collapses the pulse into cardiac arrest.

The player is never told what is wrong with them. They are told their chest aches, their vision swims, their limbs feel heavy. Diagnosing it is somebody else's job, which is the point: oxide-medical is what gives an EMS department real work to do.

oxide-medical is framework-agnostic through o-link and runs on QBCore, ESX and Qbox. It has no UI of its own — it is a system layer, exposed through exports, statebags and events for other resources to build on. It pairs with oxide-ems, the EMS job that examines patients, operates on them, and treats the medic-only conditions.

Key Features

• Persistent Medical Records — Blood type, DNA hash, immune stat (0–100), allergies, post-cure immunity windows and chronic conditions per character, backed by MySQL
• Four Condition Categories — Editable catalogs for fractures (13 types), wounds (gunshot, laceration, retained bullet), diseases (influenza, wound infection, pneumonia, hepatitis) and sicknesses (nausea, fever, dizziness, dehydration, food poisoning, cardiac arrest, hypothermia, smoke inhalation)
• Damage Classification — 96 weapons and damage sources mapped to twelve classes, 56 ped bones mapped to fifteen body parts, with fracture rules driven by class and damage amount; repeat hits escalate the existing injury instead of stacking duplicates, and bullet-class hits roll separately for a retained bullet
• Physical Effects — Limp clipset, movement penalty, aim sway while shooting, and throttled blood decals under a bleeding player, all driven off the condition list
• Symptom Effects — Continuous camera shake for dizziness and lightheadedness, periodic coughing and vomiting animations, mapped from symptom tokens you can extend without touching code
• Vitals Engine — Pulse, blood pressure and blood oxygen recalculated every couple of seconds from active conditions plus an in-memory blood-volume accumulator, published quantized and change-only so idle players cost nothing
• Cardiac Arrest — A pulse that stays collapsed for several ticks adds a critical condition and drops the player where they stand, cleared on revive and swept if it survives a crash
• Disease Progression & Contagion — Timed stages raise severity and swap symptoms as real time passes (severity never regresses); proximity contagion is server re-validated for distance, disease and immunity, with masks on either party cutting the chance
• Environmental & Needs-Driven Illness — Rain exposure checked through the o-link weather bridge with a fallback to the game's own weather, so no weather resource is required, dirty wounds turning septic, an immune stat that erodes under sustained neglect and regenerates when healthy, and deterministic dehydration mirroring the thirst stat with hysteresis
• Hypothermia — Off by default. With a weather resource that reports temperature and cover through o-link, such as oxide-weather, players left uncovered in the cold start shivering and pick up a hypothermia sickness that clears once they have been warm for a while. Tuned by the database-backed WeatherIntegration setting
• Smoke Inhalation — A resource that sees a player breathing smoke, such as a fire resource, reports the dose through ReportExposure. The condition follows it from a cough through shortness of breath, dizziness and weakness to failing to breathe, costing health and blood oxygen as it worsens, and clears in clean air or at once with a medic's treatment. Without a resource that reports smoke, it never happens
• Vague Symptom Notifications — The player is never told the diagnosis; per-body-region and per-symptom message pools in config
• Self-Treatment & Medic-Only Care — Usable cure items with a progress bar, server-validated on completion; medic-only conditions are refused and left to the EMS pipeline
• Damage Over Time — Severe untreated conditions drain health, applied client-side so reaching zero routes through the server's normal death handling
• Godmode Suspension — Automatic suspension for players in godmode, with no dependency on the resource that sets it, plus explicit exempt controls
• Blood-Evidence Handoff — Non-firearm bleeds carry the character's DNA so a police resource can create forensic evidence without duplicating firearm blood drops
• Developer Surface — Sixteen server exports, two client exports, an o-link medical namespace, two replicated statebags and four condition-change events
• Admin Toolkit — /med with fifteen subcommands including eleven scenario simulations, and a built-in self-test that exercises the whole export surface and reports pass/fail per check

Requirements

Required

Recommended

Supported Frameworks

Quick Start

The medical_records and medical_conditions tables are created automatically the first time oxide-medical starts. The database user needs permission to create tables.

See the Installation Guide for the full setup flow.

Documentation