Update Avastar

logo_tiled

From time to time Avastar provides new versions to keep up to date with Second Life and Blender. We assume that you also want to keep up to date and you update your Avastar installation as well.

However the implementation of the Avastar Rig itself also changes over time. This article describes what you need to do to get your Avastar updated and work with your “old” rigs in the new environment.

Update the Avastar Software

Updating Avastar is as simple as:

  • Download the newest Avastar version
  • Update Blender to the most current release
  • Install Avastar
Hint: Sometimes The Update creates an error Message about some missing Modules. If that happens to you, please follow the when the update fails guide below.

when the update fails

When you update an Addon in Blender, then normally the following steps are performed:

  1. The installer disables the current version of the Addon.
  2. The disabled addon is removed from the system (deleted from disk),
  3. The new Addon version is installed.
  4. You now can enable the new version manually

However sometimes the first step (disabling the Addon) does not disable all of the software. So it may happen that the old Addon 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:
    remove_02
  • 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 Addon search field to locate your Addon
  • Then Enable the Addon

In most cases this is all that you need to do. The Addon 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 Addon Panel:

remove_01

Step 2: Save User Settings

You find the Save User settings Button at the bottom of the User Preferences Window:

remove_02

Step 3: Restart Blender and Install the new Avastar Addon

Proceed by installing your Addon:

Install

Update your Models

The Problem:

Whenever you create an Avastar in a scene, then a fresh character is created with its own meshes and its own Armature. So, when you upgrade to a newer version of Avastar, then the Rig is not upgraded automatically. This may result in compatibility issues.

The solution

We have included the Rig Upgrade Tool into Avastar. This Tool will take your Avastar model and migrates the Armature to the newest Avastar version in place. Below you find the Tool Help Page.

The Rig Transfer Tool

The Rig Transfer tool has been added as a convenience tool for users who have to reopen old Projects with newer Avastar versions. Also users who want to migrate from the simple SL rig to the Avastar Rig find this tool helpful. And finally Creators who use mesh templates (SDK’s) from other creators may find this tool of value. The tool has 3 usage modes:

Convert non Avastar rig to Avastar

This mode is entered when you have selected an arbitrary (not Avastar) Armature or one or more mesh Objects which are bound to an armature. In that case the conversion tool offers to Convert the Armature “in place”:

  • The original Armature will be deleted
  • A new Avastar Armature will be created
  • The assigned mesh objects will be moved to the new Avastar.
  • For the additional options see below
wf_08

Convert a non Avastar Rig to Avastar (in Place)

This tool makes it also possible to integrate Mesh development kits from other creators into the Avastar Rig. Please watch the Demo video to see this option in action

Converting the Belleza Development Mesh

Th Belleza Developer Dummy can not be converted fully automatic because it has its arms in A-Pose. For Avastar 1.6 we have added a very easy way to convert this mesh to Avastar.

But for the current release (Avastar-1.5-9) you have to go through a rather lengthy process:

  1. Select only the Armature and delete it (in object mode)
  2. Select the Mesh and open its Modifier Stack
  3. Delete the Armature Modifier
  4. rotate around the z-axis by 90 degree: z -90
  5. go to front view the mesh should now look at you
  6. in the properties sidebar (‘n’ sidebar) in the Transform Section locate the Scale panel
  7. set scale for all 3 axes to 1.0 (it is currently set to 0.01) (DO NOT APPLY SCALE, SET IT MANUALLY to <1,1,1> ! )
    Now the mesh becomes 100 times bigger(!)
  8. Below the Scale panel you find the Dimensions panel. Check that the mesh is about 1.753 blender units high. If this is not the case, then you made something wrong. Check the previous steps. Something has gone wrong there.
  9. Select the Belleza Mesh and Apply Rotation (from within the 3D View toolbar)

Make sure that you have prepared your Mesh as described above. Only then proceed!

  1. Add a new Avastar character
  2. go to pose mode
  3. Rotate ShoulderRight/Left by 45 degrees (into a pose)
  4. set the avastar sliders as follows:
    1. Height: 52
    2. Head size: 72
    3. Eye Spacing: 50
    4. Neck Thickness: 67
    5. Shoulders: 56
    6. Breast Bouancy: 44
    7. Breast Cleavage: 19
    8. arm length: 51
    9. Torso length: 51
    10. Leg Length: 52
    11. Butt size: 30
  5. Hide the Avastar meshes (or delete them if you prefer)
  6. In the tool shelf set the SL Rigging Style to “Fitted Mesh”
  7. In object mode select the Belleza Mesh and the Avastar armature
  8. In the Skinning Panel: Select weight: Keep
  9. Enable the “Alter to Restpose” option
  10. Bind to Armature
  11. Select the armature
  12. in Appearance Control Enable “SL Appearance”

Now the Appearance sliders should work and the Belleza Mesh is rigged to Avastar.

Update old Avastar Rig to newest version

This mode is entered, when you have selected an older version of an Avastar Armature (by opening an older project blend file for example) or you selected a mesh that is bound to an older Avastar Armature. In that case the conversion tool offers to Update the Armature “in place”

  • The original Armature will be deleted
  • A new Avastar Armature will be created
  • The assigned mesh objects will be moved to the new Avastar.
  • All possibly edited Bones (Joints) will be transferred.

Update an Old Avastar Rig to the newest Version (in Place)

Copy an Armature to an existing Avastar

This mode is entered, when you have selected 2 armatures, of which the active Armature is either an outdated Avastar armature or an arbitrary non Avastar Armature, and the other armature is a new Avastar Armature. In that case the conversion tool offers to Copy the Active Armature’s configuration to the other selected Armature:

Copy Avastar to Avastar

  • The original Armature will be kept
  • All possibly edited Bones (Joints) will be transferred
  • For the other options see below
wf_20

Copy an (old) Avastar Rig to another Avastar Rig

Copy SL Compatible Rig to Avastar

  • The original Armature will be kept
  • The assigned mesh objects will be copied to the Avastar.
  • For the other options see below
wf_19

Copy an SL compatible Rig to an Avastar Rig

Options

Dummies:
This option controls the Avastar Meshes in the Target Armature. Depending on the use case you will want Avastar to handle these meshes differently :
  • Keep: Use for Mesh Attachment creation
  • Hide: Use for Human Character Creation
  • Delete: Use for non Human character Creation
Transfer Joints (only in Copy Mode)
When your Armature has been edited, then you need to copy the modified bones to the Target Armature. Functionally all that is needed is to transfer the relative position of the bone joints.
This option only shows up when the Source Armature is not an Avastar Armature. The option is not necessary for Avastar to Avastar copies because for that case the joints are always adjusted automatically.
Transfer Meshes(only in Copy Mode)
You might want to only copy the Armature settings to the Target Armature
This option only shows up when the Source Armature is an Avastar Armature. The option is not necessary for Migration copies (from non Avastar Rigs to Avastar) because we assume for that case that all visible Meshes have to be migrated as well.