Expresiones

From VRChat Wiki
Revision as of 10:41, 7 December 2025 by Sakuuh (talk | contribs) (Created page with "== Parámetros de expresión no coincidentes ==")
Ver · Editar¡Esta es una página de información oficial de VRChat!
Es revisada y aprobada por el equipo de VRCWiki. Aprende cómo contribuir a esta página leyendo la guía de contribución.
Un ejemplo del menú de expresiones en el menú de acción.

Las expressiones son una característica de los avatares de VRChat, compuesta por menús personalizados por el usuario que permiten activar acciones o alternar entre objetos en tu avatar; están diseñadas para ofrecer acceso flexible y sencillo a funciones únicas del avatar.

Más información disponible en Documentos para creadores de avatares (en inglés).

Menú de expresiones

El menú de expresiones dentro del juego es accesible a través del menú de acción, o del panel de expresiones en el menú rápido y el menú principal en cualquier versión de VRChat. Los cambios en las expresiones de un avatar se sincronizan globalmente con otros usuarios en la misma plataforma y pueden configurarse para una sincronización multiplataforma.

Expresiones en el SDK

Las expresiones se editan utilizando varios parámetros en el SDK de VRChat.

Expresiones base

Cuando no se configura ninguna expresión, se agrega al avatar un menú de expresiones predeterminado con animaciones base, que contiene las siguientes animaciones:

  • Saludar
  • Aplaudir
  • Señalar
  • Animar
  • Bailar
  • Voltereta hacia atrás
  • Morir
  • Tristeza

Expresiones personalizadas

Para añadir expresiones personalizadas, crea un archivo llamado Expression Menu y otro llamado Expression Parameter (clic derecho en una carpeta dentro de Assets > Create > VRChat), luego asígnalos en el "Avatar Descriptor" de VRChat. El menú define las entradas de parámetros que se muestran en el menú de expresiones de tu avatar. Los parámetros son las variables que controla el menú. También puedes especificar detalles como si los parámetros deben sincronizarse para otros usuarios. Puedes configurar 256 bits para sincronizarse, dentro de un total de 8192 variables.

Controles

Puedes crear hasta 8 controles por página. Al crear un control, elige su tipo:

  • Botón
  • Interruptor (Toggle)
  • Submenú
  • Control de dos ejes
  • Control de cuatro ejes
  • Control radial

Ejemplo de menú de control
Ejemplo del menú de acción y el espejo facial en uso. (GIF animado)

Al mover el joystick, el panel táctil o el ratón/mouse en diferentes direcciones, se modifican los parámetros de animación para combinar diferentes estados de ánimo (por ejemplo, "feliz" y "sorprendido"). Cualquier parámetro se puede controlar desde este menú.

Puedes abrir un menú con cada mano (o con ambas). Por defecto, desliza el dedo para seleccionar una opción. En la configuración del menú de acción, puedes usar el gatillo. Para salir de una selección en el menú de expresiones, aprieta el gatillo.

Parámetros de expresión

Los parámetros de expresión se utilizan para controlar funciones del avatar mediante el menú de expresiones, el contact receiver (receptor de contactos), OSC, controladores de parámetros o physbones. Estos parámetros luego se asignan a los parámetros del "Animator Controller" (controlador de animaciones) en los controladores: FX, Gesture o Action de tu avatar.

Parámetros de expresión no coincidentes

El desajuste de parámetros de expresión se refiere a la práctica de usar diferentes tipos de parámetros entre tus parámetros de expresión y los parámetros locales del controlador de animaciones. Aunque se recomienda mantener los tipos de parámetros consistentes, la discrepancia se acepta y el sistema convertirá los valores entre tipos según reglas específicas, lo que puede ser útil en ciertos ajustes avanzados.

Unity's Animator system uses floats on the backend for all parameter types, while VRChat internally uses SBytes for parameter storage. The user interface in Unity and the VRCSDK allows you to select parameter types for convenience, but under the hood, conversions are possible. This means that parameters are not being cast, but rather mismatched. This behavior is also supported by popular tools such as Av3Emulator and Gesture Manager.

Expression Parameter Bool

Animator Controller Parameter
Type Expression Bool = False Expression Bool = True
Bool → Bool Bool = False Bool = True
Bool → Int Int = 0 Int = 1
Bool → Float Float = 0.0 Float = 1.0

Expression Parameter Int

Animator Controller Parameter
Type Behaviour
Int → Bool Any Int value that isn’t 0 sets bool to True
Int → Int Expected Behaviour
Int → Float Straight Conversion: e.g. Int = 2 → Float = 2.0

Expression Parameter Float

Animator Controller Parameter
Type Behaviour
Float → Bool Any Float value that isn’t 0 sets bool to True
Float → Int Rounded Conversion: ≥0.5 → 1 ; <0.5 → 0
Float → Float Expected Behaviour

Resources

See also

References