> For the complete documentation index, see [llms.txt](https://documentation.madonnestudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.madonnestudio.com/paid-scripts/madonne-seasons.md).

# Madonne Seasons

Change the way weather and time are handled on your FiveM server. **Madonne Seasons** brings a fully dynamic, realistic, and configurable weather and time system — with seasonal cycles, per-zone weather, AI-powered forecasts, and much more.

{% embed url="<https://www.youtube.com/watch?v=geiYTJQoLEo>" %}

***

## 📖 About Madonne Seasons

Madonne Seasons replaces GTA V's default static weather system with a living, breathing environment. Weather evolves dynamically over time, follows realistic transition rules, and varies by geographic zone across the map. Days are longer in summer, shorter in winter, and the sun rises and sets accordingly.

## ✨ Main Features

* 🗓️ **Seasonal Cycle** — Four seasons (Spring, Summer, Autumn, Winter) with configurable real-time duration (days, weeks, months)
* 🌍 **Per-Zone Weather** — The map is divided into 7+ geographic zones, each with its own weather probabilities per season
* ⏱️ **Realistic Time System** — Day/night cycle with variable speed: days are longer or shorter depending on the current season
* ☀️ **Dynamic Sunrise & Sunset** — Sunrise and sunset hours shift throughout the year based on seasonal progression
* 🌤️ **Dynamic Weather Transitions** — Weather changes follow realistic transition rules (e.g. RAIN → THUNDER → CLEARING)
* 📻 **Weather Forecast System** — Players can request tomorrow's weather forecast via a command, delivered as an audio broadcast
* 🤖 **AI-Powered Forecasts** — Optional OpenAI integration generates unique, voiced weather bulletins in any language using GPT-4o-mini and TTS
* 🔐 **Flexible Permission System** — Supports ACE, Steam, MadonnAdmin, or a fully custom permission handler
* 🔔 **Notification System** — Compatible with `default`, `chat`, `MS_Madonne_Notify`, or a custom handler
* 📱 **LB Phone Compatibility** — Native integration with the LB Phone weather app for consistent time, temperature, forecasts, precipitation, and sun times
* 🧩 **Developer Exports** — `GetZonePredictions` and `GetSunTimes` exports for integration with other resources

***

## 🔗 Quick Links

* [📥 Installation](/paid-scripts/madonne-seasons/installation.md)
* [⚙️ Configuration](/paid-scripts/madonne-seasons/configuration.md)
* [💻 Commands](/paid-scripts/madonne-seasons/commands.md)
* [🧩 Exports & Events](/paid-scripts/madonne-seasons/exports-and-events.md)
* [📱 Compatibility](/paid-scripts/madonne-seasons/compatibility.md)
* [❓ Common Errors](/paid-scripts/madonne-seasons/common-errors.md)