CSVMerge – Item Addition Utility

CSVMerge – Item Addition Utility | Cyberpunk 2077

by Dona

CSVMerge – Item Addition Utility is a script utility, tutorial, and template files for item additions are included. This is a script utility that allows the addition and compatibility of mods that add new clothing items to the game.

Creator: Nim

CSVMerge – Item Addition Utility

nowmods information

Nowmods requirements

Mod nameNotes
Cyber Engine Tweaks(For Users & Modders) Required by this utility, no exceptions.
redscript(For Users & Modders) OPTIONAL; required only for integration with Atelier. Not required by the utility itself.
Virtual Atelier(For Users) OPTIONAL; Required by any mod using this utility that also has Atelier support. Not required by the utility itself.

Credits and distribution rights

  • Assets of other users: Some of the assets in this file are the property of other authors. Before you can use these authors’ assets, you must first obtain permission from them.
  • Upload authorization: Under no circumstances are you permitted to upload this CSVMerge – Item Addition Utility file to other websites.
  • Permission to modify: You must obtain my permission before modifying my files in order to improve them.
  • Permission to convert: Under no circumstances are you permitted to convert this CSVMerge – Item Addition Utility file for use in other games.
  • Permission to use assets: You must obtain my permission before using any of the assets in this file.
  • Asset use permission in purchased mods/files: You are not permitted to use assets from this CSVMerge – Item Addition Utility file in any mods or files that are sold for a fee on Steam Workshop or other platforms.
  • Permission to use assets in mods/files that earn donation points: You cannot earn Donation Points for your mods if they use my assets.

Notes from the Author

This CSVMerge – Item Addition Utility includes files created by other authors; however, any and all files with a file name that does not include the word “template” are not free to use for any reason.

Files with the prefix “template” are free to use and re-upload.

Credits should be filed
In this CSVMerge – Item Addition Utility file, the author has not given credit to anyone else.


This CSVMerge – Item Addition Utility will soon be redundant and will no longer be maintained or updated, it will remain here to ease transition and to enable continued use of mods already making use of this utility.

This project has had many contributors, and I’d like to thank each and every one of them for their contributions and assistance in getting this to a workable state; without these people, the project would never have reached this stage.

There are several requirements for this utility, and I’ve done my best to distinguish which of these you’ll need based on your intended use:

(For Users) = Things that you will need as a user, to operate this CSVMerge – Item Addition Utility and it’s features/integration with other mods.
(For Modders) = Things that you will need as a modder intending to use this utility for your own mods.
(For Users & Modders) = Things that everyone will need regardless of use-case.
(OPTIONAL) = Things that are optional and not necessarily required for this utility to run.

CSVMerge – Item Addition Utility
Typical code file

How Does It Work?

Items in this game all come from the same small handful of files, which are organized by type/slot. Adding to these files has been possible for quite some time, but the problem is that once done, it is incompatible with any other alterations to those same files.

This CSVMerge – Item Addition Utility essentially allows for the patching of these files, allowing us to use them properly without fear of incompatibilities.

Technical features of this utility include:

  • Item names.
  • Item descriptions.
  • Item icons.
  • The ability to add your items to street vendors of your choosing.
  • Compatibility with Atelier.
CSVMerge – Item Addition Utility
Typical item file

Utility Installation and Requirements

This CSVMerge – Item Addition Utility necessitates the installation and operation of Cyber Engine Tweaks (CET), the details and troubleshooting of which will not be covered or indulged in here.

Step #1

Simply drag and drop the contents of this mod into your game’s root directory, the location of your game will vary depending on where you purchased or otherwise acquired it from, listed at the bottom of this description are some typical installation paths that this game uses.

Correct installations paths:

Cyberpunk 2077\CSVMerge
Cyberpunk 2077\CSVMerge\mods
Cyberpunk 2077\CSVMerge\wolvenkitcli
Cyberpunk 2077\bin\x64\plugins\cyber_engine_tweaks\mods\CSVMerge_Code

Step #2

Download WolvenKit Console, from the optional files on the wolvenkit page, linked in requirements, and install it within the following folder:
Cyberpunk 2077\CSVMerge\wolvenkitcli

You should now have:
Cyberpunk 2077\CSVMerge\wolvenkitcli\WolvenKit.CLI.exe
+the rest of wkits files within that same folder

WolvenKit also requires NET 5.0.0 to run, linked in requirements.

That’s it!

CSVMerge – Item Addition Utility
CNAMES array
CSVMerge – Item Addition Utility


nowmods download

Download CSVMerge – Item Addition Utility mods:

Main file:
? CSVMerge_1.0.1_031121Removed superfluous csvmerge folder, fixed some tutorial things.
QoL update, no changes or additions to utility functionality.
Optional files:
? Johnson – Mod Community TShirtExample mod
Thankyou Johnson.
? Nim – Additions – ScarvesNeck scarves, because they are cute.
? Nim – Additions – Scarves – Atelier StoreAtelier store containing the items.
Miscellaneous file:
? Template FilesFixed the group entity template.
Added the scarves mod folder for people to pick apart and study it’s general structure if that helps.
Actually fixed the single icon template inkatlas file this time.


To install a new item mod, again, simply drag and drop the contents of the mod into your games root directory, the folders will merge and the files will be placed where they belong. The installation paths for mods using this utility are as follows:

Cyberpunk 2077\CSVMerge\mods\ModName\item.item
Cyberpunk 2077\CSVMerge\mods\ModName\code.code
Cyberpunk 2077\archive\pc\mod\mod_archive.archive

?‍? How to install Cyberpunk 2077 mods with specific instructions

For Users:

As a user, all you have to do is install a new item mod, run the script, and this CSVMerge – Item Addition Utility will create a new mod archive and CET script, which it will automatically move into the appropriate folders. If the modder has done everything correctly, all you need to do is install the mod and run the script:

Step #1:
Install item mod.

Step #2:
Run: Cyberpunk 2077\CSVMerge\CSVMerge.cmd

Step #3:
Close the window once it has finished, assuming no issues arise.

CSVMerge – Item Addition Utility

For Modders:

CSVMerge – Item Addition Utility included is a moderately detailed rant about the files you’ll need to create a new item; this tutorial will most likely be expanded upon as more information is discovered.

  • There are also template files included for you to use as you see fit; it is highly recommended that you use these included files and simply make them unique to you, as detailed in the tutorial.
  • ALSO INCLUDED ARE THE FILES USED IN MY EXAMPLE SCARF MOD; these are mostly for reference, but feel free to use any of the files if they are at all useful.
  • Make sure your mod is properly packaged and that nothing is out of place; one broken mod will bring the entire system down.
  • If you’re having problems or want to join the fight, there’s a link to our Discord server at the bottom of this article.
CSVMerge – Item Addition Utility
Game ready group enity


CP77Tools missing .exe: Install WolvenKit Console from optional files on the Wkit mod page, linked in requirements.
.dll errors: Install NET 5.0, linked in requirements.
Tool dead but I swear I did it all correctly: Clear out your “Cyberpunk 2077\CSVMerge\wolvenkitcli\mod” folder, and use fresh files from the main files of CSVMerge – Item Addition Utility archive.

Typical Game Installation Paths:

Steam: \SteamLibrary\steamapps\common\Cyberpunk 2077
GOG: \GOGLibrary\Games\Cyberpunk 2077\
Epic: \EpicLibrary\Cyberpunk 2077\


For creating the script and script-related files that this tool relies on, as well as for being an all-around wonderful person. When asked to remain anonymous, I decline.

  • anygoodname: Providing a base to build from to create the script that powers this project.
  • Scissors: For his code wizardy, giving me what I needed to get this all started, and for input during it’s development.
  • Erok: For his code wizardy, enabling item names, descriptions, and icons.
  • TilW: For his code wizardy, pointing us in the right direction for item names.
  • Pacings: For his code wizardy, input, and the work put into Atelier.
  • rFuzzo, Traderain & the WKit team: For developing WolvenKit, which this tool utilises, and Fuzzy specifically for his fuzziness.
  • alphaZomega: For creating the binary template that we all know and love, enabling alterations to all of these file types.
  • Spicy: For creating template .inkatlas and .xbm files for item icons, and being super spicy.
  • SilverEzredes: For creating the mods title image, and for being perfectly cunty.
  • Johnson/Janecio14: For being the first test subject and for providing an example mod.
  • map788/maks788: For first discovering that Atelier support was possible way back when this began.
  • Nim: Initial proof of concept for item additions, template files, related tutorials, other things probably.

Support Creator


If you are interested in learning more about CSVMerge – Item Addition Utility, join us over at DISCORD. We’ll help out where we can.

Browse for more Cyberpunk 2077 mods


Related Posts

Notify of

Inline Feedbacks
View all comments
Would love your thoughts, please comment.x