Scripts [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.

HEADKNOCKA-WEATHER — Open Source Edition

Transform your FiveM server with a complete server-authoritative weather, time, season, forecast, and extreme-event system.

HEADKNOCKA-WEATHER gives server owners complete control over the world’s climate while providing players with a polished, customizable weather HUD.

Create different weather conditions across multiple regions, run realistic seasonal weather cycles, trigger destructive natural disasters, enable player weather voting, synchronize time across every client, and connect environmental conditions directly with HEADKNOCKA-DISEASES.

This Open Source Edition includes fully editable resource files, allowing developers to customize the weather logic, user interface, environmental calculations, integrations, and extreme events for their server.

🌦️ SERVER-AUTHORITATIVE WEATHER SYSTEM

Weather and time are controlled by the server, ensuring every connected player receives a synchronized and consistent experience.

• Automatic dynamic weather changes

• Smooth weather transitions

• Configurable weather probabilities

• Configurable transition duration

• Per-weather wind speed and direction

• Rain, puddle, snow-track, and vehicle-trail handling

• Server-controlled weather synchronization

• Optional manual weather control

• Configurable weather blacklist

🗺️ REGIONAL WEATHER

Different areas of the map can experience completely different weather conditions at the same time.

Default regions include:

• Los Santos

• Sandy Shores

• Paleto Bay

• Blaine County

Regions can be renamed, repositioned, resized, removed, or expanded with additional custom regions.

Players automatically receive the correct weather and environmental information based on their current location.

🍂 DYNAMIC SEASON SYSTEM

Create a world that changes throughout the year with configurable seasons and seasonal weather patterns.

Supported seasons include:

• Spring

• Summer

• Autumn

• Winter

Season modes include:

• Real-world seasonal progression

• Automatic cycling

• Manual season control

Each season can have its own weather probabilities, voting restrictions, and environmental behavior.

Winter can bring snow and blizzards, while summer can increase clear skies, thunderstorms, and extreme heat.

🕒 ADVANCED TIME SYSTEM

Control the server clock with multiple configurable time modes.

• Scaled in-game time

• Real-world synchronized time

• Frozen time

• Configurable day length

• Smooth server-authoritative time progression

• Manual time controls

• Optional 12-hour or 24-hour display

🔮 WEATHER FORECAST

Players can view upcoming weather directly from the weather HUD.

• Configurable forecast slots

• Forecast automatically updates with weather changes

• Forecast responds to active regions and seasons

• Clean illustrated weather icons

• Support for custom weather icon images

🌪️ EXTREME WEATHER AND NATURAL DISASTERS

Trigger powerful server-wide extreme events that create real physical effects throughout the world.

Included extreme events:

• Earthquakes

• Severe storms

• Extreme cold

• Extreme heat

• Tsunamis

• Meteor showers

• Hurricanes

Extreme events can include:

• Physical rising and draining flood water

• Earthquake camera shaking

• Ped ragdoll effects

• Vehicle and object forces

• Hurricane wind and vehicle drift

• Falling meteor rocks

• Meteor explosions and fires

• Heat haze and extreme-temperature visuals

• Blizzard and freezing-weather effects

• Server-wide warnings and event status

Extreme events can be triggered through commands, the admin panel, or server exports.

🌊 PHYSICAL TSUNAMI SYSTEM

The tsunami event creates a staged physical flood instead of only changing the weather.

• Configurable warning period

• Gradual water rise

• Configurable flood height

• Flood hold period

• Gradual water drainage

• Server-authoritative flood synchronization

• Included water definition files

• Flood-state exports for custom integrations

☣️ CONFIGURABLE APOCALYPSE WEATHER ZONES

Create local weather and environmental zones that operate independently from the normal city weather.

Apocalypse zones can include:

• Extreme heat dens

• Frozen regions

• Infected storms

• Heavy fog zones

• Snow and blizzard areas

• Rain and thunder zones

• Custom environmental profiles

Normal regional weather remains active outside these zones.

The system also includes configurable city-safe guards, smooth zone transitions, overlap protection, local weather persistence, and automatic normal-weather restoration when leaving a zone.

🖥️ INTERACTIVE WEATHER HUD

Players can access a clean, dockable, and customizable weather interface.

The HUD can display:

• Current weather

• Current region or custom city name

• Current time

• Active season

• Temperature

• Humidity

• Wind

• Wetness

• Forecast

• Active extreme events

• Player comfort and environmental conditions

HUD customization includes:

• Docked or interactive display

• Compact card layout

• Wide landscape layout

• Dragging and resizing

• Adjustable HUD scale

• Saved player positions

• Server-side position persistence

• Illustrated animated weather icons

• Custom weather icon support

• Configurable city branding

• 12-hour or 24-hour clock

The default player panel key is F5 and can be configured.

🛠️ ADMIN CONTROL PANEL

Authorized staff can control the entire weather system through the included admin panel.

Admin controls include:

• Set global weather

• Set regional weather

• Change the active season

• Set the server time

• Trigger or clear blackouts

• Trigger or clear extreme events

• Start weather votes

• Enable or disable weather synchronization

• Enable or disable time synchronization

The default admin panel key is F6 and can be configured.

All privileged admin actions are revalidated on the server using configurable ACE permissions.

🗳️ OPTIONAL PLAYER WEATHER VOTING

Allow players to vote for the next weather condition.

• Configurable vote duration

• Configurable weather candidates

• Optional automatic voting sessions

• Seasonal voting restrictions

• Player voting panel

• Admin-controlled vote sessions

🌍 OPTIONAL LIVE WEATHER

HEADKNOCKA-WEATHER can optionally use live Open-Meteo weather information.

• Configurable latitude and longitude

• Configurable refresh interval

• Optional live temperature control

• Can be enabled or disabled through configuration

🌑 BLACKOUT SYSTEM

Trigger server-wide blackouts that remain synchronized for every player.

• Server-authoritative blackout state

• Configurable startup flicker

• Persistent artificial-light control

• Optional vehicle-headlight support

• Admin panel, command, event, and export controls

🩺 HEADKNOCKA-DISEASES INTEGRATION

HEADKNOCKA-WEATHER is the native environmental provider for HEADKNOCKA-DISEASES.

The integration provides:

• Current weather

• Current season

• Current region

• Local outdoor environment

• Temperature

• Humidity

• Wetness

• Dryness

• Extreme heat and cold status

• Apocalypse-zone environmental values

• Server-authoritative player environment profiles

HEADKNOCKA-DISEASES can also display player comfort, sickness risk, environmental hazards, and survival-needs information directly inside the weather HUD.

No additional weather bridge configuration is required when using both resources together.

🔌 COMPATIBILITY AND DEVELOPER EXPORTS

HEADKNOCKA-WEATHER includes compatibility support for resources that previously used common weather-sync systems.

Compatibility support includes:

• qb-weathersync

• vSync

• cd_easytime

• Legacy weather events and exports

Client and server exports are included for:

• Reading current weather

• Reading regional weather

• Reading the active season

• Reading the forecast

• Reading the active extreme event

• Reading flood state

• Reading player environment profiles

• Setting weather and time

• Triggering blackouts

• Triggering extreme events

• Starting weather votes

• Connecting custom resources

🔓 OPEN SOURCE EDITION

This edition is designed for server owners and developers who require complete control over their weather system.

Open Source Edition benefits include:

• Fully editable resource files

• Editable client and server logic

• Editable configuration files

• Editable user interface

• Editable weather and season behavior

• Editable regional weather system

• Editable extreme events

• Editable apocalypse zones

• Editable environmental calculations

• Editable compatibility integrations

• Ability to create custom events and exports

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

Framework Support:

• Standalone

• Framework-independent

• Compatible with QBCore servers

• Compatible with ESX servers

• Compatible with Qbox servers

Required Dependencies:

• None

Optional Integrations:

• HEADKNOCKA-DISEASES

• Custom survival systems

• Custom medical resources

• Custom HUD resources

• Custom administration resources

📦 INCLUDED WITH YOUR PURCHASE

• Complete open-source weather system

• Fully editable client and server files

• Server-authoritative weather synchronization

• Advanced time synchronization

• Regional weather system

• Dynamic season system

• Weather forecast system

• Player weather voting

• Blackout system

• Extreme weather and natural disasters

• Physical tsunami and flood system

• Configurable apocalypse weather zones

• Interactive player weather HUD

• Administrative control panel

• Illustrated animated weather icons

• Compatibility events and exports

• HEADKNOCKA-DISEASES integration

• Configuration files

• Water definition files

• Integration documentation

📥 DELIVERY

After purchase, you will receive the complete editable HEADKNOCKA-WEATHER resource.

The download includes all source files, configuration files, user-interface files, water definitions, and integration documentation required to install and customize the system.

Take complete control of your server’s world.

Create regional climates, realistic seasons, powerful storms, destructive natural disasters, local apocalypse zones, and meaningful environmental gameplay with HEADKNOCKA-WEATHER Open Source Edition.