AM4 Blender add-on allows you to integrate Unity Cloud Asset Manager service within your Blender workflows. This repository open sources the code of that add-on, so that you can get inspired by it or build on top of it - to create your own custom Asset Manager integration flows for Blender or any other software.
Note: This repository does not accept pull requests, review requests, or any other GitHub-hosted issue management requests.
To connect and find support, join the Help & Support page!
- Asset Manager for Blender
To build the AM4 Blender add-on, you need Python 3.x installed on your machine.
To install and use the AM4 Blender add-on, you need:
- Blender 3.x installed on your machine
- The right permissions to use Asset Manager. See Get Started with Asset Manager for more details.
AM4 Blender is compatible with:
- Windows x64/Arm64
- Mac x64/Arm64
The Unity Cloud Asset Manager for Blender repository is made available under the GPL v2 license.
Run the pack-addon.py
script to create a ZIP file that can be installed in Blender as a plugin.
cd .\Scripts
python pack-addon.py (-dw | -lw [LOCAL]) [-n NAME] [-o OUTPUT] [-os {windows,macos,all}]
Option | Description |
---|---|
-dw, --download |
Download Unity Cloud Python SDK dependency. |
-lw [LOCAL], --local [LOCAL] |
Specify a local folder to copy Unity Cloud Python SDK dependency from. |
-o OUTPUT, --output OUTPUT |
Specify a folder to save the add-on archive in. By default, will create a Dist folder at the root of the repository. |
-os {windows,macos,all}, --system {windows,macos,all} |
Specify target platform. By default all . |
To install the add-on, follow these steps:
- Open Blender.
- Go to Edit > Preferences.
- Go to the Add-ons section.
- Select Install.
5. Select the UCAM4Blender.zip
file that you built, then select Install Add-on.
6. Check the checkbox to enable the add-on. The Unity Cloud
tab appears in your 3D view.
Follow these steps if is the first time you run the add-on or you have previously logged out (See Logout from Unity Cloud Asset Manager for information about logout). Otherwise, add-on will automatically log in using the previous session.
- From your 3D view, go to Unity Cloud > Login.
Note: You will be automatically redirected to the Unity login page. Make sure you complete the login process, until you are redirected to the following page.
- Go back to Blender.
- Ensure you are logged in to Asset Manager (See Login to Unity Cloud Asset Manager for more information about login).
- From your 3D view, go to Unity Cloud > Upload FBX to Asset Manager.
- You should now see the
Upload FBX to Asset Manager
popup.
- Select a target organization and a project. If you don't have one, you can refer to the create a new project guide.
- Ensure
<Create new asset>
option is selected inAsset
dropdown. - Enter the new asset name, description and tags. As part of the upload process, this information will be assigned to the asset.
Note: To add multiple tags, simply separate them with a space in-between.
- Check
Embed textures
option to export fbx with textures. This will set path mode toCOPY
, otherwise it will be set toAUTO
. - Select OK.
Note: Once the uploading is complete, you are automatically redirected to the Asset Manager dashboard, so that you can perform additional edit and publish operations from there.
- Ensure you are logged in to Asset Manager (See Login to Unity Cloud Asset Manager for more information about login)
- From your 3D view, go to Unity Cloud > Upload FBX to Asset Manager.
- You should now see the
Upload FBX to Asset Manager
popup.
- Select a target organization and a project. If you don't have one, you can refer to the create a new project guide.
- In
Asset
dropdown select the asset you want to update. Add-on will fetch asset name, asset versions, description and tags.
Note: During uploading, any existing files in the asset will be removed.
-
Select the version you want to update. If you select a frozen version (which will be indicated as "Ver.1", "Ver.2" and so on), a new pending version will be created off of it. Selecting a pending version (which will be indicated as "Ver.0" or "Ver.X-Pending-{creation-date}") will simply update it.
-
Change the asset name, description and tags, if needed. As part of the upload process, this information will be assigned to the asset.
Note: To add multiple tags, simply separate them with a space in-between.
- Check
Embed textures
option to export fbx with textures. This will set path mode toCOPY
, otherwise it will be set toAUTO
. - Select OK.
Note: Once the uploading is complete, you are automatically redirected to the Asset Manager dashboard, so that you can perform additional edit and publish operations from there.
- From your 3D view, go to Unity Cloud > Logout. Note, this option is only available when you are logged in.
Note: Once logout completes, you will be automatically redirected to the following page.
- Go back to Blender.
Part of the add-on building process requires to download the Unity Cloud Python SDK dependency. Python 3.x does not rely on MacOS' openSSL ; it comes with its own openSSL bundled and doesn't have access on MacOS' root certificates.
To solve this issue, you have two options:
1) Run an install command shipped with Python 3.x
cd /Applications/Python\ 3.x/
./Install\ Certificates.command
2) Install the certifi package
pip install certifi
When building the add-on, the -dw
option does not perform any integrity protection step while downloading the Unity Cloud Python SDK.
Thank you for taking a look at the project! To help us improve and provide greater value, please consider providing feedback in our Help & Support page about your experience with AM4 Blender. Thank you!