VR Realms
Discord Play free

Build an Avatar

Import an avatar file

Two ways. In the game: Avatars, My files. In the Creator Kit: Import avatar file.

Avatars come in many forms: a Unity package from an avatar store, a download in a .zip, an FBX, a VRM. VR Realms reads them for you. In the game you can wear one straight from your PC and publish it to the Workshop. In the Creator Kit one button brings it into Unreal, ready to build. Nobody needs Unity or Blender for it.

Both use the same converter, so an avatar looks the same whichever way you bring it in.

Files that work

  • .unitypackage: a Unity package, the way avatar stores sell avatars. The converter reads the avatar's own prefab: which model it uses, the material on every part, and the parts that start switched off.
  • .zip, .rar, .7z: a download. It is unpacked, with the archives inside it, and the avatar in it is found.
  • .fbx: from Blender, Maya, 3ds Max, Character Creator, Mixamo and more.
  • .vrm: from VRoid Studio and other VRM tools.
  • .glb: a .vrm saved as .glb works. A plain .glb with no humanoid table does not: export that avatar as FBX instead.

These do not work, and the game tells you why when you pick one: a .blend (export an FBX from Blender), a .gltf in separate files (save it as one .glb), an .obj (it has no bones), a character maker's own save files (they hold no model), and a MetaHuman package (.mhpkg: see MetaHuman).

In the game: Avatars, My files

  1. Open the menu, then Avatars, then My files. In VR, the X button opens the menu.
  2. Bring the file in. Open folder opens the game's folder Documents/VR Realms/Avatars/Drop avatar files here: drag your file into it. Or press Browse... and pick one file anywhere on your PC. A download can stay zipped.
  3. Find it under Drop files here, VR Realms avatars, Converted or Recent. The game only reads its own folders and the one file you pick with Browse.
  4. For a .zip, .rar or .7z, press Unpack. One avatar in it is worn at once. Several are listed: Whole avatars first, then avatars made of pieces.
  5. For a Unity package or an FBX, press Convert and wear. The first time it is converted, which takes a few seconds while you keep playing. After that it is worn at once.
  6. A .vrm is worn with Wear. Take off goes back to the avatar you picked.

Only you see an avatar from a file. Others keep seeing the avatar you picked until you publish it.

Pieces, pictures and physics

  • Pieces: an avatar made of pieces that replace each other, such as several hairstyles or a helmet or none, shows a Pieces button. Every slot has arrows to switch.
  • Fix parts: a part that shows plain white or grey came without a picture. Press Fix parts and give it one of the avatar's own pictures.
  • Physics: open the quick menu, then Avatar, then Physics. A slider for every part that sways, such as the tail, the ears or the hair, and one for all of them.
  • Eyes that move and face shapes that talk work as they do on any avatar, when the file has them.

Publish it to the Workshop

  1. Wear the avatar, then press Publish.
  2. Give it a Name, a few words in About it, and pick its Style.
  3. Choose Who can wear it: Anyone, or Only me. Others still see it on you.
  4. For the picture press Take a picture of me, or Choose a picture... for one of your own. Pick one of five Background designs behind you, and press Retake the picture to try again.
  5. Tick I made this avatar, or its licence lets me share it, then press Publish to the Workshop. For an avatar you published before, the button reads Update its Workshop item.

The Workshop gets the avatar the game made of the file. Others see it once it has been reviewed. To change it later, publish the same file again: it updates the same item.

Licences. Many avatars bought online may be worn by you but not shared. Upload only what you made or what its licence lets you share.

In the Creator Kit: Import avatar file

Keep the kit up to date with the Creator Kit app. It offers every new release by itself.

  1. Open Tools → VR Realms Workshop, then the Avatars page.
  2. Press Import avatar file... under Skeletal mesh and pick the file: a .unitypackage, a .zip, .rar or .7z, an .fbx, a .vrm or a .glb.
  3. Wait a few seconds. The log at the bottom says every step: what it unpacked, which avatar it found, what the converter did and where the avatar went.
  4. The avatar comes in as one skeletal mesh with its bones, face shapes, materials and pictures, in Content/VRRealms/Community/Avatars/<Name>, and it is picked on the page.
  5. From there it is like any avatar: press Build Avatar Pak, which works the skeleton out from its shape when it needs to, try it with Play Avatar, then Upload. See Preparing your avatar.
  • An avatar made of pieces that replace each other (another hairstyle, another jacket) comes in as the game shows it at first: those pieces stay out, and the log names them. Pieces that sit elsewhere on the body stay in. To keep every piece, open Window → Output Log, type vrr.Kit.ImportAvatarAllPieces 1 in its Cmd box and import again.
  • A second download beside the first whose name starts with the same word, such as a model in one zip and its pictures in another, is unpacked too, and its pictures are found.
  • An avatar much taller or smaller than a person comes in at its own size, and the log says so. Scale it in Unreal before Build if it should be person sized.
  • A second import of the same name goes into a folder of its own, ending in _2. Nothing you made before is replaced.

What the converter reads

  • In a Unity package: the avatar's prefab, the model's import settings, the materials and their pictures.
  • Pictures beside the model or anywhere in the download, by their names (BaseColor, Albedo, Diffuse and the like).
  • See through parts such as eye glass, lenses and lashes.
  • The bones by their names and by the shape of the skeleton: humanoid rigs from Unity, Blender and Rigify, Mixamo, 3ds Max, Character Creator and Auto Rig Pro.

For the best result

  • Pick the whole download, not one file pulled out of it: the pictures and materials come with the rest.
  • Keep a second download with the pictures beside the first, with a name that starts with the same word.
  • Toon shading looks such as rim light, matcaps and outlines do not come along. The colour pictures do.

Good to know

  • The game keeps what it converted, with the avatar's pictures, in Documents/VR Realms/Avatars/Converted, or in a folder of your own: Change... on the My files page. A file is converted again when it changes, or when an update improves the converter.
  • Downloads the game unpacks go to Documents/VR Realms/Avatars/Unpacked. Free space deletes them when you are done; the downloads themselves stay.
  • Every file row has a bin. Your own files go to the Recycle Bin; copies the game made are deleted.
  • If an avatar does not come in right, send the file's name and your log to the VR Realms team. See Sending a log.

← Avatars

Found a bug with the docs? Click here to report it →Report a docs bug →