1 of 1

ItemAdditions: files from scratch

How to set up the folder structure from scratch

Summary

Created: by @manavortex Last documented edit: June 10 2023

This page is a part of the Adding new items guide and deals with finding the correct files for an ArchiveXL item addition.

For an explanation of the file structure, see ItemAdditions: File structure explained.
If you want to add an atelier store, see Your own Atelier Store.
If you want to add preview items, check Your own inventory preview icons.
If you want to port a mesh from a different game to Cyberpunk, check Porting 3d objects to Cyberpunk

TL;DR: If you can't be arsed doing this by yourself, find a template project with one working item (female rigged) here.

Overview:

File in modded dir

was originally copied from

For mesh_entity.ent, your entity file needs to correspond to your item's body part. If you put a shirt in an entity file for shoes, it will deform badly once you put it on.

If you rename your components, we recommend using CDPR's naming prefixes for reasons of garmentSupport. You don't need to understand how this works, just name your component like l1_myCustomPants instead of myCustomPants and call it a day.

For further details, check here.

It is good practice to keep local copies of everything that you change (=> custompathing) instead of overwriting files under base. This makes sure that no other mods will overwrite your changes.

ℹ Only keep files under base if you are okay with them being overwritten!

Optional, but very recommended: Clean out obsolete entries

Open the file translation_strings.json in WolvenKit. Expand the array root and then the array entries. Delete all entries but one.
Open the file my_shirt_factory.csv in WolvenKit. In compiledData, delete all entries but one. In data, delete everything - these will get autogenerated.
Open the file root_entity.ent.
Expand the list appearances. Delete all entries but the first (most likely default).
Open the file my_custom_shirt.app. Expand the list appearances. Delete all entries but default.
Open the file mesh_entity.ent Select resolvedDependencies and delete all the entries. (We don't need Judy's top anymore.)
Make a back-up copy of your t1_custom_shirt.mesh, then open it.
1. Expand the first appearances at the top of the file. Open the appearance default and check which material is linked in the chunkMaterials array.

Now is a good time for a backup.