About this Document...
Initial Check of operability
The Video guides you through the process from downloading Blender up to verifying that you have installed the software.
What does Avastar provide?
Avastar basically supports the creation of animatable Models (Avatars&attachments) and the creation of animations. Therefore the tool adds various functions and user interface elements to Blender.
The full functionality of Avastar can be a bit overwhelming on first sight. You should be prepared to spend some time and patience to get it all working nicely for your projects.
What does this Document provide?
abstract: I show you how you can install Avastar on Blender 2.70 or newer. We provide a short video which shows the installation process step by step.
We expect that you have basic knowledge about Blender.
Where to go after Installing ?
- Install Blender Ensure you install at least Blender 2.70, we recommend to always use the most recent Version of Blender
- Purchase Avastar: If you already have purchased Avastar, you will find all released updates of the software in your Machinimatrix Download folder (see next step)
Q: What do i need to get started ?
Download the Avastar zip file and place it anywhere on your local disk, and remember where you placed this file.
Unpacking the zip file will result
in installation failures!
(See also below)
Q: Where is my download ?
During your purchase you have received a download link.
You received the Download link on the local Chat window.
You received the download link via E-mail.
If you are a registered user …
then please login now. Then open the download link that you got from us. You will be automatically forwarded to your product download page and your new product will be listed there.
If you are not a registered user, …
then you still can open the given download link. You will then be redirected to a temporary download page from where you can download the software.
However, the download link will become invalid 8 days after purchase.
Q: Where does my software run?
The Avastar Add-on runs wherever Blender runs. You only have to ensure that Blender is installed properly. Then the Add-on will be working as well.
Q: Expand Add-on or keep the zip file?
Blender Add-ons are always installed in zip format. All attempts to install the unzipped files will fail. So to ensure that your computer does not unzip the file after download, please review your browser settings.
For Mac Users:
If your Browser automatically expands the Zip file during download, then please do this:
- Open the safari preferences
- On the General tab:
- Uncheck “Open safe files after downloading”
Q: Is there an Archive of older Releases?
Yes, we keep older releases available for the case where you find something broken in the newest product release. The older releases are collected in a the_archive sub folder within your Download Folder.
Q: What does the Avastar Filename say?
We are often asked why the zip file is named as it is named. There is a reason. Here is the explanation:
- avastar: the product name
- M: The major product release
- m: The minor product release
- rrrr: The product revision number
- B-bb: The earliest version of blender supported by this particular Add-on version
Usually you are safe to download the zip file with the highest available product revision number.
Only if you encounter a bug in Avastar you should consider to switch back to an older Avastar release by installing that over your current release. There is no need to uninstall first!
We expect that you have successfully installed Blender and Blender works properly. Now start Blender and…
If you fail to install as described here, first check with the SL Chat Group Blender Avastar and only if that does not help then please report back to us.
- Navigate to File -> User Preferences:
- Proceed to the “Add-Ons” Tab
- At the Bottom of the Tab locate and click “Install from File…”
Some details ...
- If the Avastar Add-on Panel is collapsed, then please expand it now to see the Add-on details, see (2) in the image. Please take a closer look! You find some important information here.
Important: Please make use of the documentation! This will save you (and us) a lot of time!
- To enable the Add-on you must check the checkmark at the top left corner of the panel (See (3) in the image
- In the last step you Save User Settings as your new default settings, see (4) in the image
You can verify that Avastar has been successfully installed by navigating to the new Avastar menu entry in the Add section. Please ensure that you are in Object mode as that is the only mode from where you can add new Avastar characters:
Welcome to Avastar
Where to go next ?
First aid when things go wrong
Installation & Update Issues
DLL load failed: %1 is not a valid Win32 application
This happens on Windows when your Blender Application Data folder is corrupted. We never found a good reason for when this happens, but it does happen.
Clean up your Application Data. You find the data here:
Sometimes another Add-on installation pollutes the Application data folder with scripts and libraries from older blender versions. This can easily make it impossible to install another Add-on. We ensure that our Add-ons never creates such sort of pollution. And here is how you can get out of this issue:
- Locate the Blender Application data folder (see above)
- within the folder locate the subfolder that is named like your Blender release, for example:
- rename this folder to something like
Note: The name is not important, use whatever is convenient for you. You even can delete the folder if you like, but see below!
- Now restart Blender
This will cleanup your application data folder. But take care! This resets blender to its Factory settings. Any other Add-on that you have installed is no longer visible and you need to install them again. However you can use the hidden subfolder ( 2.77_hide in my example) to recreate your installation. Although in most cases it seems easier to install all of your Add-ons again.
When the update fails
When you update an Add-on in Blender, then normally the following steps are performed:
- The installer disables the current version of the Add-on.
- The disabled Add-on is removed from the system (deleted from disk),
- The new Add-on version is installed.
- You now can enable the new version manually
However sometimes the first step (disabling the Add-on) does not disable all of the software. So it may happen that the old Add-on leaves some traces which may result in subsequent errors when the new version is enabled in step 4.
When the above situation happens to you, then please proceed as follows:
Step 0: Remove traces
- Save User Setting at the bottom of the User Preferences Panel:
- Then close Blender
It is important that you really close blender.
Opening a new scene or pressing F8 are not enough!
- Open Blender and open the User preferences again
- Type “Avastar” into the Add-on search field to locate your Add-on
- Then Enable the Add-on
In most cases this is all that you need to do. The Add-on will enable without errors.
If the above procedure does not work for you, then you need to put blender into a clean state as follows:
Step 1: Remove Avastar
You find the Remove Button in the expanded Avastar Add-on Panel:
Step 2: Save User Settings
You find the Save User settings Button at the bottom of the User Preferences Window:
Step 3: Restart Blender and Install the new Avastar Add-on
Proceed by installing your Add-on: