Configuration Reference

Every setting in oxide-medical, what it does, and what it is set to out of the box.

How Configuration Works Here

oxide-medical is configured entirely in files. There is no settings menu, no admin panel and no database-backed configuration — edit a file, restart the resource, and the change is live.

Every config file is escrow-ignored, so all of it stays editable after installation.

Adding your own conditions needs no code. The catalogs are plain tables. Add a fracture, a disease or a sickness and the rest of the system — persistence, effects, symptoms, notifications, treatment, damage, the admin tools — picks it up automatically.

Where the Wording Lives

Anything a player can read lives in locales/en.json. The config files do not contain sentences — they contain locale keys, which are short labels like fracture.broken_leg_left that point at a line of text in the locale file.

-- shared/config/fractures.lua        locales/en.json
label = 'fracture.broken_leg_left'    "fracture.broken_leg_left": "Broken Left Leg",

To change what a player sees, edit the right-hand side in locales/en.json. To translate the resource, copy locales/en.json to locales/de.json (or whichever language), translate the right-hand side of every line, and set the server convar setr ox:locale "de". Leave the left-hand side — the key — exactly as it is; that is what the code looks for.

You can also skip the locale file entirely. If you put a sentence where a key is expected, it is shown as written:

label = 'Shattered Left Leg'   -- shown verbatim; no locale entry needed

That makes it safe to add your own fracture or disease without touching locales/en.json.

If some text in a locale line contains %s, %d or %.1f, leave those markers in place — they are where the resource inserts a name or a number. You can move them within the sentence, but do not delete them or change how many there are.

System Settings — shared/config.lua

General

Config.Immune — the immune stat

A 0–100 stat on every record. Lower immunity means illness takes hold more easily.

How it scales. The needs-sickness rules multiply their base chance by (100 - immune) / 100, so a player at 100 immunity effectively cannot catch those. Contagion and environmental sources use the same curve but floored by minSusceptibility.

Config.Damage — damage over time

Untreated severe conditions drain health.

perTick is HP lost per tick, per category, per severity. Anything not listed deals nothing:

Damage from every active condition is summed, so a player with a critical wound and a critical disease loses 6 HP per tick. It pauses while they are downed, dead or in godmode.

This is the setting most servers should look at first. It decides how punishing untreated injury is.

Config.BleedDecal — blood on the ground

Purely cosmetic and client-side. A decal is also skipped unless the player has moved at least half a metre, so standing still doesn't create a pool.

Config.Treatment — the cure progress bar

The Trigger Layer — Config.Triggers

Five independent systems, each switchable on its own.

NeedsSickness

Rolls Config.NeedsSicknessRules (below) whenever needs are evaluated, scaled by immunity, and moves the immune stat up or down.

NeedsPolling

How hunger, thirst and stress reach the two needs-driven triggers when oxide-needs is not the provider.

Why the second interval exists. Each sickness roll is a chance and moves the immune stat, so it has to run at roughly the cadence the rules were tuned for. oxide-needs fires its decay event once per game hour — about two real minutes at the default 30× time scale — and 4 × 30s matches that. If you shorten intervalMs, raise sicknessEveryNTicks to keep the product near two minutes, or players will fall ill far more often than intended.

The poll is skipped entirely while oxide-needs is running, and refuses to run if o-link has no real needs provider at all, so a server without any needs system doesn't read as permanently starving.

Dehydration

The gap between the two is deliberate hysteresis, so it doesn't flicker on and off at the boundary. This is a direct mirror, not a chance roll — there is no item cure and no duration.

DiseaseProgression

Severity only ever rises. A disease never gets better on its own.

Contagion

At most 24 nominated targets are processed per report.

Sources.WoundInfection

A dirty injury turning septic.

Matches both fractures and bleeding wounds. One hit that raises both only rolls once — there is a one-second debounce per player so a mauling doesn't get two chances at the same infection.

Sources.RainCold

The client confirms both the weather and that the player is outdoors using the game's own natives, so there is no dependency on any weather resource.

Forensics

Bleeding wounds emit as well, but only from CUTTING and WILDLIFE. Firearm blood is deliberately excluded — a police resource drops that itself from the weapon-damage event, and emitting here too would create the evidence twice.

Catalogs

Fractures — shared/config/fractures.lua

Each entry keys a fracture type to a body part, a default severity, its physical effects and its cure.

broken_leg_left = {
    label = 'fracture.broken_leg_left',
    bodypart = 'LLEG',
    defaultSeverity = Medical.Severity.SEVERE,
    effects = { limp = true, aimSway = false, movementPenalty = 0.35 },
    treatment = { item = 'medical_splint', byEmsOnly = true, timeMs = 15000 },
},

The thirteen shipped fractures and their settings:

Wounds — shared/config/woundtypes.lua

Config.WoundRules in the same file decides which class produces which wound, and the retained-bullet roll:

Diseases — shared/config/diseases.lua

flu = {
    label = 'disease.flu',
    contagious = true,
    stages = {
        { afterSec = 0,    severity = Medical.Severity.MINOR,    symptoms = { 'cough', 'fatigue' } },
        { afterSec = 600,  severity = Medical.Severity.MODERATE, symptoms = { 'cough', 'fever', 'aches' } },
        { afterSec = 1800, severity = Medical.Severity.SEVERE,   symptoms = { 'fever', 'aches', 'weakness' } },
    },
    cure = { item = 'antiviral', byEmsOnly = false },
    immunitySec = 86400,
},

afterSec is real seconds since the disease was contracted, ascending. immunitySec is how long after a cure the player cannot catch it again — 0 means no grace period. A disease may also carry its own infectChance to override the global contagion chance.

Sicknesses — shared/config/sickness.lua

dehydration and cardiac_arrest deliberately have no duration and no item cure — one mirrors the thirst stat, the other is owned by the vitals engine.

Config.NeedsSicknessRules

Which sustained needs make a player ill:

Final chance is baseChance × (100 - immune) / 100. Any rule hitting also erodes immunity by needsHitPenalty; none hitting regenerates it by regenPerTick.

Thirst is deliberately absent — dehydration is a deterministic mirror, not a roll.

Symptoms — shared/config/symptoms.lua

Maps symptom tokens emitted by diseases and sicknesses onto client effects. Tokens with no entry here are silently ignored, so you can add symptoms to a catalog entry without touching code and wire the effect later.

Three kinds:

Shipped: cough (animation, every 22 s), nausea (vomit scenario, every 38 s), and four shakes — queasy 0.18, screen_sway 0.22, dizziness 0.28, blurred_vision 0.20.

Config.SymptomShake ('DRUNK_SHAKE') names the shake style.

Wound detection — shared/config/wounds.lua

The lowest-level tuning, ported from qbx_medical.

FractureRules

The twelve classes are SMALL_CALIBER, MEDIUM_CALIBER, HIGH_CALIBER, SHOTGUN, CUTTING, LIGHT_IMPACT, HEAVY_IMPACT, EXPLOSIVE, FIRE, SUFFOCATING, WILDLIFE and OTHER. NONE marks a source that should never injure — the stun gun uses it.

Vitals — shared/config/vitals.lua

Blood

Blood volume is never saved to the database. It resets to full on load and is frozen entirely while a medic has the patient stabilized.

Pulse

BP and SpO2

Blood pressure falls with bleeding tier and with lost volume (sysPerBleedTier 3, diaPerBleedTier 2, sysPerVolumeLost 0.9, diaPerVolumeLost 0.6).

Blood oxygen starts at baseline and is reduced by chest wounds (chestWoundPerSeverity 2 per severity point of an active UPPER_BODY wound), by respiratory conditions (conditionPenalties: pneumonia 4, flu 1, infection 1, per severity point), and by hypotension below lowBpBelowSystolic 90. It floors at min 60 while alive, and decays by arrestDecayPerTick 3 during arrest.

Arrest

Arrest cannot fire while a patient is stabilized. It is cleared on revive or respawn, and a stale one is swept if a player loads in up and walking after a crash.

Notifications — shared/config/notifications.lua

The rest of the file is message pools:

• fractureGeneric, illnessGeneric, woundGeneric — fallbacks.
• bodyparts — a pool per body region, used for fractures and sometimes for wounds. These never say "broken" or "fracture" — that is the point.
• symptoms — a pool per symptom token, used for diseases and sicknesses.

A fracture draws from its body region's pool. A wound draws from the bleeding pool, with a 40% chance of using the body-region pool instead. An illness draws from the pools of all its current symptoms.

Each entry in a pool is a locale key, and the wording sits in locales/en.json under notify.vague.*. Adding a line means adding a key to both files — or, if you would rather not touch the locale file, writing the sentence straight into the pool, which is shown as written:

fractureGeneric = {
    'notify.vague.fracture_generic.1',   -- from locales/en.json
    'Something in you gave way.',        -- shown verbatim
},

Rewrite these freely. They are the entire voice of the system, and the only thing standing between a player and knowing their own diagnosis.