To connect Cargo to Blender, first, make sure you're using a supported version of Blender before attempting software setup.

Check out our supported 3D software and render engine versions here.

Ensure Blender is completely shut down and follow the Basic Software Setup guide:

To activate the Cargo plugin within Blender, 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”.

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, 3.6, 4.0, 4.1 and 4.2.

Blender versions must be installed using English as the display language.

Check out our supported 3D software and render engines here.

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

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.

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

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:

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.

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.
​

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

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 addons.

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 info@kitbash3d.com.

Step 8: Follow the remaining steps of software setup.

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!

First, ensure you're using a supported version of Blender.

Note: Cargo does not yet support Blender 4.3.

Completely removing all associated Cargo files will ensure that a reinstallation of Cargo is successful at resolving your issue.

If the above steps do not allow you to import an asset into Unreal, locating and sending the logs from the dates you experienced the issue will be helpful for the team to see what's going on behind the scenes.
​

Take the below steps

Email info@kitbash3d.com

Once our team is able to review the logs, we'll get back to you with more information about the issue you experienced.

​