For VRChat avatars · Free Blender add-on

Bring the avatar you bought into Blender, textures and all.

Drag a .unitypackage from BOOTH or elsewhere* onto Blender. No Unity needed: bones and facial shape keys stay intact, and the materials come in looking close to lilToon or Poiyomi.

Free No Unity required Never runs scripts from the package Blender 4.2 and later

* Whether you may use or edit an asset in Blender depends on that asset's license. Please follow its terms.

An avatar imported into Blender from its FBX alone: its texture is not found, so the whole model is solid pink The same avatar imported with this add-on, with textures and colors on the hair and kimono Plain FBX import With this add-on
Drag to compare. Left: the FBX imported on its own. Right: the same package through this add-on.Model: Tohoku Zunko © SSS LLC.
Sound familiar?

You just want to see it in Blender, but…

  • First you have to install Unity and set up a project
  • You import the FBX and get a plain white model
  • Reconnecting materials and textures one by one is a chore
  • You fix shadow colors and rim light by hand, comparing with Unity

All of that comes down to one drop

With this add-on

  1. Drag the .unitypackage onto Blender

Bones, facial shape keys, textures and materials all come in together. Drop several packages at once, such as a base avatar and an outfit.

That is the whole operation: drop the package and press Import in the popup.
What you can do

Start on these right away in Blender

Blender in Edit Mode showing the wireframe of an imported avatar's face and arms, with the front of the kimono selected

Check the shapes before you edit

Open outfit and accessory meshes in Edit Mode to check their shape and how dense the wireframe is. Preview before you edit, all without opening Unity.

The avatar sitting on a rock by a pond and smiling, rendered in EEVEE with a blurred background

Make illustrations and thumbnails

Pose the avatar and render it in EEVEE for announcement images, thumbnails or a picture for social media, with the toon look intact.

An interior asset made for Unity, rendered in Blender: a potted plant, a mug and a TV remote on a wooden table next to a lit lamp

Props and world assets, too

Standard and URP materials are converted to Blender's standard shader, so furniture and props sold for Unity can go into your Blender scenes.

Whether you may edit an asset or publish renders of it depends on that asset's license. Check its terms first.

What comes through

Everything your avatar needs comes in together

Bones (armature)Ready to pose as soon as it lands.
Facial shape keysBlinks and mouth shapes work as they are.
TexturesThe images each material uses are extracted and connected for you.
Shadow color, MatCap, rim lightRebuilt as nodes close to the original toon look.
Transparency and cutoutHair tips and lace stay see-through.

Supported shaders

lilToon Poiyomi MToon VRM VRChat Mobile Quest Standard URP HDRP

Other shaders are converted as far as their common setting names allow. Models can be FBX, OBJ, glTF, VRM or Collada.

See which settings carry over for each shader
Profile
lilToonShadow colors, border and blur, MatCap, rim light, emission, outline
Profile
MToonVRM's toon shader, including shade color and MatCap
Profile
PoiyomiToon lighting with shadow strength, gated emission, reflection-aware metallic, outlines
Profile
StandardBuilt-in PBR: albedo, metallic, smoothness, normal, emission
Profile
URP LitSame PBR mapping as Standard, with surface type and alpha clip detected
Profile
HDRP LitSame PBR mapping as Standard, with surface type detected
Profile
VRChat MobileQuest shaders: Toon Lit, Standard Lite, Toon Standard, Bumped Specular, MatCap Lit
Generic
Anything elseBest effort from common property names. Add your own GUID table for custom shaders.
ProfileDedicated mapping made for that shader GenericRules that work on any shader, results vary
Switch the look

Toon in EEVEE, PBR in Cycles

Toon shaders such as lilToon come in with a toon look made for EEVEE, while Standard and URP come in as Blender's Principled BSDF. Want to render in Cycles? Switch later from the sidebar, no original package needed.

Auto (recommended)Looks at each material's shader and picks toon, PBR or unlit
ToonRecreates shadow color, MatCap and rim light. Made for EEVEE
PBR (Principled BSDF)Renders as it is in Cycles too

There are also Unlit, which ignores lighting, and Names Only, which creates empty materials with the right names.

The same avatar twice: imported with Auto for a toon look on the left, then switched to PBR (Principled BSDF) from the sidebar for a shaded look on the right
Left: imported with Auto. Right: the same avatar switched to PBR (Principled BSDF) from the sidebar, without using the original package.
Install

Two steps and you are ready

Works with Blender 4.2 and later. Either way of installing gives you the same add-on.

1Install the add-on

Easiest

Download the zip and install it

Download zip (1.6.0)

Drag the downloaded zip onto the Blender window and confirm the install. You can also use Install from Disk in the menu at the top right of Preferences > Get Extensions.

Automatic updates

Add the repository, then install

In Blender, open Edit > Preferences > Get Extensions > Repositories, click +, choose Add Remote Repository and paste this URL.

https://utagestudio.github.io/unitypackage_loader/index.json

Then search for Unitypackage Importer in Get Extensions and click Install.

2Drop a package

Drag a .unitypackage onto the 3D Viewport, or use File > Import > Unitypackage. Press Import in the popup and the package loads. Several files at once are fine.

Blender's File Import menu with an entry reading Unitypackage (.unitypackage)
The add-on registers itself under File > Import. Dropping a file on the viewport opens the same options.
The import options popup with Model, Materials and Textures sections
The options, grouped into model, materials and textures. Every default can be changed in the add-on preferences.
FAQ

Questions you might have

Do I need Unity?

No. You don't need to install Unity or Unity Hub. The add-on reads the package contents itself.

Does it cost anything?

No, it is free software under the GPL-3.0 license, and the source code is on GitHub.

Which Blender versions does it support?

Blender 4.2 and later, on Windows, macOS and Linux.

Will it work with my avatar?

Avatars using common shaders such as lilToon, Poiyomi and MToon are supported. Other shaders are converted as far as their common setting names allow.

Unity shaders and Blender nodes work differently, so the result will not match Unity exactly. Expect to finish the look in Blender.

Also, even if an avatar imports fine, whether you may use or edit it in Blender is decided by that asset's license. Check its terms and stay within them.

Am I allowed to edit the avatar or publish renders of it?

This add-on only imports the files; it does not grant you any rights to the asset. Whether you may edit it, publish pictures or videos of it, or use it outside Unity is decided by each asset's license. Check the terms on the store page or in the package before you use it.

Is anything left out?

The goal is a model that looks right in Blender, so these are not imported:

  • Shader source code (material settings are converted)
  • C# scripts and components
  • Animations and animator controllers
  • Prefab hierarchies (prefabs are only read to assign materials)
  • VRChat Expression menus and parameters
  • PhysBones and other dynamics, physics and colliders (VRM spring bones are reproduced if the VRM add-on is installed)
Is it safe to open packages made by someone else?

No code from the package ever runs. What gets written to disk is mainly model files and the textures their materials use. Bundled .blend files can carry Python, so they stay closed unless you opt in for that import. File paths and extracted sizes are checked before anything is written.

FBX and image decoding are done by Blender itself, so keep Blender on the latest LTS. The full notes are in the README.

Something did not import right. What now?

The "UPI" tab in the sidebar (N key) shows what was imported, how each material was resolved, and any warnings. If that does not help, please let us know in GitHub Issues.

Curious how it works under the hood? The developer notes are in DESIGN.md.