Known Issues

Known Issues

Complete list of known bugs, workarounds, and planned fixes for QC-AdvancedMedic.

---

Important Game Mechanics

💡 Bandage Maintenance System (Not a Bug!)

Note

Status: Intentional game mechanic (Working as designed)

Purpose: Encourage realistic medical roleplay and ongoing patient care.

How It Works

Wounds require active bandage maintenance to heal into scars. This is intentional design.

The System:

• Bandage durations: 3-12 minutes (depending on type)
• Healing times: 10-40 minutes (depending on wound type)
• Players must replace bandages regularly during healing

Proper Healing Workflow

Example: Gunshot Wound (15 min heal time)

0:00  - Apply sterile bandage (12 min duration)
12:00 - Bandage expires, reapply fresh sterile bandage
15:00 - Wound heals into scar

Bandage Changes Required:

Wound Type	Heal Time	Sterile Bandages Needed
Cutting	10 min	1 bandage
Shot Through	15 min	2 bandages
Crushing	20 min	2 bandages
Post-Surgery	25 min	3 bandages
Fragmented	35 min	3 bandages
Explosive	40 min	4 bandages

Why This Design?

1. Realistic Roleplay: Real wounds need ongoing care
2. Medical Job Value: Gives medics ongoing tasks
3. Resource Economy: Creates demand for medical supplies
4. Prevents "Set and Forget": Players can't just bandage once and walk away

Tips for Server Owners

• Educate players on bandage maintenance
• Stock medical supplies at hospitals
• Consider creating "long-lasting bandage" items if needed
• Use this mechanic to create medic RP scenarios

---

Minor Issues

Shotgun Pellet Detection

Warning

Status: Known limitation

Problem: Shotgun pellet hit detection may miss at extreme angles (>80° from center mass).

Cause: RedM engine limitation with GetPedLastDamageBone() when multiple projectiles hit simultaneously.

Impact: Low - most shotgun hits register correctly

Workaround: None currently available

Fix Status: Investigating alternative detection methods for v0.3.0

---

Wound Data Desync in High Latency

Note

Status: Rare issue

Problem: Desync between client/server wound data in connections >200ms latency.

Cause: Network lag causes event order issues

Impact: Minimal - the 5-minute auto-sync resolves this

Workaround:

-- Force manual sync
TriggerServerEvent('QC-AdvancedMedic:server:UpdateWoundData', PlayerWounds)

Fix Status: Considering optimistic locking for v0.3.0

---

Fall Damage on Slopes

Note

Status: Known issue

Problem: Fall damage may trigger on steep slopes (>45° angle) even without actual falling.

Cause: Velocity-based detection interprets rapid descent as falling

Impact: Low - mostly affects mountain climbing

Workaround: Adjust sensitivity in config:

Config.FallDamage.minHeight = 5.0  -- Increase from 3.0 to reduce sensitivity

Fix Status: Considering angle detection for v0.3.0

---

Performance: Death Camera

Warning

Status: By design, but performance-heavy

Problem: Free-look death camera adds ~0.12ms per dead player.

Cause: Runs at 62 FPS (16ms interval) while dead

Impact: High on servers with many simultaneous deaths

Workaround: Disable in config:

Config.DeadMoveCam = false

Fix Status: Will remain as optional feature. See Performance Optimization for details.

---

Cosmetic Issues

Addiction System Not Functional

Note

Status: Planned feature, not implemented

Problem: Medicine/injection addiction risks show notifications but have no gameplay effects.

Current State: Cosmetic only - notifications display but no actual addiction tracking

Planned: Full addiction system in v0.3.0 with withdrawal effects

---

Database Issues

Medical History Bloat

Note

Status: Resolved via scheduled cleanup

Problem: medical_history table grows indefinitely if cleanup not scheduled.

Impact: Database performance degrades over time

Workaround: Schedule cleanup procedure:

# Daily cleanup at 3 AM
0 3 * * * mysql -u user -ppassword database -e "CALL CleanupExpiredMedicalData();"

Fix Status: Documentation improved. See Performance Optimization.

---

Compatibility Issues

RSG-Core Version Requirements

Important

Status: Version dependency

Problem: Requires RSG-Core with specific exports.

Minimum Version: RSG-Core v1.0.0+

Required Exports:

• RSGCore.Functions.GetPlayer(source)
• RSGCore.Functions.GetPlayers()
• RSGCore.Functions.CreateUseableItem()
• RSGCore.Commands.Add()

Workaround: Update RSG-Core to latest version

---

oxmysql vs mysql-async

Important

Status: oxmysql required

Problem: Script uses oxmysql syntax, not compatible with old mysql-async.

Error Example:

SCRIPT ERROR: MySQL.query.await is not a function

Fix: Install oxmysql:

ensure oxmysql

---

Planned Features (Not Yet Implemented)

Surgery System

Status: Planned for v0.3.0

Features:

• Remove lodged bullets
• Repair fragmented wounds
• Surgical mini-game

---

Blood Transfusion

Status: Planned for v0.3.0

Features:

• Blood type system
• Transfusion requirement for severe bleeding
• Blood bag items

---

Medical Training System

Status: Planned for v0.4.0

Features:

• Skill progression for medics
• Better treatment success rates with experience
• Specializations (surgeon, pharmacist, etc.)

---

Reporting New Issues

Before Reporting

1. Check this page for existing issues
2. Verify you're on latest version (v0.2.9)
3. Check server console for errors
4. Test on clean server (no other medical scripts)

How to Report

GitHub Issues: Submit Issue

Include:

• QC-AdvancedMedic version
• RedM server build
• RSG-Core version
• Server console errors
• Steps to reproduce
• Screenshots/videos if applicable

Discord: Quantum Projects

---

Issue Priority Guide

Critical (Fix ASAP)

• Healing system bug (documented above)
• Database corruption
• Server crashes
• Exploits/duplication bugs

High (Fix Soon)

• Major gameplay blockers
• Performance issues
• Data loss risks

Medium (Future Update)

• Minor bugs
• Quality of life improvements
• Missing features

Low (Backlog)

• Cosmetic issues
• Edge cases
• Nice-to-have features

---

← Performance Optimization | Back to Home