Skip to content

Avatars

Jump to bottom Edit New page
towneh edited this page Dec 12, 2024 · 20 revisions

Creating Your Avatar

Set up the Unity Editor

  • As per the Getting Started section for installing the latest supported Unity editor version and acquiring the Basis framework.
  • Open Unity Hub and add an existing project, choose the extracted/cloned Basis project folder
  • Once the Unity Project has loaded, you can now load your Avatar files:
  • Either,
    • Find 'Assets' in the Project hirarchy, inside 'Assets' right click any empty space and select 'Show in Explorer'
    • Copy in your Avatar files [Mesh/Materials/Textures etc]
  • or
    • Import a .unity package containing your files, from the Assets menu, Import Package > Custom Package
  • Bring back the Unity window and allow the import process to finish

Import Model

  • Find the location of your Avatar model (usually provided in .FBX format).
  • Click the file and then navigate to the 'Model' section of the Import Settings window.
  • Ensure that 'Red/Write' and 'Legacy Blend Shape Normals' are selected as below.

image

  • Navigate to the 'Rig' section of the Import Settings window.
  • Click the 'Animation Type' drop-down menu and select 'Humanoid', press 'Apply' as shown below.

image

  • Afterward the 'Configure' button above 'Apply' is now selectable, click this and then check your bone mappings.

image

  • This should show all mandatory bones as selected, make sure this looks correct for your Armature.
  • Lastly, click on the 'Head' button in the 'Mapping' window and remove the assignment for the 'Jaw', this is usually incorrect.

image

Animators & Eyes

  • The steps above should automatically add an Animator componnent to your Avatar prefab when you pull it in to the Scene.
  • On the Parent gameObject of the Avatar | click 'Add Component' | add 'Basis Avatar'

If you're struggling to find the view ball or indicator for the Eye Position follow these steps:

  • Top Right next to XYZ, click the Eye.
  • Enable "Eye Position Gizmo" inside of the 'Basis Avatar' component.

You should now see a green Gizmo for your eyes, move this up between your eyes, and on the same plane as your eyes

Ensure you have assigned each of the following:

  • Animator
  • Face Viseme
  • Face Blink
  • Avatar Name
  • Avatar Description

Jiggles (Optional)

To add Jiggle Physics:

At the very bottom of 'Basis Avatar' you will find 'jiggle configuration'

  • Click 'Add New Basis Jiggle Strain'

A new 'Jiggle Strains' dropdown will appear below it, follow the dropdowns until you see settings

  • Ensure to add a 'Root Transform'

Eye & Face Tracking (optional)

Integrating VRCFT to drive bone rotation via OSC:

<This section will cover usage of Hai's instructions later on>

Build the AssetBundle

  • Choose from the 'Basis' drop-down menu, the 'Build AssetBundle From Scene' option.

image

  • The results will be opened automatically as shown below.

image

Test the Avatar

  • Once the AssetBundle has been created then you can load this via the 'BootManager' prefab found at 'Assets > Prefabs > Boot'.

image

  • You can place the location of the new AssetBunndle under the 'Meta URL' & 'Bundle URL' fields, along with the 'Unlock Password' provided in the 'dontuploadmepassword.txt' file generated at in the '/AssetBundles/' directory.
  • Make sure to tick 'Is Local' if the file is not a URL.

image

  • Load the 'Initialization' scene from 'Assets > Scenes', and then hit Play.

Uploading Your Avatar

This Example uses Google Drive

Upload the Bundle File & Meta File to Google Drive, or any hosting provider that allows direct links to files without login.

  • Create a Folder on your Drive and set its sharing settings to Anyone with the link.

Now when you drag your files into this Folder, you will not individually need to set that permission

  • Click the Hamburger Menu on the Top Right of the asset you have just uploaded into the folder.
  • Find Share and click Copy Link

Do this for both files

We will need to look into the URL to grab the information we need

Example:
https://drive.google.com/file/d/YourIDBringsAllTheLagToMyYard/view?usp=sharing
We want to copy the unique identifier inside of the URL, and add it to the following:
https://drive.google.com/uc?export=download&id=
Example:
https://drive.google.com/uc?export=download&id=YourIDBringsAllTheLagToMyYard

Do this for Bundle & Meta File.
DO NOT UPLOAD YOUR GENERATED PASSWORD FILE OR SHARE IT

Load up Basis, open the menu select Avatars
Paste the Meta Link into the Meta field.
Paste the Bundle Link into the Bundle field.
Paste your SUPER SECRET ENCRYPTED PASSWORD into the Password field.

Load! 🥱

Footer to edit

Add a custom sidebar
Clone this wiki locally