Frostbite System is a fully dynamic cold exposure and survival system for RP servers. It reacts realistically to the player’s environment, clothing, vehicles, fire sources, and indoor areas. Perfect for snowy or winter-themed gameplay, it encourages players to find warmth, shelter, or proper clothing to survive.
✨ New in 1.1.0: Rain support, weather type detection, configurable thresholds, and external HUD integration added.
✨ New in 1.2.0: Freezing screen effect, configurable HUD position/size.
✨ New in 1.3.0: Added configurable cold meter direction ("up" or "down") – choose whether the HUD bar increases or decreases when the player gets colder.

🎬 PREVIEW
🎬 PREVIEW (NEW freezing screen visual effect)

🔑 Key Features:

❄ Weather-Driven Cold System

The cold mechanics only activate when real snow is detected in the game world.
Cold drains exclusively during snowy weather, making the system fully dynamic and tied to your server’s weather script.
If there is no snow, players stay warm and the system remains inactive.

🌡 Environmental Cold Simulation

• Cold decreases when players are outside in snowy conditions.
• Cold increases automatically near heat sources, inside vehicles, or inside configured hotspots.
• Health drains automatically if cold reaches 0.

🔥 Heat Sources

All fire-related props and effects provide warmth within a configurable radius:
• Stoves, fireplaces, campfires
• Gas or propane fires
• Burning vehicles (cars, trucks, helicopters, etc.)

🧥 Clothing & Protection

• Configurable jacket/top IDs that provide full protection
• Proper clothing prevents cold drain
• Heat sources can restore cold when wearing warm clothing
• Players without winter clothing gradually freeze and must find shelter

🏠 Hotspots & Interiors

• Custom safe zones (hotspots) where cold does not decrease
• All enclosed interiors automatically protect players
• Vehicles (except motorcycles/bikes/boats) block cold exposure

📊 Cold Meter HUD

• Displays the player’s current cold level
• Only visible when the player is actually cold
• Hidden when fully warmed
• Admins never see the HUD

🥶 Optional Freezing Animations

• Shivering / coughing animations when cold is critically low
• Disabled during aiming/shooting
• Admins are immune

🎭 RP Opportunities

Ideal for winter roleplay scenarios:
• Survival events
• Kidnapping / punishment situations
• Snow missions & themed events
• Cold-weather realism for immersion

⚙ Framework Compatibility

• Full ESX & QBCore support
• Automatic admin detection included

Update v1.1.0

• Added configurable SnowLevel and RainLevel thresholds – cold activation can now be fine-tuned directly from config.lua.
• Added weather type detection – frost system reacts to specific weather types (XMAS, BLIZZARD, SNOW, SNOWLIGHT, THUNDER, etc.).
• External HUD integration support added – built-in cold bar can be disabled.
• Cold data is now accessible via exports for custom HUDs:
local cold = exports["azakit_frostbitesystem"]:GetCold()
• Introduced HUDMode config option (internal / external) to switch between built-in or external HUD display.
• Improved overall stability, internal logic, and minor optimizations.

 Update v1.2.0

• Added immersive freezing screen visual effect – intensifies with cold level; can be enabled or disabled via Config.EnableFreezeEffect.
• Built-in cold HUD position, size, and text offset are now fully configurable via Config.HUD.
• Fixed female freemode clothing detection bug – male and female characters are now checked correctly.

📦 Requirements:

• ESX or QBCore

🛠️ Configuration Guide:
All configuration options and setup instructions can be found here:
👉 azakit-development.gitbook.io/docs

HELP:
You can find Discord: https://discord.gg/DmsF6DbCJ9