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.
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
Scan the server
Open Server › Doctor, choose your server folder and Scan.
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.
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.
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.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.
Apply
Choose Apply. The merged resource is built into
resources/[ragekit-merged]/<name>, the originals are moved intoragekit-backups/next toresources/, and their start lines inserver.cfgare commented out withensure <name>in their place.- Without a
server.cfg, addensure <name>to yours by hand.
- Without a
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.cfgand 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
Related guides
- How to find and fix FiveM stream conflictsFind files streamed by two FiveM resources under the same name, see which copy the game uses, and remove the losing duplicates with a backup and undo.
- How to make an addon vehicle for FiveMStep by step: turn a GTA V car into a FiveM addon vehicle with its own model name, handling, colours and sirens, then build and start the resource.
- How to optimise FiveM textures and fix oversized assetsFind the oversized assets on a FiveM server, then resize, compress and add mipmaps to every .ytd in a stream folder at once, with a dry run first.
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.
