Documentation
Every resource Quasar Medical Creator works with: ESX, QBCore, Qbox, ox_inventory, qs-inventory, ox_target, vehicle keys, fuel, clothing, billing, dispatch, phones, insurance and Discord logs — and how to add your own.
Everything that depends on another resource sits behind a small, unencrypted bridge file in client/custom/, server/custom/ or custom/. At start, config/main.lua looks at which supported resources are running and picks the matching bridge:
Layer | Supported | Without it |
|---|---|---|
Framework | es_extended · qb-core · qbx_core | Required — the resource will not start. |
Inventory | qs-inventory · qb-inventory · ox_inventory · tgiann-inventory · origen_inventory | No stash, no shop, empty item picker in the creator. |
Target | ox_target · qb-target | Set |
Vehicle keys | qs-vehiclekeys · qb-vehiclekeys · qbx_vehiclekeys · wasabi_carlock · MrNewbVehicleKeys · F_RealCarKeysSystem · fivecode_carkeys · glfp10_carkeys · mono_carkeys · ti_vehicleKeys · vehicles_keys · xd_locksystem | Garage vehicles and wheelchairs spawn without keys. |
Fuel | qs-fuelstations · LegacyFuel · ox_fuel · cdn-fuel · ps-fuel · lj-fuel · okokGasStation · esx-sna-fuel · ti_fuel · BigDaddy-Fuel · lc_fuel (manual) | The native fuel level is set. |
Clothing | qs-appearance · illenium-appearance · fivem-appearance · qb-clothing · codem-appearance · ak47_clothing · raid_clothes · rcore_clothes · rcore_clothing · sleek-clothestore · tgiann-clothing · p_appearance · mAppearance (manual) | QBCore opens qb-clothing; ESX opens a saved-outfits menu from esx_datastore. |
Boss menu | esx_society · qb-management | The boss point says the system is not supported. |
Billing | esx_billing · qb-billing · qs-billing · okokBilling | The Bill action shows an error. |
Dispatch | origen_police · emergency_dispatch | Only the built-in Dispatch list in the EMS menu. |
Phone | qs-smartphone-pro · qs-smartphone · lb-phone | Only used when phone distress is turned on. |
Insurance | m-Insurance | No check-in discount. |
Interface | qs-interface · qs-textui | Built-in notifications, ox_lib text UI and progress circle. |
Run one resource per layer. With two key systems or two inventories started, either one may be picked. Detection only sees resources started before
qs-medical-creatorinserver.cfg.
es_extended loads the ESX bridge; qb-core and qbx_core load the QBCore bridge, which Qbox uses through its QBCore compatibility. The bridges live in custom/esx/ and custom/qb/ and hold every framework call: money, items, jobs, names, admin checks and the dead flag.
Feature | ESX | QBCore / Qbox |
|---|---|---|
Dead state saved in |
| metadata |
Duty | Job swap with | The job's on-duty flag |
Boss | Grade name | Grade with |
Admin | Groups |
|
On revive | Resets esx_basicneeds | Resets hunger, thirst and stress |
Extra commands |
|
|
Renamed your framework resource? Replace the detection with the value by hand — Config.Framework = 'esx' or 'qb' — and point the bridge's exports['es_extended'] / exports['qb-core'] line at the new name.
The inventory decides how the EMS stash and the pharmacy open, and feeds the creator's item picker with names and pictures. The stash is personal to each medic.
Inventory | Stash | Pharmacy |
|---|---|---|
| Yes | Through |
| Yes | The inventory's shop. |
| Yes — registered on first use | An ox_lib menu; each purchase takes cash and gives one item. |
| Yes | The inventory's shop. |
| Yes | Not included — add an |
Stash size comes from Config.DefaultStashData. Running without a supported inventory is possible for testing, but the console warns every few seconds — it is not meant for a live server.
With Config.UseTarget = true, every hospital point and the medical bag become target options — through ox_target when it runs, otherwise qb-target. The box size is Config.TargetWidth × Config.TargetHeight, and Config.ZoneDebug draws them. With false, each point is a floating prompt used with E — drawn by qs-textui if it runs.
If qs-interface is running, its notifications and progress bars are used; otherwise Medical Creator shows its own toasts and the ox_lib progress circle. qs-textui replaces the ox_lib text UI the same way. All of it is in custom/client.lua — swap a function there to use another notification or progress resource.
The Bill action asks the medic for an amount and invoices the closest player:
Resource | What happens |
|---|---|
| An invoice to |
| An invoice to |
| A custom invoice for the |
| The amount is charged from the patient's bank straight away and paid into the job's qb-management account. |
When a downed player presses G, three things can happen:
Built-in: on-duty medics are notified and the call is listed under Dispatch in the EMS menu. Always on, unless phone alerts replace it.
Dispatch resource: with origen_police or emergency_dispatch running, an "injured person" alert with the location is sent there too. The text is in client/custom/dispatch/.
Phone: with Config.UsePhoneDistressSignal = true, a job alert with the location goes to every job in Config.Jobs on qs-smartphone, qs-smartphone-pro or lb-phone, instead of the built-in list.
The wardrobe point opens your clothing script's outfit menu. Garage vehicles and wheelchairs get keys through your key system and a full tank through your fuel script. Each bridge is one file in client/custom/wardrobe/, vehiclekeys/ or fuel/. lc_fuel and mAppearance have bridges but are not detected — set them by hand (see below).
With m-Insurance running, a player with valid health insurance pays less to check in:
Config.InsuranceDiscount = {
checkIn = 0.5, -- 50% off the check-in price
}Another insurance script plugs in through server/custom/insurance/: one HasHealthInsurance(source) function that returns true or false.
Four channels, each with its own webhook in server/webhooks.lua. Leave one empty to turn it off.
Channel | What goes there |
|---|---|
| Every death: killer and victim, weapon and cause, or suicide — with a screenshot of the victim. |
| Admin revives with |
|
|
| Hospitals created, edited and deleted, and by whom. |
-- server/webhooks.lua
Config.ShowWebhookIP = false -- true shows the player's IP in each log
_G['webhook'] = {
revive = 'https://discord.com/api/webhooks/...',
heal = '',
death = 'https://discord.com/api/webhooks/...',
creator = 'https://discord.com/api/webhooks/...'
}
_G['fivemanage'] = {
webhook = '' -- your FiveManage API token, for screenshots
}Each log names the player with their server id and every identifier (Steam, Discord, license, FiveM). Screenshots need screenshot-basic running and a FiveManage token. Logs are queued, so a burst of deaths never hits Discord's rate limit.
Medical Creator works in any hospital MLO — draw the zone around it and place the beds on its own bed props. If bob74_ipl is running, its Pillbox interior is switched off a few seconds after start, and again whenever bob74_ipl restarts, so it never overlaps the bundled hospital_map or your MLO.
Each layer in config/main.lua is a list of resource names and the bridge each one picks. To force one, replace the detection with the bridge's value:
-- Auto, the default: the first started resource in the list wins.
Config.Fuel = DependencyCheck(fuels) or 'standalone'
-- Pinned by hand:
Config.Fuel = 'lc_fuel'
Config.Wardrobe = 'mAppearance'
Config.Inventory = 'ox_inventory'This is worth doing when two candidates run at once, when a resource was renamed, or for a bridge that ships without auto-detection.
Supporting a resource that is not listed takes one file and one line:
Duplicate a file in the same folder — for example client/custom/fuel/LegacyFuel.lua — and name it after your resource.
The file opens with a guard such as if Config.Fuel ~= 'LegacyFuel' then. Put your value there, then replace the exports inside each function with your resource's.
Add ['my_fuel'] = 'my_fuel' to the matching list in config/main.lua, or pin it as shown above, and restart.
The functions each kind needs:
Kind | Folder | Functions |
|---|---|---|
Fuel |
|
|
Keys |
|
|
Clothing |
|
|
Inventory |
|
|
Boss menu |
|
|
Dispatch |
|
|
Phone |
|
|
A different target resource is wired in client/custom/target/main.lua, and a different framework by duplicating custom/esx/ or custom/qb/.
27 translations ship in locales/. Set Config.Locale to one of:
ar · bg · ca · cs · da · de · el · en · es · fa · fr · hi · hu · it · ja · ko
nl · no · pl · pt · ro · ru · sl · sv · th · tr · zh-CNA missing text falls back to English, so a partial translation never breaks the interface. For a new language, copy locales/en.json to a new code, translate it and set Config.Locale to that code.