HEADKNOCKA Health & Illness System [OPEN SOURCE]

HEADKNOCKA Health & Illness System — Open Source Edition

Turn your server’s environment into a living, dangerous world.

The HEADKNOCKA Health & Illness System brings immersive medical roleplay and meaningful environmental consequences to your FiveM server.

Players can develop illnesses and health conditions based on extreme heat, freezing temperatures, storms, dehydration, water exposure, and other environmental hazards.

Players experience symptoms, track their health through an interactive dashboard, seek treatment from medical professionals, and recover over time.

This Open Source Edition includes editable and unencrypted HEADKNOCKA Health & Illness System source files, allowing server owners and developers to customize the resource for their community.

🌦️ AN ENVIRONMENT THAT ACTUALLY MATTERS

Weather is no longer just visual.

The system works directly with HEADKNOCKA-WEATHER to calculate environmental exposure using live server-authoritative weather, seasons, regions, and extreme events.

Environmental protection and exposure can be affected by:

• Player clothing

• Interiors

• Housing shells

• Custom MLOs

• Routing buckets

• Shade

• Heat sources

• Water exposure

• Regional weather conditions

Two nearby players can experience completely different health outcomes depending on their clothing, location, shelter, and surroundings.

🦠 DYNAMIC ILLNESS SYSTEM

Create realistic and configurable health conditions that affect players over time.

• Multiple configurable illnesses and health conditions

• Temporary and long-term conditions

• Configurable illness duration and severity

• Configurable damage and recovery times

• Optional condition progression

• Custom symptoms and player effects

• Optional contagious illness support

• Server-controlled illness progression

• Suggested treatments for each condition

Symptoms can include coughing, fatigue, dehydration, temperature changes, health loss, and other configurable effects.

🌡️ ENVIRONMENTAL HEALTH EFFECTS

Players can develop conditions after prolonged exposure to:

• Extreme heat and heatwaves

• Freezing temperatures and snow

• Heavy rain and storms

• Dehydration

• Prolonged water exposure

• Other configurable environmental hazards

Environmental data is provided directly by HEADKNOCKA-WEATHER, ensuring player health accurately reflects the active weather, season, region, and extreme events.

📋 INTERACTIVE HEALTH DASHBOARD

Players can monitor their health through a clean and responsive dashboard.

Players can view:

• Active health conditions

• Current symptoms

• Remaining condition duration

• Condition severity

• Suggested treatments

• Personal health information

• Environmental exposure risks

Live condition information also appears inside the shared HEADKNOCKA-WEATHER dockable HUD, allowing players to monitor comfort, sickness risk, and survival drain without opening a separate menu.

🚑 MEDICAL STAFF AND ADMINISTRATOR TOOLS

Give doctors, EMS staff, and authorized administrators the tools they need to diagnose and treat players.

Authorized staff can:

• View online players requiring treatment

• Access detailed player health records

• Review previous condition history

• Identify environmental causes

• Perform testing and diagnosis actions

• Apply available treatments

• Use online and offline recovery options

Create deeper medical roleplay by allowing trained professionals to diagnose conditions instead of simply restoring player health.

💊 IMMERSIVE TREATMENT SYSTEM

Treatments can require specific items, animations, sounds, props, and progress bars.

Supported treatment options include:

• Medical testing equipment

• Recovery kits

• Antibiotics

• Antiviral treatments

• Cooling packs

• Warming packs

• Custom treatment items

• Custom medical resource integrations

Client and server exports are included, allowing developers to connect the system with custom hospitals, EMS scripts, survival systems, and medical resources.

🔓 OPEN SOURCE EDITION

This edition is designed for server owners and developers who require deeper customization and complete control over the resource.

Open Source Edition benefits include:

• Editable and unencrypted resource source files

• Customize illness and treatment behavior

• Add custom conditions and symptoms

• Modify framework and inventory integrations

• Build custom medical resource integrations

• Adjust environmental exposure calculations

• Customize dashboard behavior

• Extend client and server functionality

• No Asset Escrow encryption on the included health and illness resource files

Open source access does not grant permission to resell, redistribute, leak, or share the resource. All usage remains subject to the included purchase license.

⚙️ COMPATIBILITY

Supported Frameworks:

• QBCore

• ESX Legacy

• Standalone

Supported Inventories:

• ox_inventory

• QBCore Inventory

• ESX Inventory

Optional Integrations:

• illenium-appearance

• Custom housing resources

• Custom medical resources

The resource automatically detects the active framework and supported inventory system.

🚀 BUILT FOR PERFORMANCE

• Batched database saving for larger servers

• Configurable dashboard data limits

• Optimized environmental exposure checks

• Safe automatic database migrations

• Optional debug mode through a server convar

• Customer-editable configuration files

• Client and server exports for custom integrations

🛠️ DEPENDENCIES AND INSTALLATION

Required Dependencies:

• ox_lib

• oxmysql

• HEADKNOCKA-WEATHER

Recommended Load Order:

ox_lib → oxmysql → HEADKNOCKA-WEATHER → HEADKNOCKA-DISEASES

The resource includes automatic database table creation, safe database migrations, item images, inventory installation files, database files, and installation documentation.

📦 INCLUDED WITH YOUR PURCHASE

• Complete open-source health and illness system

• Editable and unencrypted source files

• Environmental exposure system

• Interactive player health dashboard

• Medical staff and administrator tools

• Configurable illnesses and conditions

• Configurable treatment items

• Item images

• Inventory installation files

• Database installation files

• Configurable animations, props, and sounds

• Client and server integration exports

• Installation documentation

📥 DELIVERY

After purchase, the Open Source Edition is delivered automatically with the resource files and installation documentation.

Configuration files, source files, item images, inventory installation files, database files, and all required setup instructions are included with the download.

Create more meaningful medical roleplay.

Make weather dangerous. Make preparation important. Give your medical teams a real purpose.

Bring immersive illnesses, environmental exposure, advanced medical roleplay, and complete customization to your server with the HEADKNOCKA Health & Illness System Open Source Edition.