> For the complete documentation index, see [llms.txt](https://arctic-development.gitbook.io/arctic-development/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://arctic-development.gitbook.io/arctic-development/scripts/carcols-fixer.md).
# Carcols Fixer
The Carcols Fixer **Script** for FiveM is the one-stop solution for managing Siren, Light & Modkit IDs In-Game!
***
1. [Ox\_lib](https://github.com/overextended/ox_lib)
2. Badger\_Discord\_API
***
Main Menu Preview
Civilian Preview
Law Enforcement Preview
Sort Preview
***
{% hint style="info" %}
Want to add a new category?
{% endhint %}
```lua
Config = {}
-----------------------------------------------------------------------------------------------------
-- Developer Settings
-----------------------------------------------------------------------------------------------------
Config.Debug = false -- Enable debug prints in the server console
Config.Command = 'carcolsfixer' -- Command used to open the in-game Carcols Fixer dashboard
Config.AllowConsole = true -- Allow the server console to use Carcols Fixer commands
Config.AutoScanOnStart = true -- Automatically scan vehicle resources when AD-CarcolsFixer starts
-----------------------------------------------------------------------------------------------------
-- Permission Settings
-----------------------------------------------------------------------------------------------------
Config.UsePermissionLock = true -- false will disable the permission lock meaning every user can use the system
Config.PermissionType = 'Ace' -- Choose 'Ace' or 'Discord' -- Badger_Discord_API is required for Discord Role Locking
Config.RequiredAcePermission = 'ad.carcolsfixer' -- ACE permission required when using Ace
Config.RequiredDiscordRoleIDs = { -- Discord Role IDs allowed to use the system when using Discord
YOURDISCORDROLEID,
}
-----------------------------------------------------------------------------------------------------
-- ID Settings
-----------------------------------------------------------------------------------------------------
Config.SirenStartID = 100 -- Siren IDs begin here and continue upward with no maximum
Config.LightStartID = 100 -- Light IDs begin here and continue upward with no maximum
Config.ModkitStartID = 10000 -- Modkit IDs begin here and continue upward with no maximum
-----------------------------------------------------------------------------------------------------
-- Vehicle Grouping Settings
-----------------------------------------------------------------------------------------------------
-- These endings are removed when Carcols Fixer determines which vehicles belong to the same family.
-- Example: AD_18DHIGenericRaptorRB + AD_18DHIGenericRaptorBB = AD_18DHIGenericRaptor family
Config.VariantSuffixes = {
'RWB', 'RBW', 'BRW', 'BWR', 'WRB', 'WBR',
'RB', 'BB', 'RR', 'AA', 'WW',
'BR', 'RW', 'WR', 'BW', 'WB',
'RA', 'AR', 'BA', 'AB', 'WA', 'AW'
}
-- Controls which variant receives the first ID inside a vehicle family.
-- RB is first and BB is second, so a Raptor RB/BB family can become 100/101.
Config.VariantOrder = {
'RB', 'BB', 'RR', 'AA', 'WW',
'BR', 'RW', 'WR', 'BW', 'WB',
'RA', 'AR', 'BA', 'AB', 'WA', 'AW',
'RWB', 'RBW', 'BRW', 'BWR', 'WRB', 'WBR'
}
-- Optional manual family overrides for vehicles whose names do not follow your normal variant naming.
-- Example: ['AD_18DHI_Raptor_Slicktop'] = 'AD_18DHIGenericRaptor'
Config.FamilyOverrides = {
}
-----------------------------------------------------------------------------------------------------
-- Scanner Settings
-----------------------------------------------------------------------------------------------------
Config.IgnoredResources = { -- Resource names Carcols Fixer should completely ignore while scanning
'AD-CarcolsFixer',
'ox_lib',
'monitor',
'webadmin',
'sessionmanager',
'spawnmanager',
'mapmanager',
'chat',
'hardcap',
'rconlog'
}
Config.IgnoredFolders = { -- Folders ignored inside resources to make scans faster
'stream',
'.git',
'node_modules',
'web',
'html',
'dist',
'build',
'cache'
}
Config.MaxScanDepth = 20 -- Maximum folder depth Carcols Fixer will search inside each resource
-----------------------------------------------------------------------------------------------------
-- Backup Settings
-----------------------------------------------------------------------------------------------------
Config.UseBackups = true -- Create a safety backup before Carcols Fixer changes any vehicle files
Config.BackupAmount = 5 -- Maximum amount of backup snapshots to keep
-----------------------------------------------------------------------------------------------------
return Config
```
***
{% hint style="success" %}
Downloads
\[PAID | Open Source] [Official Store Link](https://arcticdevlabs.com/package/Script/Carcols-Fixer)
{% endhint %}
