> 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/installation.md).

# Installation

## 📋 Requirements

* A **FiveM server** running on artifact `2699` or above
* *(Optional)* `MS_Madonne_Notify` for enhanced notifications
* *(Optional)* An **OpenAI API key** if using AI-powered forecast generation
* *(Optional)* `lb-phone` if using the LB Phone weather app integration

***

## ⬇️ Step 1 — Download the resource

Download the latest version of **MS\_Madonne\_Seasons** from the [CFX Portal](https://portal.cfx.re/), the official Cfx.re platform for downloading your purchased resources.

> 💡 You must be logged in with the account used to purchase the resource.

***

## 📁 Step 2 — Add to your server

Copy the `MS_Madonne_Seasons` folder into your server's **resources directory**.

```
your-server/
└── resources/
    └── MS_Madonne_Seasons/
        ├── client/
        ├── server/
        │   └── custom/
        ├── ui/
        ├── config.lua
        └── fxmanifest.lua
```

***

## 📝 Step 3 — Add to server.cfg

Add the following line to your `server.cfg`:

```cfg
ensure MS_Madonne_Seasons
```

If you plan to use **AI-powered forecasts**, also add your OpenAI API key:

```cfg
set openai_key "sk-your-openai-api-key-here"
```

> ⚠️ Make sure `MS_Madonne_Seasons` is started **after** any notification resource it depends on (`MS_Madonne_Notify`, etc.).

***

## ⚙️ Step 4 — Configure the resource

Open `config.lua` and configure the resource to match your server setup.

Refer to the [⚙️ Configuration](/paid-scripts/madonne-seasons/configuration.md) page for a full breakdown of every option.

***

## 🔄 Step 5 — Restart your server

Restart your server or run the following command in the console:

```
restart MS_Madonne_Seasons
```

Madonne Seasons is now active! ✅

***

## 📱 Step 6 — LB Phone integration *(optional)*

If you use **lb-phone** and want the weather app to reflect Madonne Seasons data, refer to the [📱 Compatibility](/paid-scripts/madonne-seasons/compatibility.md) page for the two files to edit.