v0.9.70
Orquestador

MRMenuRadial

Componente principal que orquesta todos los procesos del sistema Menu Radial

Descripcion

MRMenuRadial es el punto de entrada y orquestador principal de todo el sistema. Es el unico componente que el usuario necesita agregar manualmente a su escena — todo lo demas se genera automaticamente a partir de el.

Al asignar un avatar, MRMenuRadial escanea la jerarquia del avatar para detectar ropa, pelucas, accesorios, PhysBones y meshes. Con esa informacion, crea y gestiona todos los componentes hijos necesarios: MRCoserRopa, MROrganizaPB, MRAjustarBounds, MRAnalisisColision, MRPesoTexturas y MRMenuControl.

Funciona como un hub centralizado: propaga la referencia del avatar a todos los componentes hijos, coordina el escaneo y la preparacion, y controla las opciones de build NDMF. Es la unica pieza que necesitas para poner en marcha todo el flujo de trabajo de Menu Radial.

Interfaz del Inspector

Inspector MRMenuRadial - Parte Superior
1 Titulo del componente MR Menu Radial 2 Campo Avatar — arrastra aqui tu avatar con VRCAvatarDescriptor 3 Auto-detectar — escanea ropas y pelucas automaticamente al asignar avatar 4 Auto-generar Menu — genera la estructura del menu automaticamente 5 Boton "Sincronizar" — crea o actualiza la estructura del menu de forma incremental 6 Boton "Generar Archivos VRChat" — genera animaciones, FX, parametros y menus 7 Panel de Estado — 4 indicadores: Ropas detectadas, PhysBones, Bounds, Menu configurado 8 Componentes Hijos — estado de cada componente hijo con indicador de color 9 Namespace del Avatar — configuracion de salida (Output Prefix)
Inspector MRMenuRadial - Parte Inferior
10 Output Prefix — prefijo unico para subcarpeta y nombres de archivo 11 Ruta de Salida — carpeta donde se generan los archivos 12 Write Default Values — activar/desactivar Write Defaults en el controlador FX 13 Integracion del Menu VRChat — configura como se integra el menu en el avatar 14 Nombre del Menu — nombre visible en VRChat (si vacio, usa el prefijo) 15 Icono del Menu — textura que aparece junto al nombre en VRChat 16 Ubicacion — modo de integracion (Root Menu, Submenu existente, Ruta personalizada) 17 NDMF - Control de Procesos — panel colapsable (colapsado por defecto desde v0.9.70) 18 Desactivar Cosido de Huesos — NDMF no cosera armatures durante el build 19 Desactivar Merge VRChat — NDMF no mezclara FX/Parameters/Menu durante el build 20 Desactivar Modular Avatar — desactiva TODOS los componentes de MA durante el build

Configuracion del Avatar

Propiedad Tipo Descripcion
Avatar Root GameObject El avatar con VRCAvatarDescriptor. Se puede auto-detectar buscando en la jerarquia padre del componente.
Auto-detectar al asignar Toggle Cuando esta activado, al asignar el avatar se escanea automaticamente la ropa, PhysBones y meshes. Activado por defecto.
Auto-generar estructura Toggle Crea automaticamente los radiales de Outfits, Pelucas y los sistemas de materiales e iluminacion al detectar el avatar. Activado por defecto.

Namespace (Configuracion de Salida)

Propiedad Descripcion
Prefijo de salida Identificador unico para el avatar. Se usa como prefijo en todos los archivos generados (animaciones, controllers, parametros). Se auto-asigna con el nombre del avatar al asignarlo.
Ruta de salida Directorio donde se guardan las animaciones y archivos VRChat generados. Por defecto: Assets/Bender_Dios/Generated/
Write Defaults Configuracion de Write Defaults para el AnimatorController generado. Recomendado OFF para VRChat (es la mejor practica segun la documentacion oficial de VRChat).

Integracion del Menu VRChat

Esta seccion configura como se integra el menu generado por Menu Radial dentro del sistema de menus de expresiones de VRChat. Puedes definir el nombre visible, un icono personalizado y la ubicacion dentro de la jerarquia de menus del avatar.

Propiedad Descripcion
Nombre del Menu El nombre que aparece en el menu radial de VRChat. Si se deja vacio, se utiliza el Output Prefix como nombre por defecto.
Icono del Menu Textura (Texture2D) que se muestra junto al nombre del menu dentro de VRChat. Es opcional.
Ubicacion Modo de integracion del menu en el avatar. Determina donde se coloca el menu generado dentro de la estructura de menus VRChat.

Modos de Ubicacion (MenuIntegrationMode)

Modo Descripcion
Root Menu Modo por defecto. El menu generado se agrega directamente al menu raiz del avatar (VRCExpressionsMenu principal). Ideal para la mayoria de casos.
Submenu existente El menu se inserta como subcontrol dentro de un VRCExpressionsMenu ya existente en el avatar. Util cuando el avatar ya tiene una estructura de menus personalizada y quieres integrar Menu Radial dentro de ella.
Ruta personalizada Permite especificar manualmente una ruta dentro de la jerarquia de menus donde se colocara el menu generado. Para configuraciones avanzadas.
En la mayoria de los casos, el modo Root Menu es suficiente. Solo cambia a otro modo si tu avatar ya tiene una estructura de menus compleja donde necesitas integrar Menu Radial en un lugar especifico.

Panel de Estado

El panel de estado muestra 4 indicadores que resumen la situacion actual del avatar:

Indicador Descripcion
Ropa detectada Muestra cuantas piezas de ropa estan habilitadas del total detectado (ej: 5/7 habilitadas). Incluye ropa, pelucas y accesorios.
PhysBones Estado del escaneo de PhysBones. Indica si se han detectado y organizado correctamente. Tambien muestra el estado "Organizados" cuando todas las piezas ya tienen PhysBones pre-organizados en contenedores (AllPreOrganized, disponible desde v0.9.70).
Bounds Indica si los bounds de todos los meshes del avatar estan unificados. Bounds unificados evitan que partes del avatar desaparezcan al girar la camara.
Menu configurado Muestra la cantidad de slots del menu que estan configurados y listos para generar archivos VRChat.

Botones de Accion

Desde la version v0.9.69, el inspector de MRMenuRadial se simplifica a solo 2 botones principales:

Boton Descripcion
Sincronizar Crea la estructura desde cero si no existe, o actualiza incrementalmente si ya hay una estructura. Tambien refresca la organizacion de PhysBones y los bounds del avatar. Es el boton principal para mantener todo sincronizado cuando agregas nueva ropa.
Generar Archivos VRChat Genera todos los archivos necesarios para VRChat: animaciones (.anim), controlador FX (.controller), parametros de expresion (.asset) y menus de expresion (.asset). Muestra un dialogo de exito o error al finalizar.
Usa Sincronizar cada vez que agregues nueva ropa o pelucas al avatar. Este boton detecta los cambios y los incorpora al menu existente sin perder configuraciones personalizadas como ajustes de frames, materiales o blendshapes.

Control NDMF (Avanzado)

Estas opciones controlan que procesos ejecuta NDMF durante el build del avatar. Son utiles para depuracion o cuando necesitas desactivar un proceso especifico.

Desde la version v0.9.70, este panel se presenta como un foldout colapsable, colapsado por defecto. Haz clic en el titulo "NDMF - Control de Procesos" para expandirlo y ver las opciones.

Opcion Descripcion
Desactivar cosido NDMF NDMF no cosera armatures de ropa durante el build. Util si prefieres que Modular Avatar maneje el cosido o si tienes un setup custom.
Desactivar merge VRChat NDMF NDMF no mezclara el FX Controller, los parametros ni el menu VRChat durante el build. Util para depurar problemas con las animaciones generadas.
Desactivar Modular Avatar NDMF Desactiva todos los componentes de Modular Avatar durante el build NDMF. Util para aislar conflictos entre MR y MA.
Estas opciones son para depuracion. Solo activalas si tienes un conflicto especifico que necesitas diagnosticar. En uso normal, deja todas desactivadas.

Componentes Hijos

MRMenuRadial crea y gestiona automaticamente los siguientes componentes hijos. Cada uno se encarga de un aspecto especifico de la preparacion y generacion del menu:

MRCoserRopa
Detecta y cose armatures de ropa, pelucas y accesorios al esqueleto del avatar.
MROrganizaPB
Organiza los PhysBones del avatar en contenedores ordenados por prenda.
MRAjustarBounds
Unifica los bounds de todos los SkinnedMeshRenderers del avatar.
MRAnalisisColision
Detecta y destruye componentes de Modular Avatar que generan conflictos.
MRPesoTexturas
Analiza el peso en VRAM de las texturas del avatar y sus prendas.
MRMenuControl
Genera las animaciones, controller FX, parametros y menus de expresiones VRChat.
Todos los componentes hijos se crean automaticamente al asignar el avatar. Si falta alguno, usa el boton "Sincronizar" en el inspector de MRMenuRadial para regenerar la estructura completa.