https://github.com/blnstudio/bln_grenade

A dynamic throwable items script for RedM, featuring customizable explosive devices with unique effects and behaviors.
https://github.com/blnstudio/bln_grenade

qbcore redemrp redm rsg vorp

Last synced: 4 months ago
JSON representation

A dynamic throwable items script for RedM, featuring customizable explosive devices with unique effects and behaviors.

• Host: GitHub
• URL: https://github.com/blnstudio/bln_grenade
• Owner: blnStudio
• License: agpl-3.0
• Created: 2024-12-11T18:49:31.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-01-07T14:59:10.000Z (over 1 year ago)
• Last Synced: 2025-03-29T06:11:14.623Z (over 1 year ago)
• Topics: qbcore, redemrp, redm, rsg, vorp
• Language: Lua
• Homepage: https://github.com/blnStudio/bln_grenade
• Size: 1.23 MB
• Stars: 1
• Watchers: 1
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# 🧨 BLN Grenade - RedM



A dynamic throwable items script for RedM, featuring customizable explosive devices with unique effects and behaviors.

[![](https://img.shields.io/badge/YouTube-FF0000?style=flat&logo=youtube&logoColor=white)](https://youtu.be/OqH8r0MoXu4)

[![Discord](https://img.shields.io/badge/Discord-1111?style=flat&logo=discord&logoColor=white&color=7289da)](https://discord.bln-studio.com/)

![GitHub release (latest by date)](https://img.shields.io/github/v/release/blnStudio/bln_grenade)

![License](https://img.shields.io/github/license/blnStudio/bln_grenade)

## Features

- 🎯 Realistic throwing mechanics

- 💥 Multiple throwable types with unique explosion effects

- ⏱️ Customizable fuse timers per grenade type

- 📊 Visual grenade count and timer display

- 🔄 Synchronized explosions across all players

- ⚙️ Framework detection (VORP, RedEM, RedEM2023, QBR, RSG, QR)

- 🎮 Smooth animations and controls

- 🔥 Clean code, Well optimized

## Works with

**✅ VORP ✅ REDEMRP(old/2023) ✅ RSG ✅QBR & QR**

## Installation

1. Download the script

2. Place it in your resources folder

3. Add `ensure bln_grenade` to your server.cfg

4. Configure your grenade types in `config.lua`

## Usage & Controls

- Use inventory item.

- Right Mouse Button - Aim

- Left Mouse Button - Throw

## Creating Custom Grenades

Add new grenade types in config.lua:

```lua

["grenade_type_name"] = {

    model = `your_model`,

    item = "your_item_name",

    fuseTime = your_time,

    maxCount = your_max_count,

    explode = function(coords)

        -- Your custom explosion effect

    end

}

```

## Support 💬

Need help? or more resources? Join our Discord server:

[Join Discord](https://discord.com/invite/MEZRYQVpnt)

## Credits 🙏

- Created by [BLN Studio](https://bln.tebex.io)

- Thanks to Kibook for the throwing mechanics

Feel free to contribute to this project!