Smell visualization

A FiveM resource that visualizes smells through particle effects in-game.

Create immersive environmental effects with visible particle trails that decay over time, featuring multiplayer synchronization and framework integration.

Features

  • Visual Particle Trails - Creates visible particle effects that follow players and objects

  • Three Smell Sources - Items being carried, props/objects in motion, and events (shooting, damage)

  • Time-Based Decay - Trails automatically expire based on configurable TTL values

  • Multiplayer Sync - State bag synchronization shows other players' smell trails

  • Distance-Based Culling - Optimized performance with viewDistance-based rendering

  • Nighttime Enhancement - Automatic alpha boost during night hours (8pm-6am)

  • Smell Mode Command - /smellmode command for temporary enhanced visibility with 3D labels

  • Framework Compatible - Supports ox, esx, qb, origen, ps, ak47 inventory frameworks

  • Preset System - Reusable particle definitions for consistent effects

  • Custom Events - Extensible event system for gamemode-specific smell triggers

Framework Compatibility

  • ox_inventory

  • ESX

  • QBCore

  • Origen

  • Project Sloth

  • AK47 Inventory

  • Missing your framework? Reach out to us on our discordarrow-up-right

Installation

1

Download & Install

Download the resource and extract to your resources folder.

2

Enable Resource

Add the following to your server.cfg:

3

Configure Inventory Framework

Open config.lua and set your inventory framework.

4

Integrate Item Detection

Edit Config.inventory to match your server's framework.

5

Restart Server

Restart your server to load the resource.

Quick Start

1

Basic Configuration

Set your inventory framework in config.lua:

2

Adding Smelly Items

Configure items that emit trails when carried:

3

Adding Smelly Props

Configure objects/props that emit smell:

4

Framework Integration Example

Edit client/item_detector.lua and implement the IsPlayerCarryingItem() function for your framework:

See the client/editables/ folder for framework-specific examples.

In-Game Commands

  • /smellmode - Activates enhanced smell visibility mode with 3D labels above smelly props

Performance

  • Distance-based particle rendering (only within viewDistance)

  • Automatic trail expiration based on TTL

  • Props checked only within 50 units of player

  • State bags only updated when player has active trails

  • Optimized distance calculations using squared distance

Support

circle-info

For support and updates, visit Lith Studios Discordarrow-up-right

Last updated