# Installing the Wolvenkit Blender Plugin

## Summary

**Published:** ??? by [mana vortex](https://app.gitbook.com/u/NfZBoxGegfUqB33J9HXuCs6PVaC3 "mention")\
**Last documented update:** Nov 29 2024 by [mana vortex](https://app.gitbook.com/u/NfZBoxGegfUqB33J9HXuCs6PVaC3 "mention")

This page will show you how to install the Wolvenkit Blender Plugin from a github release or tag. If you want to install the bleeding edge, please check [installing-from-github-source](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators-theory/modding-tools/wolvenkit-blender-io-suite/installing-the-wolvenkit-blender-plugin/installing-from-github-source "mention") instead.

### Compatibility

<table><thead><tr><th width="289"></th><th></th></tr></thead><tbody><tr><td>Blender version</td><td><a href="https://www.blender.org/download/">5.0</a></td></tr><tr><td>Plugin version</td><td><a href="https://github.com/WolvenKit/Cyberpunk-Blender-add-on/releases/tag/1.8.0">1.8.0</a></td></tr><tr><td>Wolvenkit version</td><td>>= 8.17.1 <a href="https://github.com/WolvenKit/WolvenKit/releases/tag/8.15.0">stable</a> | <a href="https://github.com/WolvenKit/WolvenKit-nightly-releases/releases">nightly</a> (<a href="https://app.gitbook.com/s/-MP_ozZVx2gRZUPXkd4r/getting-started/download#downloading-wolvenkit">install guide</a>)</td></tr></tbody></table>

## Optional: Uninstall the old version

{% hint style="info" %}
You don't need to do this unless you have trouble updating. Go straight to [#step-0-download-the-plugin](#step-0-download-the-plugin "mention")
{% endhint %}

<details>

<summary>Uninstalling the previous plugin version</summary>

1. Open the Blender Preferences (Toolbar: `Edit` -> `Preferences`) and select the `AddOns` tab

<img src="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-436bc96b28b06b3c97d18bb600cf408f0470eaad%2Fblender_plugin_uninstall.png?alt=media" alt="" data-size="original">

2. Complete either of the options below:
   * Click the `Remove` button\
     The build-in Blender way. Should work. If it doesn't check the second option
   * Delete the files on your disk\
     Check the plugin's `file` entry. It will usually be something like this:

```
%APPDATA%\Blender Foundation\Blender\4.3\scripts\addons\i_scene_cp77_gltf
```

Navigate there with your Windows Explorer (Hotkey: `Windows+R`, paste the path above after changing your Blender version), and delete everything — either the entire folder, or all files inside.

3. Optional: Close and re-open Blender

</details>

## Step 0: Download the plugin

{% hint style="info" %}
If you want to install the current development version of the plugin, read [installing-from-github-source](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators-theory/modding-tools/wolvenkit-blender-io-suite/installing-the-wolvenkit-blender-plugin/installing-from-github-source "mention") (NOT for beginners)
{% endhint %}

Download the latest release of the plugin from **github:**

1. On the [releases](https://github.com/WolvenKit/Cyberpunk-Blender-add-on/releases) page, find the most recent release
2. Scroll past the change notes to the **Assets** section
3. Download the zip file with the plugin:

<figure><img src="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-efd01e3574f4ea7d76fad75c68484a113196381f%2Fblender_plugin_download.png?alt=media" alt=""><figcaption><p>Do not download anything called "Source code", unless you know what you're doing</p></figcaption></figure>

## Step 1: Install the plugin

1. Start Blender
2. Open the Blender Preferences (Toolbar: `Edit` -> `Preferences`) and select the `AddOns` tab

<figure><img src="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-a37f08285bee471c77e40dd8dcf278254eb0e7e6%2Fblender_plugin_install..png?alt=media" alt=""><figcaption></figcaption></figure>

3. Click the "Install" button and select the zip file you downloaded in step 2

## Step 2: Enable the plugin

{% hint style="info" %}
You only need to do this if you never installed the plugin before.
{% endhint %}

After you have successfully installed the plugin, you can now use the search bar to find it:

<figure><img src="https://1427525421-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F4gzcGtLrr90pVjAWVdTc%2Fuploads%2Fgit-blob-7ead4c1fe67f4fbcb6dfc0ce5163a84dcb5389fa%2Fblender_plugin_enable.png?alt=media" alt=""><figcaption></figcaption></figure>

Make sure the box is checked and restart Blender.

## Troubleshooting

### I can't (un)install the plugin!

You can do both by hand. Find your Blender install's plugin folder, the path will look something like this (replace 3.6 with your Blender version):

```
%APPDATA%\Blender Foundation\Blender\4.3\scripts\addons
```

Inside the plugins folder, the Wolvenkit Blender IO Suite will be installed to the subfolder `i_scene_cp77_gltf`.

To **uninstall** the plugin, **delete** the entire folder.

To **install** the plugin, **find** the folder in your **downloaded zip file** that contains the file **`__init__.py`**, move it here, and rename it.

Now, **restart Blender**.