Adding items: Atelier integration

How to set up an atelier store for your mod

This guide will detail how to add an Atelier store with your items. It is part of the Adding new items ArchiveXL tutorial, but you can complete these steps independently.

You need to install the VirtualAtelier mod for this. You also have to add it to your mod's requirements, as the store won't work if users don't have it installed.

Generating an icon

First of all, download the template archive (kindly provided by Apart) and find the folder virtual_atelier_inkatlas_icon_template

atelier_icon_template.inkatlas                        << map for the game  
atelier_icon_template.png                             << 200x200px image for a final slot  
atelier_icon_template.xbm                             << game texture  
virtual_atelier_png_to_xbm_import_settings.png        << image, also embedded here  

Put the .inkatlas and .xbm into your project (if you're using the example project, they should go into the ops folder). Then, rename them to atelier_icon:

tutorial
  torso
    my_custom_shirt
      ops		   
      	- my_shirt_factory.csv  
      	- translation_strings.json  
      	- preview_icons.inkatlas       
      	- preview_icons.xbm            
      	- atelier_icon.inkatlas        <<<  
      	- atelier_icon.xbm             <<<  

Now, create your icon. The process is the same as for "preview images". The resulting slot will be named slot_01.

Creating the atelier file

1. Visit this website and fill out the information:

Field	Content
Store ID (characters only, w/o spaces, '-', '_' and etc.)	MyTutorialAtelierStore
Store Name	My Tutorial Atelier Store
Atlas Resource	tutorial/torso/my_custom_shirt/ops/atelier_icon.inkatlas ⚠Make sure to replace all backward slashes with forward slashes here!
Texture Part	slot_01

1. Now, add your item.

Field	Content
TweakDBID	as defined in your yaml, e.g. Items.my_custom_shirt_redwhite
Price	Whatever price you want, 0 means that it's free
Quality	Are we settling for anything but legendary here?

​ Ignore "Icon path" and "description", we have these in the item itself.

1. Click "Add Item". Repeat the process with as many items as you want.

2. Click "Generate".

Placing the atelier file

Move the atelier file from your download folder to WolvenKit's resources folder:

resources
  - tutorial_my_custom_tshirt.archive.xl  
  - tutorial_my_custom_tshirt.yaml         
  r6
    tweaks
      - MyTutorialAtelierStore-atelier-store.reds         << new file

Now, it's time to test! Install the mod and start Cyberpunk.

If starting Cyberpunk via WolvenKit does not generate your atelier store, install the mod and launch the game by regular means.