Scripts [ESCROW]

HEADKNOCKA Health & Illness System

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

Bring immersive medical roleplay and meaningful environmental consequences to your FiveM server.

The HEADKNOCKA Health & Illness System allows players to develop illnesses and health conditions based on the world around them. Extreme heat, freezing temperatures, storms, dehydration, water exposure, and other environmental hazards can all affect a player’s health.

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

Designed to work seamlessly with HEADKNOCKA-WEATHER, the system uses live server-authoritative weather, seasons, regions, and extreme events to calculate environmental exposure for every player.

Clothing, interiors, MLOs, housing shells, shade, water exposure, heat sources, and routing buckets are all considered. This means two nearby players can experience completely different health outcomes based on their surroundings.

🌦️ AN ENVIRONMENT THAT ACTUALLY MATTERS

Weather is no longer just visual.

Players who remain exposed to dangerous conditions can develop temporary or long-term illnesses based on their surroundings, protection, and exposure time.

Environmental risks include:

• 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.

🦠 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 health 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

• Freezing temperatures

• Rain and storms

• Dehydration

• Water exposure

• Other configured environmental hazards

Environmental protection can be affected by:

• Player clothing

• Interiors and housing shells

• Custom MLOs

• Routing buckets

• Shade and heat sources

• Water exposure

• Regional weather conditions

This creates dynamic situations where properly equipped players remain safe while unprepared players face serious health consequences.

📋 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

• 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.

⚙️ 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 health and illness system

• Environmental exposure system

• Interactive player health dashboard

• Medical staff and administrator tools

• Configurable illnesses and conditions

• Configurable treatment items

• Item images and inventory installation files

• Database installation files

• Configurable animations, props, and sounds

• Client and server integration exports

• Installation documentation

• Asset Escrow-ready resource

📥 DELIVERY

After purchase, the resource is delivered automatically through the FiveM Asset Escrow System.

Installation instructions, configuration files, item images, and all required setup files 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, and advanced medical roleplay to your server with the HEADKNOCKA Health & Illness System.

HEADKNOCKA-WEATHER — Asset Escrow Edition

Take complete control of your FiveM server’s weather, time, seasons, regional climates, and extreme environmental events.

HEADKNOCKA-WEATHER is a complete server-authoritative weather system designed to create a synchronized and immersive environment for every player.

Create independent regional climates, realistic seasons, severe storms, natural disasters, local apocalypse zones, synchronized blackouts, and meaningful environmental gameplay.

This Asset Escrow Edition protects the resource’s core runtime files while keeping important configuration, branding, interface, and integration files editable.

🌦️ SERVER-AUTHORITATIVE WEATHER SYSTEM

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

Late-joining players automatically receive the current weather, time, blackout, forecast, season, and extreme-event state.

• Automatic dynamic weather changes

• Smooth weather transitions

• Configurable weather probabilities

• Configurable transition durations

• Server-controlled synchronization

• Configurable weather blacklists

• Manual weather controls

• Per-weather wind speed and direction

• Rain and puddle handling

• Snow footprints and vehicle trails

• Reliable state restoration after extreme events

🗺️ REGIONAL WEATHER

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

Default weather regions include:

• Los Santos

• Sandy Shores

• Paleto Bay

• Blaine County

Regions can be renamed, repositioned, resized, removed, or expanded through the editable configuration.

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 behavior.

Included seasons:

• Spring

• Summer

• Autumn

• Winter

Available season modes:

• Real-world seasonal progression

• Automatic seasonal cycling

• Manual season control

Each season can use its own weather probabilities and player-voting restrictions.

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

🕒 ADVANCED TIME SYSTEM

Control the server clock using multiple configurable time modes.

• Scaled in-game time

• Real-world synchronized time

• Frozen time

• Configurable day length

• Smooth server-authoritative progression

• Manual time controls

• Configurable 12-hour or 24-hour display

🔮 WEATHER FORECAST

Players can view upcoming weather directly through the included weather HUD.

• Configurable forecast slots

• Forecasts automatically update

• Forecasts respond to weather changes

• Seasonal forecast behavior

• Clean illustrated weather icons

• Support for custom weather icon images

🌪️ EXTREME WEATHER AND NATURAL DISASTERS

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

Included extreme events:

• Earthquakes

• Severe storms

• Extreme cold

• Extreme heat

• Tsunamis

• Meteor showers

• Hurricanes

Extreme events can include:

• Earthquake camera shaking

• Pedestrian ragdoll effects

• Vehicle and object forces

• Hurricane wind and vehicle drift

• Falling meteor rocks

• Meteor explosions and fires

• Heat-haze visuals

• Freezing-weather effects

• Rising and draining flood water

• Server-wide warnings

• Configurable event durations

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 editable water-definition files

• Flood-state exports for custom integrations

☣️ CONFIGURABLE APOCALYPSE WEATHER ZONES

Create local environmental zones that operate independently from normal regional weather.

Apocalypse zones can include:

• Extreme heat zones

• 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 included zone system supports smooth transitions, priority handling, overlapping zones, local weather persistence, guard zones, and automatic normal-weather restoration.

🖥️ 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

• Upcoming forecast

• Active extreme events

• Player comfort and environmental conditions

HUD customization includes:

• Docked or interactive display

• Compact card layout

• Wide landscape layout

• Adjustable scale

• Draggable positioning

• Saved player positions

• Optional server-side position storage

• Configurable city branding

• Custom weather icons

• 12-hour or 24-hour clock

The HUD uses scale-aware dragging and corner-safe placement, helping it remain visible across different resolutions, layouts, and display scales.

The default player-panel key is F5 and can be changed through configuration.

🛠️ ADMIN CONTROL PANEL

Authorized staff can control the 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 player weather votes

• Enable or disable weather synchronization

• Enable or disable time synchronization

All privileged admin actions are validated by the server using configurable ACE permissions.

The default admin-panel key is F6 and can be changed through configuration.

🗳️ OPTIONAL PLAYER WEATHER VOTING

Allow players to vote for the next weather condition.

• Configurable voting duration

• Configurable weather candidates

• Optional automatic voting sessions

• Seasonal voting restrictions

• Player voting interface

• Admin-controlled voting sessions

🌍 OPTIONAL LIVE WEATHER

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

• No API key required

• Configurable latitude and longitude

• Configurable refresh interval

• Optional live temperature control

• Can be enabled or disabled through configuration

🌑 BLACKOUT SYSTEM

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

• Server-authoritative blackout state

• Configurable startup flicker

• Persistent artificial-light control

• Optional vehicle-headlight support

• Admin-panel controls

• Command controls

• 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

• Wind

• Extreme heat and cold status

• Apocalypse-zone environmental values

• Server-authoritative player environment profiles

HEADKNOCKA-DISEASES can display player comfort, sickness risk, environmental hazards, and survival 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 upcoming forecasts

• Reading active extreme events

• Reading flood state

• Reading player environment profiles

• Setting weather and time

• Triggering blackouts

• Triggering extreme events

• Starting weather votes

• Connecting custom resources

🔒 ASSET ESCROW EDITION

This edition is delivered using the FiveM Asset Escrow system.

Core runtime files are protected while important customer-editable files remain accessible.

Customer-editable files include:

• Main configuration file

• User-interface HTML

• User-interface styling

• User-interface JavaScript

• HUD branding and logo

• Integration documentation

• Installation documentation

• Water-definition files

• Runtime HUD-position storage

The editable configuration allows server owners to customize weather probabilities, regions, seasons, time behavior, extreme events, voting, live weather, permissions, HUD settings, apocalypse zones, and more.

The protected core helps prevent unauthorized copying, modification, redistribution, or leaking of the resource.

⚙️ 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

🚀 EASY INSTALLATION

Installation only requires adding the resource to your server and ensuring it inside your server configuration.

Recommended Start Order:

ensure HEADKNOCKA-WEATHER

When using HEADKNOCKA-DISEASES:

ensure ox_lib

ensure oxmysql

ensure HEADKNOCKA-WEATHER

ensure HEADKNOCKA-DISEASES

Only one weather-sync provider should be running at a time.

📦 INCLUDED WITH YOUR PURCHASE

• Complete Asset Escrow-protected weather system

• Customer-editable configuration

• Customer-editable HUD and branding

• Server-authoritative weather synchronization

• Advanced time synchronization

• Regional weather system

• Dynamic season system

• Weather forecast system

• Optional player weather voting

• Server-wide blackout system

• Extreme weather and natural disasters

• Physical tsunami and flood system

• Configurable apocalypse weather zones

• Interactive player weather HUD

• Administrative control panel

• Illustrated weather icons

• Compatibility events and exports

• HEADKNOCKA-DISEASES integration

• Editable water-definition files

• Installation and integration documentation

📥 DELIVERY

After purchase, the resource is delivered automatically through the FiveM Asset Escrow system.

The download includes the protected runtime resource, editable configuration files, editable user-interface files, branding assets, water definitions, and installation documentation.

Take complete control of your server’s world.

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