Empaqueta y Aloja Tu Avatar

At a minimum, avatars in Overte must have a glTF, GLB or FBX model, and an optional associated FST file that includes information about how your avatar looks and behaves. Together, these two files (with any optional texture or script) form an "avatar package". There are three ways you can create an avatar package: by using the Overte Avatar Exporter for Unity in Unity, creating FST file by hand or using the Avatar Packager in Interface. Interface's Avatar packager needs maintenance, so it's not recommended currently.

Models conforming to Avatar Standards Guide <avatar-standards> work directly as avatars with no FST file needed.

Once you have packaged your avatar, you need to host it on the cloud so that Overte can access it and correctly render your avatar for all users. Any web server with direct HTTP or HTTPS access is compatible.

Empaqueta Tu Avatar

Si está leyendo esta página, probablemente ya construiste tu propio modelo FBX o encontraste y descargaste un modelo que quieras usar en Overte. Por lo tanto, todo lo que queda es empaquetar tu avatar y crear el archivo FST. Este archivo incluye información sobre el esqueleto, las combinaciones de formas (blendshapes), las texturas y los scripts utilizados por tu avatar.

We provide three ways of creating an avatar package: either through Unity, manually in a text editor or through our Avatar Packager. In-game Avatar Packager needs maintenance and is not recommended currently.

Exportador de Avatares de Overte para Unity

En algunos casos, necesitarás descargar un avatar desde una página web externa y usar el avatar en Overte. El Exportador de Avatar de Overte para Unity (también conocido como "exportador de avatar") convierte avatares de apariencia humana y los empaqueta para usarlos en Overte.

Once you have successfully used the avatar exporter to package your avatar, you must host it somewhere on the cloud. You can upload it to Amazon S3, Cloudflare R2 or a webserver for example.

Creating FST file manually

FST file is a regular text file and can be created in a text editor. In the simplest form it contains the avatar's name, filename or URL of the model file and its scale. Overte uses metric scale, so scale = 1 means that 1 length unit in model file is 1 meter. If filename is just a file name and not a full URL, then relative path will be used.

Flow bones configuration can be generated using the Flow app available in Overte's Community Apps (More icon in Overte's UI).

Example avatar FST file with custom animations and materials override:

name = MyAvatar
scale = 1
filename = MyAvatar.glb
animGraphUrl = http://some_hosting_website_url/avatar-animation.json
flowPhysicsData = {"tail":{"active":true,"damping":0.55,"delta":0.5,"gravity":0,"inertia":1,"radius":0.1,"stiffness":0.6}}
texdir = textures
materialMap = {   "mat::MyAvatarMaterial": {     "materialVersion": 1,     "materials": {       "albedo": [         1,         1,         1       ],       "metallic": 1,       "roughness": 1,       "emissive": [         0,         0,         0       ],       "albedoMap": "textures/MyMaterial_colors.png",       "metallicMap": "textures/MyMaterial_metallic.png",       "roughnessMap": "textures/MyMaterial_roughness.png"       }   } }

Empaquetador de Avatar

Advertencia

Avatar Packager is not remommended currently.

El Empaquetador de Avatar es una herramienta en la interfaz (cliente Overte) que identifica potenciales errores en tu modelo de avatar FBX y luego crea un archivo FST para ti.

Para empaquetar tu avatar usa el Empaquetador de Avatar:

  1. En la interfaz, ve a Edit > Avatar Packager.

  2. En la ventana del Empaquetador de Avatar, haz click en "New Proyect".

  3. En la ventana de "Create Proyect", completa los siguientes detalles:

    • Name: El nombre que quieres para tu avatar.

    • Project Location: La ruta de la carpeta donde se almacenan los archivos de tu avatar. El Empaquetador de Avatar creará una nueva carpeta para tu proyecto en esta ubicación. El paquete contendrá tu modelo FBX, un archivo FST y cualquier script/texturas en tu avatar.

    • Avatar Model: La ubicación del modelo FBX de tu avatar.

    • Texture Folder: Si tu avatar tiene las texturas en una carpeta a parte, especifica la ubicación de la carpeta. Si las texturas de tu avatar están incorporadas en el FBX, no necesitas especificar nada.

  4. Haz click en "Create".

En este punto, haz empaquetado tu avatar exitosamente. Puedes cerrar el Empaquetador de Avatar a partir de aquí y subir tu archivo FST y modelo FBX a una ubicación de la nube de tu elección.

Alojamiento y Uso de Tu Avatar

Antes de poder utilizar un avatar personalizado, primero debes alojar sus archivos FST y FBX/glTF/GLB en un lugar de acceso público. Puedes utilizar cualquier plataforma en la nube, incluidos Amazon S3, Google Cloud Storage, Microsoft Azure, Dropbox, etc.

  1. Sube to archivo de modelo de avatar (FBX/glTF/GLB) al servicio de su elección.

  2. Copia la URL exacta del archivo, como si estuvieras compartiendo un enlace de descarga directa.

  3. Abra su archivo FST en un editor de texto y sustituya la entrada filename por la URL del paso anterior. Por ejemplo: filename = MyAvatar debería cambiarse por filename = https://mywebsite.example/avatar.fbx

  4. Guarda el archivo FST y súbelo al servicio de tu elección.

  5. En Interfaz (en el cliente de Overte), selecciona Avatar y haz clic en el icono de cadena/enlace.

  6. Deberías ver un mensaje con la etiqueta «Especificar URL del avatar». Pegue la URL de su archivo FST en el cuadro de texto y confirme.

If you are looking for a place to host these files, you can simply use Cloudflare R2, Amazon S3, Google Cloud Storage, Microsoft Azure, GitHub, Catbox, etc. It doesn't matter as long as anyone can view the file link and it's a direct link to the file. Links to a separate download page won't work.

Video tutorial on uploading to Cloudflare R2: https://www.youtube.com/watch?v=Q_whpCUHqlw

Solución de problemas con el Empaquetador de Avatar

El Empaquetador de Avatar te notificará de cualquier error o advertencia que pueda afectar la forma en que tu avatar se vea y se comporte en Overte. Esta es una lista de los errores que puedes encontrar, junto con instrucciones básicas sobre cómo corregir tu avatar. Los errores (en rojo) deben ser arreglados antes de subir tu avatar, mientras que las advertencias (en naranja) pueden o no afectar sí tu avatar apareciera y se comportara correctamente en Overte.

Nota

Muchos de los errores que encontrarás describen problemas con el esqueleto del avatar. Los siguientes consejos para la resolución de problemas intentarán corregir los errores en Unity.

Sin embargo, si la estructura ósea del modelo no se parece a un esqueleto humanoide (con dos piernas, dos brazos, caderas, pecho, columna y cabeza), es probable que no sea compatible con Overte por cómo fue hecho. No podrás arreglar estos avatares solo en Unity. De hecho, es probable que necesites conocimientos avanzados de construcción, armado (rigging) y mapeo (mapping) de huesos en una herramienta de modelado 3D como Blender o Maya.

Error How to Fix

Hips are not mapped

This error occurs when there is no "hip" bone identified in your avatar's skeleton.
  1. Import your FBX model into a Unity project.
  2. Install the avatar exporter for Unity.
  3. Ensure that your avatar is 'Humanoid' (in Unity, go to Inspector > Rig > Animation Type > Humanoid).
  4. Click 'Configure' to open the skeleton mapping configuration.
  5. Click the 'Body' button next to the humanoid illustration.
  6. Locate 'Hips' and drag the appropriate bone from the Hierarchy window to map it.

If an appropriate bone does not exist, or this does not resolve the issue, you will need to fix the avatar's skeleton in a 3D modeling tool of your choice.

Spine is not mapped

This error occurs when there is no "spine" bone identified in your avatar's skeleton.
  1. Import your FBX model into a Unity project.
  2. Install the avatar exporter for Unity.
  3. Ensure that your avatar is 'Humanoid' (in Unity, go to Inspector > Rig > Animation Type > Humanoid).
  4. Click 'Configure' to open the skeleton mapping configuration.
  5. Click the 'Body' button next to the humanoid illustration.
  6. Locate 'Spine' and drag the appropriate bone from the Hierarchy window to map it.

If an appropriate bone does not exist, or this does not resolve the issue, you will need to fix the avatar's skeleton in a 3D modeling tool of your choice.

Chest (Spine1) is not mapped

This error occurs when there is no "chest" bone identified in your avatar's skeleton.
  1. Import your FBX model into a Unity project.
  2. Install the avatar exporter for Unity.
  3. Ensure that your avatar is 'Humanoid' (in Unity, go to Inspector > Rig > Animation Type > Humanoid).
  4. Click 'Configure' to open the skeleton mapping configuration.
  5. Click the 'Body' button next to the humanoid illustration.
  6. Locate 'Chest' and drag the appropriate bone from the Hierarchy window to map it.

If an appropriate bone does not exist, or this does not resolve the issue, you will need to fix the avatar's skeleton in a 3D modeling tool of your choice.

Head is not mapped

This error occurs when there is no "head" bone identified in your avatar's skeleton.
  1. Import your FBX model into a Unity project.
  2. Install the avatar exporter for Unity.
  3. Ensure that your avatar is 'Humanoid' (in Unity, go to Inspector > Rig > Animation Type > Humanoid).
  4. Click 'Configure' to open the skeleton mapping configuration.
  5. Click the 'Head' button next to the humanoid illustration.
  6. Locate 'Head' and drag the appropriate bone from the Hierarchy window to map it.

If an appropriate bone does not exist, or this does not resolve the issue, you will need to fix the avatar's skeleton in a 3D modeling tool of your choice.

Neck is not mapped

This warning occurs when there is no "neck" bone identified in your avatar's skeleton.
  1. Import your FBX model into a Unity project.
  2. Install the avatar exporter for Unity.
  3. Ensure that your avatar is 'Humanoid' (in Unity, go to Inspector > Rig > Animation Type > Humanoid).
  4. Click 'Configure' to open the skeleton mapping configuration.
  5. Click the 'Head' button next to the humanoid illustration.
  6. Locate 'Neck' and drag the appropriate bone from the Hierarchy window to map it.

If an appropriate bone does not exist, or this does not resolve the issue, you will need to fix the avatar's skeleton in a 3D modeling tool of your choice.

LeftEye is not mapped |
RightEye is not mapped |
Eyes are not mapped

This warning occurs when there is one or more missing "eye" bones in your avatar's skeleton.
  1. Import your FBX model into a Unity project.
  2. Install the avatar exporter for Unity.
  3. Ensure that your avatar is 'Humanoid' (in Unity, go to Inspector > Rig > Animation Type > Humanoid).
  4. Click 'Configure' to open the skeleton mapping configuration.
  5. Click the 'Head' button next to the humanoid illustration.
  6. Locate the faulty 'Eye' joint and drag the appropriate bone from the Hierarchy window to map it.

If an appropriate bone does not exist, or this does not resolve the issue, you will need to fix the avatar's skeleton in a 3D modeling tool of your choice.

Multiple top-level joints found

Overte's standard avatar skeleton has one root bone (typically the hips) that every other bone is connected to, either directly or indirectly. This bone is known as the "parent", "root", or "top-level" bone and it defines the center of your avatar. Click here to view our standard avatar skeleton.

This error occurs when you have more than one of these "top-level" bones defined in your avatar's skeleton. Rather than a hierarchy of joints, you will likely see many bones at the same root level in your skeleton.

In Unity, check your avatar's skeleton in the Hierarchy window. In some cases, having multiple bones at the root level won't affect your avatar, especially if they are unimportant bones (for example, the tongue bone probably will not affect the overall appearance of your avatar). In these cases, you can simply ignore the error and proceed with packaging and hosting your avatar.

If you have multiple "top-level" bones that are important (for example, if the hips and neck bone are at the same level), then you will need to fix the avatar's skeleton in a 3D modeling tool of your choice.

<boneName> is mapped multiple times

This warning occurs when one of your avatar's bones is mapped multiple times in your skeleton. For example, a back bone may be mapped to both the spine and the hips.

  1. Import your FBX model into a Unity project.
  2. Install the avatar exporter for Unity.
  3. Ensure that your avatar is 'Humanoid' (in Unity, go to Inspector > Rig > Animation Type > Humanoid).
  4. Click 'Configure' to open the skeleton mapping configuration.
  5. Locate the duplicate mapping in Humanoid and delete it.
  6. If it is a required bone (such as hips, spine, chest, or head), then locate the correct bone in the Hierarchy window. Drag it to the Humanoid mapping.

If an appropriate bone does not exist, or this does not resolve the issue, you will need to fix the avatar's skeleton in a 3D modeling tool of your choice.

Asymmetrical arm/leg/hand bones

We assume that the left and right appendages (arms, legs, and hands) have the same number of bones. This warning occurs if we detect a different number of bones on the left and rights sides of the body.
  1. Import your FBX model into a Unity project.
  2. Install the avatar exporter for Unity.
  3. Ensure that your avatar is 'Humanoid' (in Unity, go to Inspector > Rig > Animation Type > Humanoid).
  4. Click 'Configure' to open the skeleton mapping configuration.
  5. For arm and leg warnings, click the 'Body' button next to the humanoid illustration. For hand warnings, click the appropriate 'Hand' button next to the humanoid illustration.
  6. Compare the left and right side. If the number of bones on the sides do not match, then locate and drag the appropriate bone from the Hierarchy window to map it.

Spine is not a child of Hips

Overte's standard avatar skeleton has one root bone, and every other bone is a descendent of that bone (either directly or indirectly). In the standard skeleton, the spine must be a direct descendent of the hips. Click here to view our standard avatar skeleton.

This warning occurs when the spine is not a direct descendent of the hip bone.

  1. Import your FBX model into a Unity project.
  2. Install the avatar exporter for Unity.
  3. Ensure that your avatar is 'Humanoid' (in Unity, go to Inspector > Rig > Animation Type > Humanoid).
  4. Click 'Configure' to open the skeleton mapping configuration.
  5. Click the 'Body' button next to the humanoid illustration, and click on the 'Hips' mapping. This will highlight the mapped bone in the Hierarchy window.
  6. Now click on the 'Spine' mapping. The highlighted bone should be directly below the Hips bone. If it is not, then locate and drag the appropriate bone from the Hierarchy window to map it.

If the appropriate bones are mapped to the Hips and Spine, or this does not resolve the issue, you will need to fix the avatar's hierarchy in a 3D modeling tool of your choice.

Spine1 is not a child of Spine

Overte's standard avatar skeleton has one root bone, and every other bone is a descendent of that bone (either directly or indirectly). In the standard skeleton, the chest bone (or Spine1) must be a direct descendent of the spine. Click here to view our standard avatar skeleton.

This warning occurs when the chest is not a direct descendent of the spine bone.

  1. Import your FBX model into a Unity project.
  2. Install the avatar exporter for Unity.
  3. Ensure that your avatar is 'Humanoid' (in Unity, go to Inspector > Rig > Animation Type > Humanoid).
  4. Click 'Configure' to open the skeleton mapping configuration.
  5. Click the 'Body' button next to the humanoid illustration, and click on the 'Spine' mapping. This will highlight the mapped bone in the Hierarchy window.
  6. Now click on the 'Chest' mapping. The highlighted bone should be directly below the Spine bone. If it is not, then locate and drag the appropriate bone from the Hierarchy window to map it.

If the appropriate bones are mapped to the Spine and Chest (Spine1), or this does not resolve the issue, you will need to fix the avatar's bone hierarchy in a 3D modeling tool of your choice.

Head is not a child of Spine1

Overte's standard avatar skeleton has one root bone, and every other bone is a descendent of that bone (either directly or indirectly). In the standard skeleton, the head bone must be a direct descendent of the chest (or Spine1). Click here to view our standard avatar skeleton.

This warning occurs when the head is not a direct descendent of the chest bone.

  1. Import your FBX model into a Unity project.
  2. Install the avatar exporter for Unity.
  3. Ensure that your avatar is 'Humanoid' (in Unity, go to Inspector > Rig > Animation Type > Humanoid).
  4. Click 'Configure' to open the skeleton mapping configuration.
  5. Click the 'Body' button next to the humanoid illustration, and click on the 'Chest' mapping. This will highlight the mapped bone in the Hierarchy window.
  6. Now click the 'Head' button, and click on the 'Head' mapping. The highlighted bone should be below the Chest bone. If it is not, then locate and drag the appropriate bone from the Hierarchy window to map it.

If the appropriate bones are mapped to the Chest (Spine1) and Head, or this does not resolve the issue, you will need to fix the avatar's bone hierarchy in a 3D modeling tool of your choice.

Hips are on ground

This warning occurs when the bone mapped to the Hips is on the ground, rather than at hip level.
  1. Import your FBX model into a Unity project.
  2. Install the avatar exporter for Unity.
  3. Ensure that your avatar is 'Humanoid' (in Unity, go to Inspector > Rig > Animation Type > Humanoid).
  4. Click 'Configure' to open the skeleton mapping configuration.
  5. Click the 'Body' button next to the humanoid illustration.
  6. Locate the 'Hips' mapping. This is the one with an incorrect mapping.
  7. Drag the appropriate bone from the Hierarchy window to re-map it.

If the appropriate bone is mapped to the Hips, or this does not resolve the issue, you will need to fix the avatar's bone placement in a 3D modeling tool of your choice.

Hips/Spine/Chest Overlap

Overte's standard avatar skeleton requires that each bone is placed at different locations on the body. For example, the hips cannot be positioned at the same location as the chest. This error occurs when either the hips, spine, and/or chest bones have overlapping positions.
  1. Import your FBX model into a Unity project.
  2. Install the avatar exporter for Unity.
  3. Ensure that your avatar is 'Humanoid' (in Unity, go to Inspector > Rig > Animation Type > Humanoid).
  4. Click 'Configure' to open the skeleton mapping configuration.
  5. Click the 'Body' button next to the humanoid illustration, then click on the bone you want to reposition.
  6. In the Scene window, arrows will appear around the bone you have selected. Make minor adjustments to the bone's position using these arrows, until each bone is at its own unique position on the avatar.

If this does not resolve the issue, you will need to fix the avatar's bone placement in a 3D modeling tool of your choice.

Avatar has over 256 bones

This warning occurs when you have more than the maximum number of bones allowed (which is 256 bones).

This warning cannot be resolved in Unity or Overte. To fix it, you need to remove bones from your skeleton using a 3D modeling tool of your choice.

Missing # texture(s)

This warning occurs when Overte cannot find textures for your avatar. This will affect the appearance of your avatar, and it may appear grey when you try to use it.

After you package your avatar, copy all external textures to the 'Textures' folder that we create for you. Then, update your project using the Avatar Packager.

# unsupported texture(s) found

This warning occurs when your textures are not supported by Overte. Supported image formats include PNG, JPG, JPEG, TGA, TIF, and TIFF files.
  1. Open your textures in an image editor of your choice.
  2. Export the textures to a supported format.
  3. Set the new texture to your avatar using Unity's Material Editor or a 3D modeling tool of your choice.

No textures assigned

This warning occurs when you do not have any textures embedded in your model or referenced in your FST file. If your avatar was intentionally designed without textures, this warning can be safely ignored.
  1. Import your FBX model into a Unity project.
  2. Install the avatar exporter for Unity.
  3. Go to Inspector > Materials.
  4. Change the 'Location' to 'Use External Materials (Legacy)'. Click 'Apply'. This creates a Materials folder.
  5. Copy your textures into the new Materials folder.
  6. Select a material to view its shader in the **Inspector** window. Click and drag your textures to configure them.

For more information, see Unity's help on their Material Editor. You can alternatively use a 3D modeling tool of your choice to assign materials and textures to your avatar.

Model file cannot be opened

This warning occurs when your avatar package is missing either an FBX or FST file.

  1. In a file explorer, open your avatar package folder.

  2. Ensure that your avatar package has both an FST and FBX file.

    • If you are missing your FBX file, locate it and copy it back into this folder.
    • If you are missing an FST file, re-package your avatar using either the Overte Avatar Exporter for Unity or the Avatar Packager.
  3. If both files are there and you still receive this error, open the FST file in a text editor of your choice.
  4. Locate the line filename = , and ensure that the path to your FBX file is correct.

Unsupported avatar model format

This warning occurs when your avatar model is not a supported format. Overte only supports FBX, glTF, and GLB models for avatars.

This warning cannot be resolved in Unity or Overte. To fix it, you need to open your model in the 3D modeling tool of your choice, and export your model as an FBX, glTF, or GLB file.

Avatar is possibly too short

This warning occurs when Overte detects that your avatar will appear very small when you use it.
  1. Import your FBX model into a Unity project.
  2. Install the avatar exporter for Unity.
  3. From the High Fidelity menu, click 'Export New Model'.
  4. Slide the scale slider to the right to increase the size of your avatar.

Avatar is possibly too tall

This warning occurs when Overte detects that your avatar will appear very large when you use it.
  1. Import your FBX model into a Unity project.
  2. Install the avatar exporter for Unity.
  3. From the High Fidelity menu, click 'Export New Model'.
  4. Slide the scale slider to the left to decrease the size of your avatar.

Avatar has no rig

This warning occurs when your avatar is not rigged.

This warning cannot be resolved in Unity or Overte. To fix it, we recommend running your avatar model through an auto-rigging tool such as Mixamo.