Page cover

🧨Flashbang

A fully featured, standalone flashbang system for FiveM with realistic effects, AI interaction, and 3D audio support.

🚀 Features

  • 💥 Custom addon flashbang weapon with 0-damage frag explosion

  • 💥 Single flashbang or multi-banger (9-banger) support

  • 👁️ Configurable masks dampen the effects (like gas masks or sunglasses)

  • 🎧 Full 3D positional audio using native GTA explosions

  • 👁️ LOS and directional detection — players only get blinded if they see the detonation

  • 🧠 Realistic flash effects: whiteout, blurred vision, drunk movement, and ear ringing

  • 🧍‍♂️ NPCs react with panic, ragdoll, and flee behavior

  • 🎮 Easy-to-use exports for full integration with other scripts

  • ⚙️ Fully configurable via config.lua

  • 📦 Flashbang 3D model and custom add-on weapon included


🧱 Installation

Follow instructions in Getting Started

circle-exclamation

🎯 How It Works

  • Players throw the flashbang (addon weapon).

  • After a realistic cook time (configurable), the grenade explodes with a visual and audio effect.

  • Nearby players are:

    • Fully flashed if they were looking at it and had line of sight.

    • Partially disoriented if they were nearby but not looking directly.

    • Unaffected if behind solid cover.

  • NPCs are stunned or flee if within range and have line of sight.


📤 Exports

Client Exports

Export
Description

Applies flash effect on the local player

Returns true if the player is currently flashed

Triggers a flashbang effect manually

Returns the current flashbang config table


⚙️ Configuration


🔊 Custom Audio

To use custom audio for the flashbang, find your chosen .mp3 file and replace flashbang.mp3 within the html/ folder

Last updated