> 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/free-scripts/madonne-seatbelt.md).

# 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)