Bundles
A bundle combines assets you already saved or published into one collection that installs in one go. Each part stays in the Library on its own.
What a bundle is
A bundle installs several of your assets in one go: a car with its layout and its look, say, or a starter bundle of parameter packs and icons. Each part stays in the Library on its own. A bundle is a second way to offer them, not a replacement.
A bundle authors nothing itself. Every part is an asset you already saved or published, and nothing in the bundle editor can change a part. To change a part, edit the asset itself, then take its new version into the bundle.
- A bundle can hold Car set, Layout, Parameter pack, Icon pack, Lap and Look assets.
- Only your own assets can go in. A bundle of somebody else's work would republish it under your name.
Build a bundle
- In My assets, choose + New ▸ Bundle (combine assets), or open Bundles in the rail and start one there.
- Name it in the bar at the top. It starts as My bundle.
- The editor shows two lists side by side: My assets on the left and In this bundle on the right. Click assets to select them, then press Add →. To take them back out, select them on the right and press ← Remove. A double-click moves one asset across straight away.
- With more than eight assets, a search field filters the left list by name or type.
Both lists are sorted by type, then by name. The order a bundle installs in carries no meaning, so there is nothing to arrange. On a phone the two lists sit one under the other, and the arrows point down and up.
Marks on a part
- not listed: the asset isn't in the Library on its own. It can still ride in a bundle.
- newer exists: you have published a newer version of the asset since you added it.
- deleted · copy kept: the asset is gone from your assets, but the bundle still installs the copy it took.
- merged: the asset was merged into another one; the bundle keeps the copy it took.
A bundle keeps copies
When you add an asset, the bundle takes a copy of it as it is at that moment. Publishing a newer version of the asset later doesn't change the bundle by itself. That is why a part can be marked newer exists.
When parts are out of date, a button above the lists says how many and offers to refresh. Press it to take every part again from its current version. You can also ship the older copy on purpose; the checklist reminds you either way.
The listing and publishing
The rail on the right is what the Library shows: a collage of your parts' own pictures, drawn live, or a picture you upload instead. With more than 12 parts the collage shows the first 12. In the Library, the bundle's gallery shows each part's own picture.
Before it can go lists what publishing needs:
- at least one asset in the bundle;
- a name, which the Library card shows;
- a description, whose first line is what people read before installing;
- a picture credit: who the image is owed to, and whether it is a render, a photo or an illustration;
- every part at its current version, or your choice to ship an older copy.
Save keeps a private draft in your assets. Export writes the bundle to a file. Submit for review sends it to the Library, the same way as any asset; see Publish and review. Once it is live, anyone can install the whole bundle at once from the plugin's Library page.