[Release] Carcols Fixer (Free, open-source siren / light / modkit ID conflict fixer)

FiveM Releases
,
1

CFX_Software (4)
CFX_Software (4)1280×720 181 KB

Hey everyone.

If you’ve ever added a new car pack and watched the lightbars on three other vehicles break, you already know the problem. GTA V only gives you 255 siren slots, 255 light slots, and 1023 modkit slots, and most packs don’t coordinate their numbering. The moment two cars land on the same ID, sirens flash the wrong pattern, lightbars show the wrong color, modkits go missing from LSC.

The usual fix is opening every carcols.meta by hand. Then you add another pack and do it all again.

I built carcols-id-fixer because I didn’t think anyone should have to pay 20 euros for the script that solves this. It’s one file, ~600 lines, MIT licensed, zero dependencies.

What it does

  • Scans every carcols.meta and carvariations.meta in your resources/ tree
  • Finds every duplicate siren, light, and modkit ID across every pack at once
  • Picks a free number inside the valid range and rewrites the loser
  • Updates the matching <Item>N_kitname</Item> references in carvariations.meta automatically so the engine still finds the kit
  • Saves a .bak of every changed file before touching it
  • One-command rollback (node . --revert) restores every original

Built for messy real-world packs

  • Handles packs where the kitName number doesn’t match the <id> (more common than you’d think)
  • Skips engine-default modkit 0
  • Catches out-of-range IDs and reassigns them to valid slots
  • Preserves formatting, comments, indents, and line endings byte-for-byte
  • ignore list in config so you can keep specific resources untouched

How to run it

Drop the folder next to your server.cfg:

fxserver/
- server.cfg
- resources/
- carcols-id-fixer/

Then:

cd carcols-id-fixer
node .                # find clashes, fix them, save backups
node . --revert       # roll everything back
node . scan           # report only, no writes
node . fix --dry      # preview without writing

Restart your vehicle resources after a fix and you’re done.

Why free

Honestly because the math behind this script is not worth €20 to anyone, and I think the FiveM community is better when this kind of basic infrastructure is open.

Download

GitHub: GitHub - CFX-Software/carcols-id-fixer: Detects and fixes sirenSettings, lightSettings, and modKit ID overlaps across FiveM carcols.meta and carvariations.meta files. · GitHub

Clone it, read the README, run it on a backup first if you’re nervous. Issues and PRs welcome.

Code is accessible | Yes
Subscription-based | No
Lines (approximately) | 600
Requirements | Node.js 18+
Support | Yes (via GitHub Issues)

46 Likes
2

Really nice tool, Works out of the box.

Much love for making this a free OS release :heart:

1 Like
3

The “1023 modkit slots” limit is actually outdated. FiveM increased this years ago to 65536

NUM_MODKIT_INDICES = 65536
_vehicleModKitArray = (uint16_t*)hook::AllocateStubMemory(sizeof(uint16_t) * NUM_MODKIT_INDICES);

4 Likes
4

Thanks man, i appreciate the kind comment

5

Thanks, pushed this half asleep will update it tonight!

6

nice!

1 Like
7

I don’t even do anything car-related, but gotta leave a like for a great open source tool.

3 Likes
8

Update Pushed

We have recently just updated this and pushed it with credits to you. Thank you for helping an open source project.

9

We genuinely appreciate all the support lately.

We got notified that someone was selling this for €20, and honestly, that didn’t sit right with us. So instead of letting people get milked for basic resources, we decided to build our own version.

10

:fire: :fire: :fire: sick release tbf

1 Like
11

Yeah why pay for something, when i just released it free :smiley:

Glad u like it

2 Likes
12

Thank you :light_blue_heart:

2 Likes
13

Of course!

If you guys have suggestions for other tools, reply with them below :slight_smile:

1 Like
14

A car packer would be nice lol

2 Likes
15

Yeah we already have that function on our website. We will make an open source version that can automatically handle it all for you guys.

Estimate 2 weeks for completion.

1 Like
16

Very nice work. Thanks for putting it out for free. :+1:

2 Likes
17

Of course, with our studio our mission is to ship tons of open sourced projects.

18

Totally not written by AI along with the post.

19

We’d genuinely love to see what part of our post or script you think was AI generated.

Instead of instantly throwing around accusations and negativity on the forums, maybe support the developers actually building things for the community. That kind of attitude is exactly what pushes people away and hurts the scene long term. AI slop absolutely exists and has flooded the forums with people generating content without understanding what they’re making. But there’s a difference between actual AI slop and developers using tools while still building real products. You should be able to tell the difference without assuming everything is AI the moment you see a well written post.

2 Likes
20

Thanks men, I was struggling with fixing carcols. You’re life saver :slight_smile:

1 Like