🔧Envi-Sabotage

Envi-Sabotage Official Documentation

Preview

Prerequisites

• A working FiveM Server

• Basic understanding of FiveM server setup and resource management

• An up-to-date version of ox_lib

Config Preview

10KB

config.lua

Introduction

Have you ever found yourself at odds with your so-called friends? Friends who've crossed the line and left you feeling like it's time for some sweet payback? Well, we've got just the game for you! Envi-Sabotage is your chance to take matters into your own hands, quite literally. With an arsenal of unique tools, each with a specific purpose, you can now give your rivals a taste of their own medicine by messing with their prized cars. Let's delve into the thrilling world of Envi-Sabotage.

Prerequisites

• ESX or QBcore framework.

• ox_lib / Oxmysql - if applicable.

• Supports ox_target, qtarget, qb-target.

Config Preview

17KB

config.lua

1. Exports

These are exports for integrating with other scripts. Envi-Sabotage has its own built-in repair options via Target options for Mechanics, alternatively, you can use these exports elsewhere.

Repair ALL Export:

This export will completely repair the vehicle and will do no animation - perfect for integrating into Mechanic Scripts An easy way to do this is to replace;

exports['envi-sabotage-v2']:sawAnimation()
exports['envi-sabotage-v2']:impactDriverAnimation()
exports['envi-sabotage-v2']:isHoldingSaw()
exports['envi-sabotage-v2']:isHoldingDrill()
exports['envi-sabotage-v2']:isHoldingImpactDriver()
exports['envi-sabotage-v2']:isHoldingPliers()
exports['envi-sabotage-v2']:isHoldingSpanner()
exports['envi-sabotage-v2']:isHoldingAdjustableSpanner()
exports['envi-sabotage-v2']:isHoldingScrewdriver() 
exports['envi-sabotage-v2']:isHoldingScrewdriver() 

Repair exports
exports['envi-sabotage-v2']:RepairAll(vehicle)
exports['envi-sabotage-v2']:FixWheelNuts()
exports['envi-sabotage-v2']:FixAcceleration()
exports['envi-sabotage-v2']:FixElectrics()
exports['envi-sabotage-v2']:FixBrakes()
exports['envi-sabotage-v2']:FixGasTank()

These can be used in other scripts to check tool status or trigger animations.

Replace

SetVehicleFixed(vehicle)

with

exports['envi-sabotage-v2']:RepairAll(vehicle)

in your mechanic script

2. Debug Mode

Config.Debug = true

Enable debug mode for additional logging and testing functionality.

3. Inventory Setup

OX

['impact_driver '] = {        
    label = 'Impact Driver',        
    weight = 1000,         
    stack = false,        
    close = true,        
    description = 'Impact Driver',    
},
['spanner'] = {        
    label = 'Spanner',        
    weight = 1000,         
    stack = false,        
    close = true,        
    description = 'Spanner',    
},      
['pliers '] = {        
    label = 'Pliers',        
    weight = 1000,         
    stack = false,        
    close = true,        
    description = 'Pliers',    
},          
['adjustable_spanner'] = {        
    label = 'Adjustable Spanner',        
    weight = 1000,         
    stack = false,        
    close = true,        
    description = 'Adjustable Spanner',    
},    
['drill'] = {        
    label = 'Drill',        
    weight = 1000,         
    stack = false,        
    close = true,        
    description = 'Drill',    
},
['buzz_saw'] = {        
    label = 'Buzz Saw',        
    weight = 1000,         
    stack = false,        
    close = true,        
    description = 'Buzz Saw',    
},
['screwdriver'] = {        
    label = 'Screwdriver',        
    weight = 1000,         
    stack = false,        
    close = true,        
    description = 'Screwdriver',    
},
['ignition_bomb'] = {        
    label = 'Ignition Bomb',        
    weight = 1000,         
    stack = false,        
    close = true,        
    description = 'Ignition Bomb',    
},
['impact_bomb'] = {        
    label = 'Impact Bomb',        
    weight = 1000,         
    stack = false,        
    close = true,        
    description = 'Impact Bomb',    
},
['remote_bomb'] = {        
    label = 'Remote Bomb',        
    weight = 1000,         
    stack = false,        
    close = true,        
    description = 'Remote Bomb',    
},
['speed_bomb'] = {        
    label = 'Speed Bomb',        
    weight = 1000,         
    stack = false,        
    close = true,        
    description = 'Speed Bomb',    
},
['firelighter'] = {        
    label = 'Firelighter',        
    weight = 1000,         
    stack = false,        
    close = true,        
    description = 'Firelighter',    
},

QB-Old

['impact_driver'] 		    = {['name'] = 'impact_driver',		['label'] = 'Impact Driver',		['weight'] = 1000,			['type'] = 'item',		['image'] = 'impact_driver.png',		['unique'] = true,		['useable'] = true,		['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = ''},
['spanner'] 			    = {['name'] = 'spanner',			['label'] = 'Spanner',		        ['weight'] = 1000,			['type'] = 'item',		['image'] = 'spanner.png',			['unique'] = true,		['useable'] = true,		['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = ''},
['pliers'] 		            = {['name'] = 'pliers',		        ['label'] = 'Pliers',		        ['weight'] = 1000,			['type'] = 'item',		['image'] = 'pliers.png',			['unique'] = true,		['useable'] = true,		['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = ''},
['adjustable_spanner'] 		    = {['name'] = 'adjustable_spanner',		['label'] = 'Adjustable Spanner',	['weight'] = 1000,			['type'] = 'item',		['image'] = 'adjustable_spanner.png',	        ['unique'] = true,		['useable'] = true,		['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = ''},
['drill'] 		            = {['name'] = 'drill',		        ['label'] = 'Drill',		        ['weight'] = 1000,			['type'] = 'item',		['image'] = 'drill.png',			['unique'] = true,		['useable'] = true,		['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = ''},
['buzz_saw'] 			    = {['name'] = 'buzz_saw',			['label'] = 'Buzz Saw',		        ['weight'] = 1000,			['type'] = 'item',		['image'] = 'buzz_saw.png',			['unique'] = true,		['useable'] = true,		['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = ''},
['screwdriver'] 		    = {['name'] = 'screwdriver',		['label'] = 'Screwdriver',		['weight'] = 1000,			['type'] = 'item',		['image'] = 'screwdriver.png',			['unique'] = true,		['useable'] = true,		['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = ''},
['ignition_bomb'] 		    = {['name'] = 'ignition_bomb',		['label'] = 'Ignition Bomb',		['weight'] = 1000,			['type'] = 'item',		['image'] = 'ignition_bomb.png',		['unique'] = true,		['useable'] = true,		['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = ''},
['impact_bomb'] 		    = {['name'] = 'impact_bomb',		['label'] = 'Impact Bomb',		['weight'] = 1000,			['type'] = 'item',		['image'] = 'impact_bomb.png',			['unique'] = true,		['useable'] = true,		['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = ''},
['remote_bomb'] 		    = {['name'] = 'remote_bomb',		['label'] = 'Remote Bomb',		['weight'] = 1000,			['type'] = 'item',		['image'] = 'remote_bomb.png',			['unique'] = true,		['useable'] = true,		['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = ''},
['speed_bomb'] 			    = {['name'] = 'speed_bomb',			['label'] = 'Speed Bomb',		['weight'] = 1000,			['type'] = 'item',		['image'] = 'speed_bomb.png',			['unique'] = true,		['useable'] = true,		['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = ''},
['firelighter'] 		    = {['name'] = 'firelighter',		['label'] = 'Firelighter',		['weight'] = 1000,			['type'] = 'item',		['image'] = 'firelighter.png',			['unique'] = true,		['useable'] = true,		['shouldClose'] = true,	   ['combinable'] = nil,   ['description'] = ''},

QB-New

impact_driver 			= {name = 'impact_driver',		label = 'Impact Driver',		weight = 1000,			type = 'item',		image = 'impact_driver.png',		        unique = true,		useable = true,		shouldClose = true,	   combinable = nil,   description = ''},
spanner 			= {name = 'spanner',			label = 'Spanner',		        weight = 1000,			type = 'item',		image = 'spanner.png',				unique = true,		useable = true,		shouldClose = true,	   combinable = nil,   description = ''},
pliers 		                = {name = 'pliers',		        label = 'Pliers',		        weight = 1000,			type = 'item',		image = 'pliers.png',				unique = true,		useable = true,		shouldClose = true,	   combinable = nil,   description = ''},
adjustable_spanner 		= {name = 'adjustable_spanner',		label = 'Adjustable Spanner',	        weight = 1000,			type = 'item',		image = 'adjustable_spanner.png',	        unique = true,		useable = true,		shouldClose = true,	   combinable = nil,   description = ''},
drill 		                = {name = 'drill',		        label = 'Drill',		        weight = 1000,			type = 'item',		image = 'drill.png',				unique = true,		useable = true,		shouldClose = true,	   combinable = nil,   description = ''},
buzz_saw 			= {name = 'buzz_saw',			label = 'Buzz Saw',		        weight = 1000,			type = 'item',		image = 'buzz_saw.png',				unique = true,		useable = true,		shouldClose = true,	   combinable = nil,   description = ''},
screwdriver 			= {name = 'screwdriver',		label = 'Screwdriver',			weight = 1000,			type = 'item',		image = 'screwdriver.png',			unique = true,		useable = true,		shouldClose = true,	   combinable = nil,   description = ''},
ignition_bomb 			= {name = 'ignition_bomb',		label = 'Ignition Bomb',		weight = 1000,			type = 'item',		image = 'ignition_bomb.png',		        unique = true,		useable = true,		shouldClose = true,	   combinable = nil,   description = ''},
impact_bomb 			= {name = 'impact_bomb',		label = 'Impact Bomb',		        weight = 1000,			type = 'item',		image = 'impact_bomb.png',			unique = true,		useable = true,		shouldClose = true,	   combinable = nil,   description = ''},
remote_bomb 			= {name = 'remote_bomb',		label = 'Remote Bomb',		        weight = 1000,			type = 'item',		image = 'remote_bomb.png',			unique = true,		useable = true,		shouldClose = true,	   combinable = nil,   description = ''},
speed_bomb 			= {name = 'speed_bomb',			label = 'Speed Bomb',		        weight = 1000,			type = 'item',		image = 'speed_bomb.png',			unique = true,		useable = true,		shouldClose = true,	   combinable = nil,   description = ''},
firelighter 			= {name = 'firelighter',		label = 'Firelighter',		        weight = 1000,			type = 'item',		image = 'firelighter.png',			unique = true,		useable = true,		shouldClose = true,	   combinable = nil,   description = ''},

4. Tools Configuration

The Config.Tools table contains settings for various tools:

Config.Tools = {
    impactDriver = { ... },
    spanner = { ... },
    pliers = { ... },
    spannerAdj = { ... },
    drill = { ... },
    buzzSaw = { ... },
    screwdriver = { ... }
}

Each tool has properties like enabled, name, item, model, offsets, and breakChance.

5. Bombs Configuration

The Config.Bombs table defines explosive types:

Config.Bombs = {
    ignitionBomb = { ... },
    impactBomb = { ... },
    remoteBomb = { ... },
    firelighter = { ... },
    speedBomb = { ... }
}

Each bomb type has specific settings and activation conditions.

6. Repair Settings

Config.RepairJob = {'mechanic', 'hobo'}
Config.RepairTime = 10
Config.RealisticRepair = false
Config.RepairAll = true

Control repair mechanics, including authorized jobs and repair durations.

7. Sound Settings

Config.SawVolume = 0.8
Config.ImpactDriverVolume = 0.5
Config.DrillVolume = 0.3

Adjust volume levels for tool sounds.

8. Minigame Settings

Config.MiniGame = false

Toggle minigame functionality for certain actions.

9. Vehicle Class Blacklist

Config.BlacklistedVehClasses = { 17, 18, 19, 20, 21 }

Define vehicle classes immune to sabotage actions.

10. Editable Functions

Customize these functions to integrate with other scripts or modify gameplay:

• skillCheckEasy()

• skillCheckFast()

• skillCheckLong()

• onFireStarted(coords)

• fuelExport(vehicle)

11. Language Localization

The Config.Lang table contains all in-game text strings:

Config.Lang = {
    ['driver_door'] = 'Driver Door',
    ['passenger_door'] = 'Passenger Door',
    -- ... more entries ...
}

---

This documentation provides a comprehensive overview of the Envi-Sabotage-v2 script configuration. Administrators can use these settings to tailor the script to their server's needs and integrate it with other systems.