cer_donations is an advanced, immersive blood extraction, phlebotomy, and hematology analysis system for FiveM roleplay servers. It delivers a clinical, highly realistic experience with interactive in-game station placement, synchronized medical procedures, cardiac cadence minigames, and automated laboratory testing—all with zero idle consumption. Built on a modular bridge architecture, it supports Standalone mode and a wide range of frameworks, inventories, and target systems out of the box.
[TAG:STANDALONE] [DEP:oxmysql]
In-Game Station Placement & Management
- Create and configure clinical extraction stations directly from within the game using interactive raycast placement.
- Synchronized reclining phlebotomy chair with exact OneSync coordinates, orientation offsets, and ped seat locking.
- Cold-chain medical refrigerator with persistent inventory stash storage for collected blood bags.
- Easily remove or manage the nearest extraction station in real time with job authorization safeguards.
Pre-Extraction Triage & Informed Consent
- Synchronized medical clipboard handoff between practitioner and donor.
- Interactive clinical triage questionnaire assessing patient eligibility, vitals, and contraindications.
- Digital signature capture pad to validate informed consent before clinical procedures can commence.
Synchronized IV Cannulation & Clinical Procedures
- Multi-step clinical workflow: vein palpation, skin asepsis, 16G needle cannulation, catheter advancement, and dressing.
- Dual-perspective procedure interface: full simulator controls for the medical practitioner and an observer view for the donor.
- Realistic decannulation, needle withdrawal, and sterile compression bandage application.
Gravimetric Extraction & Pumping Rhythm
- Rhythmic pumping minigame (systole/diastole) matching human resting heart rate (~50–60 BPM) to sustain venous flow.
- Clinical 450 mL collection scale with realistic mass calculation, CPDA-1 anticoagulant baseline, and live 60 FPS plethysmography trace.
- Physiological metabolic drain affecting donor hydration and hunger, protected by configurable vital safety floors.
HemoScan Pro X-900 Hematology Analyzer
- 1-slot physical specimen chamber with automated 180-second centrifugation and laser analysis cycle.
- Diegetic 3D spatial audio: mechanical startup, continuous centrifuge drone, error warnings, and completion chimes.
- Accredited laboratory reports detailing ABO typing, Rh factor (8 blood groups), complete blood counts (CBC), and serological clearance.
- Automatic item metadata mutation stamping certified lab data directly onto blood units.
- Interactive Code 128 barcode scanner on printed clinical sheets with customizable event hooks for any Medical CAD/MDT.
Modern User Interface (CEF Safe)
- React 19 & Vite diegetic interface engineered strictly for FiveM CEF with zero blur/shadow artifacts and 0.00 ms idle consumption.
- Built-in notification overlays, TextUI hints, and dialogs—eliminating the need for external UI libraries.
- Full bilingual support with real-time locale hot-swapping between English and Spanish.
Bridge Architecture
- Frameworks native support for QBX Core, QBCore, ESX Legacy, and Standalone.
- Target compatible with targets, and a built-in proximity TextUI system.
- MDT / CAD Integration modular server and client event hooks to connect any records system.
Compatibility
| Dependency | Status |
|---|---|
| oxmysql | Required |
| ox_inventory / qb-inventory | Required (one) | handles blood item metadata and cold-chain stashes |
| QBX Core / QBCore / ESX Legacy | Not Required | auto-detected at runtime (Standalone supported) |
| ox_target / qb-target | Optional | built-in proximity TextUI fallback activates automatically |
| ox_lib | Not Required | in-house React 19 UI handles notifications, TextUI, and dialogs |
The core script is fully decoupled from all third-party integrations. New Framework, Inventory, Target, or Interaction systems can be added simply by placing an adapter file in the corresponding bridge folder without modifying any core files.
Configuration Highlights
- Configurable clinical jobs, grades, and permissions for phlebotomists and laboratory technicians.
- Interactive station creation and deletion commands with permission toggles.
- Bilingual locale support: English and Spanish included out of the box.
- Adjustable blood collection volume (default 450 mL), flow per pump, and anti-spam rhythm thresholds.
- Configurable centrifugation cycle duration, 3D spatial sound volumes, and metabolic drain limits.
- Decoupled modular architecture with automatic runtime framework and inventory detection.
