Your own Atelier Store

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.

Wait, this is not what I want!

• Find a guide on Your own inventory preview icons

• Learn more about Game icons: .inkatlas files

• If you are using ItemAdditions: Dynamic Appearances, you can use W's generator to quickly create spawn codes and Atelier entries

Requirements

You need to install the VirtualAtelier mod for this.

You also have to add it to your mod's requirements, as atelier stores will cause script errors if users don't have it installed.

Generating an icon

You need a single .png file with your store's icon (200x200 px). It needs to be in a folder all by itself, and its file name should be slot_01.png.

Now, run the inkatlas generator in WolvenKit with the following settings:

Overwrite existing file	leave it blank
Inkatlas folder	Target path of your .inkatlas, e.g. tutorial\torso\my_custom_shirt\ops
Inkatlas file name	Name of your icon, e.g. atelier_icon
Tile SIze	200x200
PNG raw folder	Path to the folder with your .png file.

After running the generator, make sure to import the png files via Import Tool. They should now show up in the folder where you put them:

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

Example store file (if you don't want to use the generator)

@addMethod(gameuiInGameMenuGameController)
protected cb func RegisterYOURNAMESStore(event: ref<VirtualShopRegistration>) -> Bool {
  event.AddStore(
    n"YOURNAME",
    "Your Store Name",
    [            
      "Items.my_custom_shirt_redwhite",  	
      "Items.my_custom_shirt_redblack"
	],
	[ 1	],
    r"tutorial/torso/my_custom_shirt/ops/atelier_icon.inkatlas",
    n"slot_01",
	[ "Legendary" ]
  );
}

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
Texture Part	slot_01

1. Now, add your item.

In atlasResource, you have to replace all \ with /

Your atelier store will cause script errors if you don't.

Here's an explanation for the fields below. Rather than filling them by hand, you should use this website to generate your store files.

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? Allowed values are: - "IconicItem" - "Legendary" (LegendaryPlus, LegendaryPlusPlus) - "Epic" (EpicPlus) - "Rare" (RarePlus) - "Uncommon" (UncommonPlus) - "Common" (CommonPlus)

​ 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".

In the downloaded file, check that atlasResource has forward slashes / instead of backwards slashes \, as per the warning box above.

Placing the atelier file

In your project's resources folder, create a subdirectory r6/scripts (if it doesn't exist already), and move the atelier file that you downloaded into there:

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

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

Troubleshooting

My atelier store causes scripting errors!

I'm not sure how you managed to read past all the red and yellow boxes on this page, but make sure that the path under atlasResource has forward slashes / instead of backwards slashes \.

If that wasn't it, you might have to re-generate your Atelier store.

My atelier store makes the game crash!

That happens when there are two atelier stores with the same store ID. Do a full-text search for the store ID (MyTutorialAtelierStore) in r6\scripts and make sure that you don't have any duplicates.