EDGEMODDERS / ANYONE CAN MOD
Wiki / REDcode

Your first mod with REDcode

In this walkthrough you rename an item V owns. It is the smallest mod REDcode can make: one line of text, no other program, no code. On the way you use every step a bigger mod needs: a project, finding something in the game, changing it, packing, installing, looking in the game, and taking it out again.

   
Time About 15 minutes
Before you start REDcode is installed and ready
In the game ArchiveXL, a free framework that lets mods add and change texts, with RED4ext, which it needs. EDGEdeck’s frameworks page installs both
Optional EDGEdeck. With it, your mod sits in the same list as your other mods. Without it, REDcode copies the mod into the game itself
On this page  
1. Make a project A folder for your mod
2. Find the item’s name In the LocKeys view
3. Add it to your project Your own copy of the text
4. Change the text And save
5. Pack and install One button
6. Look in the game The new name
7. Take it out again Uninstall
What just happened, What to try next  

The steps inside REDcode (1 to 5, and 7) were each tested by REDcode’s developer. The walkthrough as a whole, ending with the new name seen in the game, is not on record as one test: if a step doesn’t match what you see, please tell us on Discord.

1. Make a project

A project is a folder that holds everything your mod is made of. REDcode uses the same kind of project as WolvenKit.

  1. Click the REDcode icon in the activity bar, the strip of icons down the left edge of VS Code.
  2. In the Project view, press New Project.
  3. Type the name my_first_mod and press Enter. The name becomes the mod’s file name, so keep it short, in small letters, with no spaces.
  4. Choose where the project’s folder goes: anywhere outside the game folder, for example a Cyberpunk mods folder in your Documents. Press Create project here.

VS Code opens the new folder. If it asks whether you trust the authors of the files in it, say yes: the folder is yours.

You should see the Project view showing my_first_mod with four folders under it: Archive, Raw, Resources and Packed, all empty.

2. Find the item’s name

The game doesn’t keep an item’s name with the item. The name is a numbered text called a LocKey (such as LocKey#4123), and the item only refers to the number. The LocKeys view, lower down in the REDcode sidebar, finds texts by their words.

  1. Pick an item V owns and remember its name. This page uses the shoes “Sunny Ammo synthetic high-tops”; yours can be anything.
  2. In the LocKeys view’s title bar, press Search LocKeys… (the magnifier).
  3. Type a few words of the name, such as sunny ammo high-tops, and press Enter.

You should see a short list of entries, each with its text and its LocKey number. The first search takes a second or two.

If Do this
The list is empty Try fewer words. Every word you type must be in the text
You play in another language Press LocKey Language… (the globe) in the view’s title bar, pick your language, and search again
There are several entries with the same text The game sometimes has the same name more than once. Take the first; if the name doesn’t change in the game, come back and do the next one too
The LocKeys view after a search for sunny ammo high-tops: one entry, Sunny Ammo synthetic high-tops, LocKey#4123, with its two hover buttons and a tip giving its secondary key.
Finding the name

3. Add it to your project

You can’t change the game’s own copy of the text. You add a copy to your project and change that.

Hover over the entry and press Add to Project Onscreens, the first button on its row. (“Onscreens” is the game’s word for its on-screen texts.)

You should see:

Where What
The editor A table with one row: your entry, with its key and its text
The Project view, under Archive A new file, my_first_mod\localization\en-us.json (or your language), selected. This is your project’s own text file
The Project view, under Resources A small file, my_first_mod.archive.xl. It tells ArchiveXL to load your text file. You don’t need to open it

4. Change the text

  1. In the table, click the text in the femaleVariant column.
  2. Type the new name, for example My very first mod shoes, and press Enter.
  3. If the maleVariant column has a text of its own, change it too. Most entries leave it empty, and the game then uses the one text for everyone.
  4. Press Ctrl+S to save.

You should see the dot on the editor’s tab go away when the file is saved. Search again in the LocKeys view: your entry now shows your text, with a pencil icon that marks it as your project’s.

The project text file en-us.json in the table view: a filter box, add row, and one row with key 4123 whose femaleVariant text is being typed. The file is selected under Archive in the Project view.
Changing the text

5. Pack and install

Pack builds the mod from your project. Install puts it in the game. One button does both.

Close the game if it is running. In the Project view’s title bar, press Pack and Install, the rocket.

You should see:

Where What
The Project view, under Packed archive\pc\mod\my_first_mod.archive and my_first_mod.archive.xl beside it. That is the finished mod
With EDGEdeck A mod called my_first_mod, version dev, in EDGEdeck’s Mods view, switched on and deployed
Without EDGEdeck A line in the status bar saying how many files REDcode installed into the game

If a warning mentions capital letters or spaces, the project’s name has some: see Troubleshooting.

6. Look in the game

  1. Press Run Game, the play button in the Project view’s title bar.
  2. Load a save and open the inventory.
  3. Find the item and hover over it.

You should see the new name.

If Do this
The old name still shows Check that ArchiveXL is installed, and that the game was started after you installed the mod. Then check the language: your text file is for one language, the one chosen in the LocKeys view
The name changed in one place but not another The game has a second entry with the same text. Do steps 2 to 5 for it as well
The game doesn’t start Take the mod out (step 7) and see Troubleshooting
Screenshot comingThe new name in the game
The game's inventory with the renamed item selected, its tooltip showing the new name.

7. Take it out again

Close the game. In the Project view’s title bar, open the ... menu and choose Uninstall.

You should see the mod switched off in EDGEdeck, or a status bar line saying how many files REDcode removed. Start the game again and the item has its old name.

Your project is still there. Pack and Install puts the mod back whenever you like.

What just happened

Step What it was The same step in a bigger mod
Add to Project Onscreens A copy of something from the game, in your project Add to Project on a game file
Changing the text An edit to your copy The CR2W editor, an image editor, Blender, EDGEmat
Pack Your project’s files built into an .archive, the kind of file the game loads mods from The same button
Install The archive put in the game’s archive\pc\mod folder The same button
Uninstall The game back as it was The same menu item

What to try next

Try You’ll use Page
Change an item’s price TweakDB, and a tweak file: a few lines of text Try it: change a price
Change one value in a game file The CR2W editor Try it: change one value
Repaint a texture Export, an image editor, Import Try it: repaint a texture
Find the files behind an item Game Assets, Find Items Finding what you want to change
See changes without restarting the game Pack and Play, with REDnode Pack and Play
Let an assistant do the work Claude Code with EDGEchat Assistants and MCP

Last reviewed 2026-11-13. Something wrong or missing? Tell us on Discord or open an issue.