Skip to content

Using Amarillo's VRM Toolkit ​

I made this extension to be simple to understand at a glance. Using the N-panel, look for the Amarillo drawer. In there you'll see that the addon is divided in 4 steps.

1. Define Your Character ​

Here is where you tell the Toolkit what's the character it will be working with. Select its Armature.

Then here's the interesting bit. The addon needs to understand your character's Humanoid bone structure. As I mentioned before, my character format is based around the VRM format, which depends on Unity's Humanoid avatar system. As such, the addon needs to map all the bones of your character to the Unity's Humanouid bone structure. This process is done automatically for AutoRig Pro and Riggify armatures. For custom armatures you will have to manually assign the correct bones yourself.

Unity has a hard requirement of 15 predetermined bones to consider a Humanoid avatar correctly defined. These are the required bones:

  • Hips
  • Spine
  • Head
  • Left and Right Upper Legs
  • Left and Right Lower Legs
  • Left and Right Feet
  • Left and Right Upper Arms
  • Left and Right Lower Arms
  • Left and Right Hands

Once all your bones are mapped to their Humanoid counterpart, you're done with this section.

2. Prepare Your Character ​

VRM T-Pose ​

The number one requirement for a VRM is for its character to be in a perfect T-Pose. The specific T-Pose the format wants has a predefined orientation for every single bone. Naturally, it would make no sense to do this manually, so you can press the VRM T-Pose > Apply VRM T-Pose button to do this automatically. Don't worry, it won't modify your armature in the least; it will only pose it.

VRM Materials ​

Next come the Materials. The addon will automatically scan your character's Materials on export, while making its best effort to grab the main properties and translate them into the VRM appropriate values. You can imagine how badly this can work for complex characters.

What you should do instead is press the VRM Materials > Scan Character Materials button. It will perform that same scan, but now you'll be able to inspect its results and make the fixes you might need. You'll see a list of Materials, some of them with a little warning sign to their right. This means that the Material wasn't correctly understood by the Toolkit and needs a little human touch from your part.

Now, for simple characters this won't need a lot of work. All you have to do is expand that Material's drawer and either choose the correct Base Color property, or assign the correct Main Texture. For 90% of cases this will be all that's needed.

3. Add Optional Features ​

This will be covered in the Advanced Guide, but suffice it to say that in here you'll find all the extra bells and whistles that will make your character truly pop when loaded into my games.

4. Export Your Character ​

This is the final stretch! You can actually just export your character and call it done by pressing either the "Export VRM 0.x" or "Export .amaCharacter" button. But there are a few final things I need to cover here.

VRM Metadata ​

This sub-section will let you write the name of your character, your own name as its author, and a few other things. Obviously you want your character to have a name, and you want people to know who made it. The model version will be 1.0 by default, feel free to ignore that bit if you want, as nobody really cares.

The thumbnail is something you shouldn't miss though. I made it easy to assign one. You can go the boring way and manually render your character and look for the file itself by pressing "Choose Image", or the cool way by using Window's screenshot shortcut Windows Key + Shift + S, and then pressing the "Copy from Clipboard" button. The addon will take a second to process the screenshot and turn it into the correct format.

Now the Usage Permissions. You have the right to say what others can do with your character. Fill out the appropriate permissions for your case. As for the License, I tipically go with "CC BY NC ND", which lets others copy and share the file without commercializing it or making derivative works with it, while giving you full credits.

And, that's it! You can export the character now and load it in Desktop Pets through the Character Creator. I'll explain how that part of the pipeline works in the next chapter. If you export your character as a VRM, you can also load it into any VTubing app, which is a nice bonus.