🚗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.

---

📖 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

• ⚙️ Configuration

• 🧩 Exports & Events

• ❓ Common Errors