Resource Merger

Merge your assets in the app

Merge mode in My assets: pick what goes together, see why a row cannot join, name the resource and merge. Up to 20 assets at once.

Opening merge mode

The Resource Merger in the app is a mode of My assets. There are three ways into it:

My assets: press Merge into one in the toolbar.
Tools page: on Home, open Browse all tools and pick Resource Merger under Convert and bundle.
One asset: on the page of a finished prop, press Merge. Merge mode opens with that asset already picked.

The Convert and bundle group of the tools page with Resource Merger and EUP Merger next to the other converters.

The buttons at the top of the boombox asset page: Animate, Merge and FiveM .zip.

To leave merge mode without merging, press Cancel in the merge bar. Your picks are dropped; nothing else changes.

Finished assets that are streamed resources can join: 3D models, uploads, rebuilds, reskins and reskin packs, animated props and vehicle liveries. The search box and the type filters still work in merge mode, and picks stay when you filter.

Rows that cannot join are dimmed and carry their reason:

Asset	Reason on the row
EUP packs and Sims 4 clothing	Clothing: use the EUP Merger
A merged resource	Already a merged resource
An edited animation	Not a streamed resource
A weapon from the Weapon Studio	Weapons install as their own resource
A generated weapon model	A weapon model, not a finished resource
A job that is still running	Still processing
A failed or cancelled job	Not completed

EUP packs and Sims 4 clothing
Clothing: use the EUP Merger
A merged resource
Already a merged resource
An edited animation
Not a streamed resource
A weapon from the Weapon Studio
Weapons install as their own resource
A generated weapon model
A weapon model, not a finished resource
A job that is still running
Still processing
A failed or cancelled job
Not completed

AI Animations are not listed in My assets at all. To merge animation clips, download their resources and use the upload version.

Assets to keep as their own resource

Two kinds of assets can be picked in merge mode but do not work after a merge. The merger only carries the files in the stream folder and writes a new manifest, and these two need more than that:

Tattoo packs from the Tattoo Studio. Their overlay list and tattoo shop file sit next to the stream folder and are loaded by their own manifest. Without them the tattoos are not registered.
Interiors from the Interior Builder. Their manifest loads extra prop definitions and marks the resource as a map; the merged manifest has neither.

Careful

Install tattoo packs and interiors as they come, next to the merged resource. Weapons are refused for the same reason.

The resource name

Type the name into Resource name in the merge bar. Merge stays grey until there is a name and at least two picks. The name becomes the resource name:

Letters are made lowercase, and spaces and other characters become _. City Props becomes city_props.
The line under the field shows the result, for example server.cfg: ensure city_props.
Start with a letter. A name that starts with a digit gets m_ in front on the server, which the line under the field does not show yet.

Pick a name that is not already a resource on your server, so the two do not clash.

The file-name check

FiveM streams files by name, so two files with the same name in one resource would fight. Before anything starts, the Resource Merger checks the files of every picked asset. When two stream the same file, the merge bar names each file and the assets it comes from, and nothing is started:

The merge bar with two road_barrier assets picked and the red message that they stream files with the same name.

Here both road_barrier assets, the original and its rebuild, stream road_barrier.ydr and its other files. The fix is to keep one of them. To have both, give one prop a new name first. A reskin in Prop Reskin builds the prop under its own spawn name.

Note

The merger never renames a prop for you: a new file name would be a new spawn name and break the scripts that use it.

Limits

What	Limit
Assets per merge	2 to 20. A 21st pick shows A merge takes at most 20 assets.
Resource name	Up to 60 characters in the field.
Merging a merged resource	Not possible: Already a merged resource. Merge the original assets again, with the new ones.
Jobs at the same time	A merge is a job like any other. Three jobs of one account can run at once.
Price	Free, no credits held.

Assets per merge
2 to 20. A 21st pick shows A merge takes at most 20 assets.
Resource name
Up to 60 characters in the field.
Merging a merged resource
Not possible: Already a merged resource. Merge the original assets again, with the new ones.
Jobs at the same time
A merge is a job like any other. Three jobs of one account can run at once.
Price
Free, no credits held.