Splitter creates one standalone resource folder for every vehicle found in the selected source resources or packs.

Split resources

1. Scan the source pack.
2. Open Split and choose an output folder.
3. Select the resources to split.
4. Leave Skip incomplete vehicles enabled to omit vehicles without matching YFT/YTD files, or disable it to create the folder with a warning.
5. Click Split into N Resources.
6. Review successful, incomplete, skipped, and warning counts in the result.

Stream-file matching

A file belongs to a vehicle when its base name:

• exactly matches the model name; or
• starts with the model name followed by a non-alphanumeric delimiter, such as _hi or +hi.

The delimiter rule prevents a model named car from taking files belonging to a different model named cargo.

Isolated and shared metadata

• If one vehicles.meta belongs to only one selected vehicle, every sibling .meta file in that directory is copied.
• If vehicles.meta contains multiple vehicles, Splitter builds a minimal vehicles.meta containing only the selected vehicle item.
• For a shared metadata source, handling.meta, carcols.meta, and carvariations.meta are not automatically separated. The result includes a warning and those files must be split manually.

Each output receives data/, stream/, and fxmanifest.lua.

Incomplete vehicles

Incomplete means no matching stream files were found. With skip enabled, no folder is created. With skip disabled, metadata and a manifest may be created without a 3D model. Such a resource is not ready for use.

Verify the result

For every vehicle, inspect standard and _hi YFTs, YTDs, handling entries, carcols, carvariations, layouts, audio, and custom data files. A successful process is not proof that a resource from shared metadata is complete.