# WolvenKit Projects

## What is a WolvenKit project?

To access most WolvenKit features, it's necessary to create a Project first. Projects are primarily used to separate and organize source and game files into distinct directories. Each project can be thought of as the source code for any given mod.

{% hint style="info" %}
Check [asset-browser](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/editor/asset-browser "mention") -> [#adding-files-to-projects](https://wiki.redmodding.org/wolvenkit/editor/asset-browser#adding-files-to-projects "mention") to learn about adding files.
{% endhint %}

## Create a new WolvenKit mod project

You have two means of creating one: 

* From the [menu](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/menu "mention"): [#file](https://wiki.redmodding.org/wolvenkit/menu#file "mention") -> [#new-project](https://wiki.redmodding.org/wolvenkit/menu#new-project "mention")
* From Wolvenkit's [Home](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/home) view via the Create New Project button

You will see something like this:

<figure><img src="https://4106170459-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MP_ozZVx2gRZUPXkd4r%2Fuploads%2FqB1OKoEwqAHDnbt6TGSG%2Fwolvenkit_new_project.png?alt=media&#x26;token=4bfaa3a7-c454-4f3f-90e1-cd147a096a09" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="180">Field</th><th>explanation</th></tr></thead><tbody><tr><td>Project name</td><td>The name of your mod. This will only be used internally, so name it what you lke.</td></tr><tr><td>Creation location</td><td>The location where you keep your Wolvenkit projects. A subfolder with the project name will be created automatically. <br><br>Do <strong>not</strong> put this in your game directory!</td></tr><tr><td>Mod name</td><td><p>name of your .archive or redmod folder. </p><p></p><p>This should be unique, as this will be used to generate your mod's structure, and it would be awkward to overwrite someone else's mod. <br><br>Although special characters are supported, it's a good habit to avoid them.</p></td></tr><tr><td>Author name</td><td>Optional — What it looks like - who made this?</td></tr><tr><td>Email</td><td>Optional — can people send you mails about your mod? </td></tr><tr><td>Version</td><td>Optional — if you want to maintain versioning yourself</td></tr></tbody></table>

Click **Finish.** WolvenKit will now open the new project and proceed to the [**Editor**](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/editor)**.**

### How it looks like:

{% hint style="info" %}
To learn more about the [**Editor**](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/editor), please check the corresponding wiki page.
{% endhint %}

<figure><img src="https://4106170459-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MP_ozZVx2gRZUPXkd4r%2Fuploads%2FGIQ6iQ3QhicWOuddHw79%2Fwolvenkit_ui.png?alt=media&#x26;token=8e348570-0ed6-4d1c-aeff-b932151eb506" alt=""><figcaption></figcaption></figure>

## Opening an existing WolvenKit mod project

1. From the [**Menu**](https://wiki.redmodding.org/wolvenkit/menu#new-project) or the [**Home**](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/home) page, click the "Open Project" button
2. Select a .modproj file to open with WolvenKit
3. WolvenKit will now open the project and proceed to the [**Editor**](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/editor)

## File structure explained

Your project will contain the following folders:

<table><thead><tr><th width="238">Folder name</th><th>Explanation</th></tr></thead><tbody><tr><td>source</td><td><p>This is where your mod's <strong>unbundled</strong> files are. </p><ul><li>Game resources under <code>archive</code></li><li>control files in <code>resources</code></li><li>exported files that you're modifying in <code>raw</code> </li></ul></td></tr><tr><td>packed</td><td>Contains both the control files and the bundled archive files inside their folder hierarchy. You can copy this directly to your game directory (or have Wolvenkit do it for you via Install).<br><br>This folder will be deleted and re-created every time you install or pack your mod. </td></tr></tbody></table>

### Subdirectories in source

Your Wolvenkit project will have several folders inside of `source`.&#x20;

As of 8.9.1, these are:

#### Archive

**Location:** `your_wolvenkit_project/source/archive`

This directory contains game files in the REDengine [**CR2W**](https://wiki.redmodding.org/wolvenkit/help/glossary#cr-2-w) format, which you can add via [**Asset Browser**](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/editor/asset-browser)**.**&#x20;

Everything in this folder will be packed into your mod's .archive file.

#### Raw

**Location:** `your_wolvenkit_project/source/raw`

This is your working directory. Keep any files here that you don't want to end up on Nexus.

When you [export files](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/usage/import-export) via Wolvenkit, the exports will be placed in a [mirrored folder structure](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/import-export#file-structure-the-raw-folder). Unless you import them again, they will not affect your mod's content.\
\
You can keep .blend and texture files here.

#### customSounds

A directory for custom sound files.

#### Resources

**Location:** `your_wolvenkit_project/source/resources`

This folder contains other files for your mod.&#x20;

Any of its contents will be [packed](https://wiki.redmodding.org/wolvenkit/menu/toolbar#pack-mod) so that they extract directly into the Cyberpunk directory. For that reason, you (or Wolvenkit) should create the following subdirectories:

|                                                                                                                                              |                                                        |
| -------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------ |
| script (.reds, [RedScript](https://app.gitbook.com/s/4gzcGtLrr90pVjAWVdTc/for-mod-creators-theory/references-lists-and-overviews/scripting)) | r6/scripts                                             |
| tweaks (.yaml, [TweakXL](https://app.gitbook.com/s/4gzcGtLrr90pVjAWVdTc/for-mod-creators-theory/core-mods-explained/archivexl))              | r6/tweaks                                              |
| CET (.lua, [Cyber Engine Tweaks](https://wiki.redmodding.org/cyber-engine-tweaks/))                                                          | `bin/x64/plugins/cyber_engine/tweaks/mod/your_mod_dir` |

## Project naming and mod load order

{% hint style="info" %}
For more details on [Archive files Load Order](https://app.gitbook.com/s/4gzcGtLrr90pVjAWVdTc/for-mod-users/users-modding-cyberpunk-2077/load-order "mention"), see the yellow wiki
{% endhint %}

If your mod contains an `.archive` file, then it will have the same name as your Wolvenkit project. Since `.archive` files will be loaded in alphabetical order (ASCII):

<figure><img src="https://4106170459-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MP_ozZVx2gRZUPXkd4r%2Fuploads%2FJ7IAaw7SEdYkWNCWeT4V%2Fimage.png?alt=media&#x26;token=acfd4e9c-7c2c-4a11-89fc-6bbef5211eec" alt=""><figcaption><p>Source: <a href="https://www.academia.edu/19644191">https://www.academia.edu/19644191</a></p></figcaption></figure>

If you are creating a **compatibility mod** (something that modifies the files of another installed mod), then yours needs to load **first**.

For example, if you want to do a custom recolour of the mod [`_ArchiveXL_Netrunner_Variants.archive`](https://app.gitbook.com/s/4gzcGtLrr90pVjAWVdTc/modding-guides/items-equipment/recolours-and-refits), then your Wolvenkit project could be named `_00_ArchiveXL_Netrunner_Variants`, or `_ArchiveXL_Netrunner_00_Recolour`.

## Building a mod project

{% hint style="info" %}
For full documentation of the [toolbar](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/menu/toolbar "mention")and the [menu](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/menu "mention"), see the corresponding wiki pages.
{% endhint %}

From the [**Menu**](https://wiki.redmodding.org/wolvenkit/menu#new-project) click on the [**Pack Project**](https://wiki.redmodding.org/wolvenkit/menu#pack-project) butto&#x6E;**.** The [**Log**](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/editor/log) will display a result to indicate packing was successful. All files within the **archive directory** of the [**Project Explorer**](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/editor/project-explorer) will now be packed into archive format. The packed files can be found in the **packed** (`.../modname/packed`) directory of the mod project.

## See also

{% content-ref url="../editor/project-explorer" %}
[project-explorer](https://wiki.redmodding.org/wolvenkit/wolvenkit-app/editor/project-explorer)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.redmodding.org/wolvenkit/wolvenkit-app/usage/wolvenkit-projects.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.