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.

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

rootentity.ent

base\gameplay\items\equipment\underwear\player_underwear_item.ent

appearance.app

base\gameplay\items\equipment\underwear\appearances\player_underwear_item_appearances.app

mesh_entity.ent ⚠ Check the red hint box

base\characters\garment\player_equipment\torso\t1_080_pwa_tank__judy.ent

my_mesh.mesh

base\characters\garment\gang_monk\torso\t2_135_jacket__monk_shirt\t2_135_wa_jacket__monk_shirt.mesh

my_tshirt_factory.csv

base\gameplay\factories\items\clothing.csv

translation_strings.json

base\localization\en-us\onscreens\onscreens.json

preview_icons.inkatlas

base\gameplay\gui\common\icons\items\item_icons6.inkatlas

preview_icons.xbm

base\gameplay\gui\common\icons\items\item_icons6.xbm

tutorial_my_custom_tshirt.archive.xl

Wolvenkit -> New File -> ArchiveXL

tutorial_my_custom_tshirt.yaml

Wolvenkit -> New File -> TweakXL

  1. Open the file translation_strings.json in WolvenKit. Expand the array root and then the array entries. Delete all entries but one.

  2. Open the file my_shirt_factory.csv in WolvenKit. In compiledData, delete all entries but one. In data, delete everything - these will get autogenerated.

  3. Open the file root_entity.ent.

    Expand the list appearances. Delete all entries but the first (most likely default).

  4. Open the file my_custom_shirt.app. Expand the list appearances. Delete all entries but default.

  5. Open the file mesh_entity.ent Select resolvedDependencies and delete all the entries. (We don't need Judy's top anymore.)

  6. 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.

Last updated