Skip to content

Latest commit

 

History

History
100 lines (58 loc) · 3.67 KB

README.md

File metadata and controls

100 lines (58 loc) · 3.67 KB
Raw
description
Install guide

Installing the Wolvenkit Blender Plugin

Summary

Published: ??? by manavortex
Last documented update: Nov 29 2024 by manavortex

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.md instead.

Compatibility

{% include "../../../../.gitbook/includes/wkit-blender-plugin-current-version.md" %}

Step 0: Uninstall the old version

{% hint style="info" %} If you never installed a previous version of the plugin, you can go straight to #step-1-install-the-plugin {% endhint %}

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

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.0\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.

{% hint style="success" %} Optional: Close and re-open Blender {% endhint %}

Step 1: Install the plugin

{% hint style="info" %} If you want to install the current development version of the plugin, read installing-from-github-source.md. {% endhint %}

Download the latest release of the plugin from github:

  1. On the 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:

Do not download anything called "Source code", unless you know what you're doing

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

  1. 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:

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\3.6\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.