# Madonne Seatbelt

Protect yourself from road accidents by fastening your seat belt! **Madonne Seatbelt** adds a realistic and fully configurable seatbelt system to your FiveM server, with ejection physics, sound effects, visual warnings, and developer hooks.

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

***

## 📖 About Madonne Seatbelt

Madonne Seatbelt simulates real-world seatbelt mechanics in GTA V. Players can fasten and unfasten their seatbelt with a configurable key. If they are involved in a high-speed collision without their seatbelt on, they will be **physically ejected from the vehicle**.

A **visual warning icon** blinks on-screen when the player is in a moving vehicle without a seatbelt, and an **alarm sound** can be configured to play after a set interval.

***

## ✨ Main Features

* 🪢 **Realistic Ejection System** — Players are expelled from their vehicle on sharp deceleration if unbuckled, with configurable sensitivity and velocity multiplier
* 🖼️ **Visual Warning Indicator** — An animated blinking seatbelt icon appears on screen when the player is unbuckled
* 🔔 **Alarm Sound** — A looping alert plays when the player drives above a configurable speed without their seatbelt
* 🔊 **Buckle / Unbuckle Sounds** — Realistic audio feedback when toggling the seatbelt
* ⌨️ **Configurable Key Binding** — Default key is `K`, fully remappable by players in their FiveM settings
* 🚗 **Vehicle & Class Exclusions** — Disable seatbelts for specific vehicle models or entire vehicle classes (bikes, boats, helicopters…)
* 💺 **Per-Seat Whitelisting** — Prevent ejection from specific seats in specific vehicles (e.g. police car passenger seats)
* 🔔 **Notification System** — Compatible with `default`, `MS_Madonne_Notify`, `okokNotify`, or a fully custom handler
* 🧩 **Developer Exports** — `GetSeatbeltStatus` and `SetSeatbeltStatus` exports for integration with other resources
* 🪝 **Custom Hooks** — `FastenedSeatbelt()` and `UnfastenedSeatbelt()` functions in `custom/main.lua` for your own logic

***

## 🔗 Quick Links

* [📥 Installation](/free-scripts/madonne-seatbelt/installation.md)
* [⚙️ Configuration](/free-scripts/madonne-seatbelt/configuration.md)
* [🧩 Exports & Events](/free-scripts/madonne-seatbelt/exports-and-events.md)
* [❓ Common Errors](/free-scripts/madonne-seatbelt/common-errors.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.madonnestudio.com/free-scripts/madonne-seatbelt.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
