Correctly packing mods

All mods on the repository need to work from the get-go for any user who installs it, and this means that the folder structure of the compressed zip file needs to be correct. This is commonly referred to as how the mod is packed.

The first file inside your zip should always be the appropriate top level folder (or folders) for your content. This is usually the vehicles or levels folder but may also be lua, ui, art or a range of others depending on what the mod is. This folder is what needs to be selected and compressed/zipped, instead of the mod folder these are contained inside or any individual parts of a mod.

Basic example

An example file structure, in this case for a vehicle configuration mod that has been unpacked could look like this in your mods folder:

/mods/unpacked/my_new_config/vehicles/pessima/pessima_awesome_configuration.pc

You would need to select and compress the vehicles folder here, as this is the top level folder that tells the game what type of content it is. The zip file will take the place of the folder that holds the mod content and it’s name can be whatever you wish (provided it’s relevant to the mod itself of course).

Multiple Folders

Some mods contain more than one top level folder. For example, an Automation vehicle may include both:

• vehicles
• art

In this case, select both folders at the same time and compress them together. This applies to all folders that exist at the same level in your mod structure.

Packing multiple mods into one file

If you have multiple mods you would like to include in the same file, always make sure the same folder structure is being followed.

In the case of multiple car mods you would like to upload together, you would merge them into the same mod folder so that the individual car folders are together under the same parent vehicles folder, which would then be compressed and uploaded to the repository.

Top Level Folders

All available top level folders used by mods:

Common Mistakes

Key Rule