b_Whippet

A dynamic and fully configurable script for FiveM allowing players to inhale N2O from balloons. Includes a custom UI minigame to fill up empty balloons with N2O canisters. 

video

Features

Auto-Detection Framework: Seamlessly works across `es_extended`, `qb-core`, `qbx_core` and `ox_core` without any required setup.

Inventory Integration: Fully integrates with `ox_inventory`, `qb-inventory` and default `esx` inventory for full control of canisters and balloon durability.

Visuals & Effects: Visual blurring and screen shaking representing the effects. Players hold a custom prop balloon and animate correctly.

Requirements

- ox_lib (Required for locales and certain cross-compatibility elements)

- Supported Framework (ESX, QBCore, ox_core)

- Supported Inventory (ox_inventory, qb-inventory, esx default)

Installation

1. Drop the `b_Whippet` folder into your resources directory.

2. Ensure you have the `ox_lib` dependency started before the script.

3. Edit the `config.lua` and adjust your preferred settings. By default, the script automatically detects your active framework, inventory, and notification systems.

4. Add the items into your server's items configuration. The default item names are:

    - `n2o_canister`

    - `empty_balloon`

    - `filled_balloon`

5. Add `ensure b_Whippet` to your `server.cfg`.

Configuration

The `config.lua` allows you to customize:

- Locale Language (`pl` / `en`)

- Target Frameworks (`auto` / `ox` / `qb` / `esx`)

- Configurable Keys

- Durability reduction logic

Locales

To add custom translations, duplicate one of the `.json` files inside the `locales/` directory, translate the variables, and adjust `Config.Locale` in the configuration file.