RageKit

How to merge FiveM resources into one

To merge FiveM resources you put their streamed files into one stream/, combine their meta files so each kind is registered once, and write one fxmanifest.lua. RageKit's Server Doctor does this for resources already on a server: select them, choose Merge selected…, and it builds one resource, merges vehicles.meta, handling.meta, carcols.meta, carvariations.meta and other metas into one file per kind, renumbers clashing mod kit and siren ids, and starts the merged resource in server.cfg. Resources with scripts can't be merged.

Updated

Before you start

  • A FiveM server folder with the resources you want to combine inside resources/.
  • Asset and data resources only, such as vehicle packs, weapons and maps. A resource with scripts is refused.
  • Premium to apply the merge. The scan and the full preview are free.

Steps

  1. Scan the server

    Open Server › Doctor, choose your server folder and Scan.

  2. Select the resources

    On the Resources tab, tick the resources to combine. Use Filter resources to find them; resources that contain scripts are marked scripts next to their name.

  3. Choose Merge selected…

    The button is enabled once two or more are ticked. Enter the Name of the merged resource: letters, digits, - and _ only.

    • If one of the selection has scripts, the dialog says which and Preview stays disabled. Untick it and try again.
  4. Read the preview

    Choose Preview. It lists the new resource, the originals that move into the backup, the change to server.cfg, and notes for every merged meta file, renumbered id, renamed file and identical file shipped once.

  5. Settle conflicts

    Where two resources set the same field differently, the preview shows the field with a picker. The resource that starts later wins by default; pick another version to keep it.

  6. Apply

    Choose Apply. The merged resource is built into resources/[ragekit-merged]/<name>, the originals are moved into ragekit-backups/ next to resources/, and their start lines in server.cfg are commented out with ensure <name> in their place.

    • Without a server.cfg, add ensure <name> to yours by hand.
  7. Test, or undo

    Restart the server and spawn a few of the vehicles. If something is off, Undo in the Backups tab restores the original resources and server.cfg and removes the merged one.

What the merge does with each file

Meta files of the same kind (vehicles, handling, carcols, carvariations, weapons and others) are merged into one file per kind, with start order as the priority.

Mod kit and siren ids that clash between the resources are renumbered, and the files that refer to them are updated.

Identical files are shipped once. Other data files that share a name but differ are kept under new names.

Files a resource doesn't list in its manifest's files or data files are left out, and the preview names them.

The result is checked with Pack Doctor, and the preview shows its error and warning counts.

Merging your own RageKit projects instead

If the cars, clothing or maps are projects you made in RageKit's studios, use a Workspace. Choose Add projects…, or Add a folder… for loose files, run Check, then Build all.

A workspace builds one resource with one manifest. Files that are the same in several members are shipped once and clashing data files are renamed. When two members ship different files with the same name, the member listed first wins.

Workspaces need Premium.

Questions

Can I combine several addon cars into one resource?

Yes. Select the car resources in Server Doctor and choose Merge selected…. Their metas become one file per kind, clashing mod kit and siren ids are renumbered, and one manifest registers everything.

Can I merge resources that have scripts?

No. Merging would change when the scripts load and what they can reach, so only asset and data resources can be merged. Keep script resources separate.

What happens to the original resources?

They're moved into a backup folder next to resources/, not deleted. Undo in the Backups tab puts them back and restores server.cfg.

Do I have to edit server.cfg after merging?

Not if Server Doctor found it. The originals' start lines are commented out and ensure <name> is added. If no server.cfg was found, add the line yourself.

Tools in this guide

Get RageKit

Free download for Windows 10 and 11. No account needed for the free tools.

There's no Windows installer on the latest release yet. Check the changelog for when it lands.