Smokescreen

Overview

This resource allows you to deploy a smokescreen in FiveM. Freely configure all kinds of options in regards to the smokescreen. Whether you want players to deploy a smokescreen on foot by using an item or just in a vehicle. It’s all configurable. You can even configure specific vehicles which can deploy a smokescreen. In-game players have the option to adjust the size of their smoke screen clusters and the colour of their smokescreen.

The smokescreen resource allows players to place 1 smokescreen per 800 GTA meters radius.

Key Features

• Deployable Smokescreen - Deploy smokescreens in FiveM
• Configurable Deployment - On foot or in vehicles
• Vehicle-Specific Configuration - Configure specific vehicles for smokescreen deployment
• Adjustable Size & Color - Players can adjust cluster size and color in-game
• Configurable Default Sizes - Set default smokescreen sizes
• Size Limits - Configure size limitations
• Cluster Configuration - Configure cluster amounts and distance between clusters
• Duration Control - Configure smokescreen duration
• Inventory Item Usage - Framework integration for item-based usage
• Command Usage - Configure custom commands
• Framework Compatibility - ESX/QB/NS Discord API/Ace Perms/Standalone compatible
• OneSync Compatible - Works with OneSync legacy/infinity
• Language Support - Multi-language configuration
• Escrow Protection - Secure resource protection

Installation Tutorial

Watch the installation tutorial:

Installation Tutorial

Important Pre-Installation Notes

Critical Installation Order

Always follow this exact sequence to avoid parsing errors in the F8 console:

1. Download ZIP Package from CFX Portal
2. Unpack in a folder on your local machine
3. Set your File Transfer Protocol (FTP) type to binary
4. Drag files from local machine to server resources folder
5. Add to server.cfg (ensure script)
6. Boot up the server

Support Policy

Follow this guide step by step. If you’re stuck, ask for support in our Discord and provide the specific step name. Do not skip steps.

Placement Limit

Players can place 1 smokescreen per 800 GTA meters radius.

System Requirements & Compatibility

Framework Compatibility

• Standalone: Works independently without any framework
• ESX: Compatible with ESX framework
• QBCore: Compatible with QBCore framework
• Discord API: Compatible with NS Discord API
• Ace Permissions: Compatible with Ace permission system

OneSync Compatibility

• OneSync Legacy: Fully tested and compatible
• OneSync Infinity: Fully tested and compatible

Note

Smokescreen is designed to work with any FiveM server configuration and provides flexible deployment options.

Installation Process

Step 1: Download Resource

Download this resource via CFX Portal Assets after purchasing.

Step 2: Install Resource

1. Extract the ZIP package to your local machine
2. Transfer files using binary FTP mode to your server’s resources folder
3. Ensure the folder is named night_smokescreen (do not rename)

Step 3: Server Configuration

Add the resource to your server.cfg:

ensure night_smokescreen

Step 4: Configure Settings

1. Open /config/config.lua in your preferred editor
2. Configure all settings to your liking
3. Test the resource functionality

Configuration Setup

Required Tools

Visual Studio Code

We recommend downloading VS Code for editing Lua files.

Configuration Files

File	Purpose
night_smokescreen/config/config.lua	Main configuration settings
night_smokescreen/client/c_functions.lua	Client-side functions
night_smokescreen/server/s_functions.lua	Server-side functions

Configuration Process

1. Open VS Code and navigate to the config files
2. Read thoroughly - each line has explanatory comments
3. Configure settings - customize deployment, sizes, clusters, and permissions
4. Test frequently - use F8 console for error checking

Configuration Options

Configure deployment methods, sizes, clusters, duration, inventory items, and commands.

How It Works

Smokescreen Deployment

• On Foot Deployment - Deploy smokescreens while walking
• Vehicle Deployment - Deploy smokescreens from vehicles
• Vehicle-Specific Configuration - Configure specific vehicles for deployment
• Placement Limits - 1 smokescreen per 800 GTA meters radius

Customization Options

• Size Configuration - Configure default sizes and size limits
• Cluster Management - Configure cluster amounts and distance between clusters
• Duration Control - Set how long smokescreens last
• Color & Size Adjustment - Players can adjust in-game

Framework Integration

• Inventory Item Usage - Framework integration for item-based deployment
• Command Configuration - Customize commands for deployment
• Permission Systems - Discord API and Ace permissions support
• Multi-Language Support - International server configuration

User Experience

• Flexible Deployment - Deploy on foot or in vehicles
• Real-Time Adjustment - Adjust size and color in-game
• Easy Activation - Simple commands or item usage
• Visual Feedback - Clear smokescreen effects

Integration & Compatibility

Framework Support

• Standalone - Works independently without framework dependencies
• ESX - Compatible with ESX framework integration
• QBCore - Compatible with QBCore framework integration
• Discord API - Compatible with NS Discord API
• Ace Permissions - Compatible with Ace permission system

Deployment Options

• On Foot Deployment - Deploy smokescreens while walking
• Vehicle Deployment - Deploy from any vehicle
• Vehicle-Specific - Configure specific vehicles for deployment
• Item-Based Usage - Framework inventory integration

Server Integration

• Universal Compatibility - Works with any FiveM server setup
• Performance Optimized - Efficient smokescreen management
• Easy Integration - Simple setup and configuration

Placement System

Smokescreens are limited to 1 per 800 GTA meters radius for optimal performance.

Troubleshooting

Common Issues

Resource Not Starting

• Ensure the resource is properly added to server.cfg
• Check that the resource name is night_smokescreen
• Verify the resource started without errors in console

Smokescreen Not Deploying

• Check F8 console for any error messages
• Verify configuration settings in config.lua
• Test with default settings first

Placement Issues

• Check if you’re within 800 GTA meters of another smokescreen
• Verify deployment permissions and vehicle configuration
• Ensure proper item usage if using framework integration

Debugging Tips

• Check F8 Console - Look for any error messages
• Test Deployment Methods - Try both on foot and vehicle deployment
• Verify Configuration - Check all config settings are correct
• Check Framework Integration - Ensure proper item/command setup

Best Practices

Smokescreen Configuration

• Size Management - Configure appropriate default sizes and limits
• Cluster Settings - Set reasonable cluster amounts and distances
• Duration Control - Configure appropriate smokescreen duration
• Placement Limits - Respect the 800 GTA meters radius limit

Performance Optimization

• Placement Limits - Monitor smokescreen placement for performance
• Cluster Optimization - Configure clusters for optimal performance
• Duration Management - Set appropriate durations to prevent clutter
• Regular Cleanup - Monitor and manage smokescreen placement

User Experience

• Clear Instructions - Provide users with deployment guidelines
• Intuitive Controls - Make deployment commands easy to use
• Visual Feedback - Ensure smokescreen effects are clearly visible
• Help Documentation - Create server-specific usage guides

Support

Read through the instructions again if you have not managed to install the resource. Can’t get it to work still? Create a ticket through our dedicated support system in Discord:

Nights Software Discord