Configuration — ns-deathscreen
Everything is in config.lua (not escrowed). Defaults in brackets.
General
| Key | Meaning |
|---|
Config.Framework ['auto'] | 'qbox', 'qbcore', 'esx', 'standalone' |
Config.Locale ['en'] | 'en' or 'tr'; add locales/<code>.lua for more |
Config.Debug [false] | debug log, e.g. why a respawn was refused (deaths category) |
Config.Medical ['auto'] | 'qbx_medical' (full) or 'generic' (dead / alive only, respawn stays with your ambulance job) |
Features (Config.Features)
| Key | Default | Turns on |
|---|
EmsCall | true | hold G to call EMS |
Recap | true | the "What happened" sheet (and injuries) |
GiveUp | true | hold H while knocked down (qbx_medical) |
Respawn | true | hold E respawn with the server timer (qbx_medical). Off: qbx_medical's own respawn is left alone |
Heartbeat | true | heartbeat sound while down, a short flatline tone at death |
ScreenEffect | true | desaturated picture |
Keys (Config.Keys)
ems (47 / G), giveUp (74 / H), respawn (38 / E). control is the GTA control index, label is what the screen
shows. Change both together.
Respawn (Config.Respawn)
| Key | Default | Meaning |
|---|
time | 300 | seconds after death before respawn is allowed |
timeWithEms | 300 | the same when a medic was on duty at the moment of death (e.g. 600) |
blockWhenEmsOnline | false | no respawn at all while a medic is on duty |
holdMs | 3000 | how long E is held |
auto | false | respawn by itself when the timer is over |
feeText | '$2,000' | shown next to the key; the fee is charged by your ambulance job ('' hides it) |
Give up (Config.GiveUp)
after [60] seconds knocked down before H works, holdMs [3000].
EMS (Config.Ems)
| Key | Default | Meaning |
|---|
jobs | { 'ambulance' } | jobs counted as EMS (on duty) and alerted |
holdMs | 1000 | how long G is held |
cooldown | 60 | seconds between two calls of one player (also across deaths) |
maxCalls | 3 | calls per death, 0 = unlimited |
countRefresh | 15 | seconds between two "medics on duty" refreshes |
provider | 'auto' | qbx_ambulancejob, ps-dispatch, cd_dispatch, rcore_dispatch, builtin, custom, none |
alertBlipSeconds | 120 | built-in alert: blip lifetime |
custom | — | function(src, coords, message) return true end (server, provider custom) |
Recap (Config.Recap)
| Key | Default | Meaning |
|---|
killer | 'off' | 'off' (no "By" row, the killer is never sent), 'hidden' ("a person"), 'id' (server id), 'name' (character name + id) |
maxDistance | 400.0 | a killer further away (server positions) is not shown |
hits | 5 | weapons listed under "Hits taken" |
hitWindow | 30 | seconds before going down that count |
injuries | true | injury sheet (qbx_medical) |
HUD (Config.Hud)
| Key | Default | Meaning |
|---|
hide | true | hide the HUD while the death screen is up (also in /deathpreview) |
provider | 'auto' | 'ns-hud' (widgets + minimap), 'native' (GTA minimap + HUD), 'custom', 'none'; auto = ns-hud when started, otherwise native |
custom | — | function(hidden) end (client, provider custom) for another HUD resource |
Effects (Config.Effects)
downModifier / deadModifier (timecycle name, '' = none), downStrength [0.6], deadStrength [1.0],
heartbeatVolume [0.35].
Commands and admin
Config.Commands.preview ['deathpreview']: /deathpreview down | dead | off. Admin = ACE
ns-deathscreen.admin or framework admin (Config.Admin).
