To connect Cargo to Blender, first, follow the Basic Software Setup guide. Make sure you're using a supported software version before attempting software setup. Check out our supported 3D software and render engine versions here.
After you have selected your version of Blender, Cargo will install all necessary files to your computer and prompt you to activate your plugin.
To activate your Plugin, first you'll need to enable it by going to:
Edit → Preferences
From the Preferences Window, within the
Addons tab, search for "Cargo" in the search bar on the top right. Click the checkbox next to the
KitBash3D Cargo plugin.
Once the plugin is enabled, open the “N-Tab” on the top right of Blender. You can also use the hotkey “n”.
With the n-tab open, click on the “KitBash3D” add on menu on the right side of the n-tab, then click “Connect” and make sure the checkbox indicates “Connected to Cargo”.
You can now return to Cargo Software Setup and continue to the test asset import!
Before you begin troubleshooting, please make sure you have a supported version of Blender installed on your computer. Cargo currently supports Blender 3.0, 3.1, 3.2, 3.3, 3.4, 3.5, and 3.6. Check out our supported 3D software and render engines here.
1. Check which version of Blender you're using
To find out what version of Blender you are using click on the monochrome Blender logo in the top-left corner and select About Blender
The new window shows the Blender version you are using.
Cargo currently supports Blender 3.0, 3.1, 3.2, 3.3, 3.4, 3.5, 3.6 and 4.0. Cargo does not support versions of Blender installed using the Microsoft store. If you're using a different version than these, you'll need to download an updated version of Blender from www.blender.org
2. Check where Blender is saved on your computer
Cargo looks for Blender in a few different places during the Software Setup process. In order to ensure that Cargo can find your blender.exe file, make sure that is located in one of the directories that Cargo can detect.
Locations Cargo can Automatically Detect
Using Blender installer into the default locations.
Steam installation, versions 3.0-3.6. Additional library folders are supported
You'll need to locate the .exe file for Blender on your computer.
This supports installation from ZIP archive to any location
Note that renamed Blender executables are not supported. It has to be blender.exe
What about Blender installed through Microsoft Store?
Unfortunately, the Microsoft Store installation has been broken for quite some time. It is unknown when access to blender.exe for this installation method will be restored, therefore it is currently not a supported installation method for Cargo.
3. Check that the Cargo Add-On is Installed
If you are using a supported version of Blender but do not see the KitBash3D menu in the N-Tab, check to make sure the plugin is loaded in Blender by going to:
Edit → Preferences → Add-Ons
In this window, search for “Cargo” and ensure the add-on is visible and the checkbox is active.
If Cargo does not show up in your Add-ons menu, you will need to restart Basic Software Setup.
4. Manually Installing the Cargo Add-on to Blender
If you are not seeing the Cargo Add-on show up in your Blender Add-Ons menu, you can try manually installing it. This will only work for the supported versions of Blender.
To do this, open Blender and navigate to Edit → Preferences → Add-Ons
From the Add-Ons menus, click "Install" on the top right. Navigate to the KitbashCargoBlender.zip file saved here:
C:\Program Files\Kitbash3D\Cargo by KitBash3D\resources\plugins\blender
Click Install Add-on
5. Finding problematic add-ons
Sometimes third-party add-ons interfere with the proper functioning of other add-ons like Cargo. If you are using third-party add-ons and you find that Cargo does not work for you, or maybe even doesn’t want to install for you then it can be useful to start from a clean slate.
Possible symptoms of add-ons interfering with Cargo:
Cargo doesn’t detect your Blender installation
Cargo add-on doesn’t show up in preferences after installation
KitBash3D panel in n-panel doesn’t show or doesn’t change state after clicking on it
Open the Edit menu and select Preferences
In the Preferences dialog browse to Add-ons and with select and shift+select choose Community and Testing categories along with Enabled Add-ons Only.
Before you uncheck all add-ons write down a list of all add-ons you have installed and activated.
Proceed to uncheck all the add-ons. Since it isn’t guaranteed that add-ons are properly unloaded make sure you save the changed preferences and restart Blender.
If Cargo can't find Blender during Basic Software Setup and/or the add-on starts working it is likely that one or more add-ons are interfering with the proper operation of Cargo. You can start identifying the problematic add-on by re-enabling each add-on one by one and going through the Basic Software Setup after each add-on in turn until you find the add-on that causes Cargo to fail to recognize Blender or otherwise fail proper Cargo operation.
6. Finding Blender Error Messages in the System Console
In some cases, it can be useful to see the Blender system console. To show this choose Window from the top menu followed by Toggle System Console
The system console doesn’t necessarily pop up on top of Blender, so check the t by mousing over the Blender application icon. It should show the system console window as an entry.
This window can potentially contain error messages that help us diagnose problems. You can copy & paste the contents of this window to share with us.
7. Finding Hardware and Driver Errors
Blender can gather technical information about your system that could help in determining for instance if your system follows hardware and driver recommendations.
Select the Help menu and from that Save System Info
Once you press the Save button in the Blender file dialog you can send the file. It will show the driver and GPU configuration, along with build and install information about the specific Blender version.
8. Stuck at "Initializing Download"
If you get stuck on the screen with the message
Initializing Download... during Advanced Setup, and you have third-party/community add-ons enabled then the following steps should get you unstuck while we're working on a permanent fix.
Please first read the steps below before applying them.
Step 1: Close Blender (all of them)
Step 2: Open File explorer and type
%APPDATA%\Blender Foundation\Blender% in the location bar
Step 3: Navigate into the Blender version folder for which you are trying to setup Cargo for. ie Blender Foundation\Blender\3.5
Step 4: Navigate to the
scripts folder and find the folder named
Step 5: Rename the
addons folder to
addons_temp . This is a necessary step to ensure an Addon does not interrupt the Cargo to Blender connection.
Step 6: Restart Cargo and go through the Software Setup process (via Account if you have set up for other DCCs already). Select advanced setup for Blender and select the blender.exe file from the version of blender you just modified.
Step 7: You should see the Installing Plugin screen now completes. This may take up to 5 minutes. If you do not see the progress bar move after 5 minutes, please contact email@example.com.
Step 8: Follow the remaining steps of software setup until you have the test asset in Blender.
Step 9: Close Blender and move all folders and files inside
addons_temp into the newly created
addons folder. KitBash3D Cargo add-on should already be there.
Step 10: You should be able to open Blender again, and have all your add-ons along with Cargo!