Home

QC-AdvancedMedic Wiki

Version: 0.2.9-beta
Platform: CFX.re (RedM/FiveM)
Framework: RSG-Core
License: Custom (Free for CFX servers, no resale)

---

Welcome

QC-AdvancedMedic is a comprehensive medical roleplay system for RedM servers, featuring realistic wound mechanics, infection progression, treatment systems, and persistent medical history. Built with performance and immersion in mind.

Note

This is currently in beta. The core systems work, but there are known issues (particularly with the healing system). See Known Issues for details.

---

🎯 Key Features

Realistic Damage System

• 15 body parts tracked independently (head, arms, legs, hands, feet, torso)
• Ballistic calculations - bullet behavior based on distance (lodging, penetration, fragmentation)
• 100+ weapons pre-configured with unique damage profiles
• Environmental damage - falls, animal attacks, fractures

Medical Progression

• Wound progression - untreated wounds worsen over time (pain, bleeding)
• Infection system - 4-stage progression with stamina/movement penalties
• Healing to scars - properly treated wounds heal into permanent scars (⚠️ currently bugged)
• Fractures - bone breaks from falls requiring splints/surgery

Treatment Systems

• Bandages (4 types) - cloth, cotton, linen, sterile
• Tourniquets (4 types) - emergency bleeding control
• Medicines (4 types) - morphine, laudanum, whiskey, quinine
• Injections (4 types) - adrenaline, cocaine, strychnine, saline
• Cure items - antibiotics, alcohol for infections

Persistent Medical History

• 5 database tables - wounds, treatments, infections, fractures, history
• Complete audit trail - every medical event logged
• Medic inspection - /inspect command shows full medical status
• Scar system - permanent scars visible to medics

Roleplay Features

• Medical bag deployment for field treatment
• Medic missions - NPC patient care with rewards
• Duty pay system - automatic pay for on-duty medics
• Death system - configurable respawn timers, medic calls
• React NUI - professional medical inspection interface

---

📚 Wiki Navigation

Getting Started

• Installation Guide - Setup instructions (see main repo)
• Configuration - Config reference and customization

Technical Documentation

• Architecture - System design and data flow
• Client Systems - Wound detection, treatment, infection, healing
• Server Systems - Database, events, caching, commands
• Database Schema - Tables, stored procedures, views
• API Reference - Events and exports for developers

Customization & Development

• Extending the System - Add weapons, items, body parts
• Performance Optimization - Server tuning tips

Support

• Known Issues - Current bugs and workarounds
• GitHub Issues - Report bugs
• Discord - Community support

---

🚀 Quick Start

For Server Owners

1. Install the resource

   cd resources/[quantum]
   git clone https://github.com/Quantum-Projects-RedM/QC-AdvancedMedic

2. Run the database schema

   source INSTALL_FIRST/schema.sql

3. Add items to rsg-core

   cp INSTALL_FIRST/shared_items.lua rsg-core/shared/items.lua
   # Merge the items into your existing file

4. Configure the resource

   • Edit config.lua for your server needs
   • Set Config.DeadMoveCam = false for production (performance)

5. Start the resource

   ensure QC-AdvancedMedic

For Developers

Check the API Reference for exports and events:

-- Get player wounds
local wounds = exports['QC-AdvancedMedic']:GetPlayerWounds()

-- Apply treatment
exports['QC-AdvancedMedic']:ApplyBandage('HEAD', 'cotton', source)

-- Check bleeding level
local bleeding = exports['QC-AdvancedMedic']:GetBleedingLevel()

---

⚠️ Important Notes

Note

Wound Healing Mechanic

Wounds require active bandage maintenance to heal into scars. Bandages must be replaced regularly (every 3-12 min) during the healing period (10-40 min). This encourages realistic medical roleplay and ongoing patient care.

Warning

Performance Warning

Config.DeadMoveCam = true adds ~0.12ms per dead player. Disable for servers with 50+ players. See Performance Optimization.

Note

Production Readiness

All core systems are functional. The bandage maintenance mechanic requires ongoing wound care, making it ideal for roleplay servers emphasizing realistic medical treatment.

---

📊 System Statistics

• Client Files: 9 (7500+ lines)
• Server Files: 6 (3000+ lines)
• Database Tables: 5
• Network Events: 40+
• Configured Weapons: 100+
• Body Parts: 15
• Treatment Types: 4 (bandages, tourniquets, medicines, injections)
• Infection Stages: 4

---

🏆 Credits

Created by: Artmines
Organization: Quantum Projects
Framework: RSG-Core (RedM)
Platform: CFX.re

See CONTRIBUTORS.md for all contributors.

---

📞 Support & Community

• Discord: Quantum Projects
• GitHub Issues: Report Bugs
• GitHub Discussions: Ask Questions

---

Last Updated: November 3, 2025
Documentation Version: 1.0

---

Next: Architecture →