Menu Radial (MR)

Sistema de menu radial para avatares VRChat desarrollado en Unity. Genera animaciones (.anim), controladores FX (AnimatorController), parametros (VRCExpressionParameters) y menus (VRCExpressionsMenu) para el sistema de expresiones de VRChat SDK3.

Caracteristicas

• MRAgruparObjetos: Captura estados del avatar (objetos, materiales, blendshapes)
• MRUnificarObjetos: Agrupa frames y genera animaciones OnOff/AB/Linear
• MRIluminacionRadial: Control de iluminacion lilToon
• MRUnificarMateriales: Control unificado de materiales multiples
• MRAgruparMateriales: Agrupacion de materiales alternativos
• MRMenuControl: Orquesta todo y genera archivos VRChat finales
• MRCoserRopa: Sistema de cosido de ropa a avatares (NDMF)
• MRAjustarBounds: Ajuste de bounds de meshes y particulas
• MROrganizaPB: Organiza PhysBones y Colliders en contenedores

Instalacion

Opcion 1: VRChat Creator Companion (Recomendado)

1. Abre VRChat Creator Companion
2. Ve a Settings > Packages > Add Repository
3. Agrega la URL: https://emerytheec.github.io/vpm-listing/index.json
4. Busca “Menu Radial” en la lista de paquetes
5. Click en “Add” para instalarlo en tu proyecto

Nota: Este paquete requiere NDMF. Si no lo tienes, agrega primero este repositorio:

https://vpm.nadena.dev/vpm.json

Luego instala NDMF desde VCC (no necesitas Modular Avatar).

Opcion 2: Instalacion Manual

1. Descarga la ultima release desde GitHub Releases
2. Importa el .unitypackage en tu proyecto Unity
3. Asegurate de tener NDMF instalado

Requisitos

• Unity 2022.3.22f1 o superior
• VRChat SDK3 Avatars 3.5.0 o superior
• NDMF 1.4.0 o superior

Uso Rapido

1. Agrega el componente MRMenuRadial a tu avatar
2. El avatar se detecta automaticamente
3. Click en “Sincronizar” para detectar ropa, pelucas y generar estructura
4. Ajusta los slots (toggles/radiales) segun necesites
5. Click en “Generar Archivos VRChat”

Componentes

Componente	Proposito
MRMenuRadial	Orquestador principal, auto-detecta avatar
MRMenuControl	Genera archivos VRChat (FX, Parameters, Menu)
MRAgruparObjetos	Captura un estado del avatar (frame)
MRUnificarObjetos	Contenedor de frames, genera animaciones
MRIluminacionRadial	Control de iluminacion lilToon
MRUnificarMateriales	Control de materiales multiples
MRAgruparMateriales	Agrupa materiales alternativos
MRCoserRopa	Cose armatures de ropa (NDMF)
MRAjustarBounds	Ajusta bounds de meshes y particulas
MROrganizaPB	Organiza PhysBones en contenedores
MRAnalisisColision	Detecta conflictos con Modular Avatar
MRPesoTexturas	Analisis de peso VRAM de texturas

MROrganizaPB

Componente que reorganiza VRCPhysBone y VRCPhysBoneCollider en contenedores organizados, permitiendo controlar dinamicas desde MRAgruparObjetos.

Problema que resuelve

Los PhysBones normalmente estan “pegados” a los huesos del avatar. Con MROrganizaPB puedes:

• Activar/desactivar dinamicas segun la ropa activa
• Controlar PhysBones independientemente de la geometria
• Organizar componentes por contexto (avatar vs ropa)

Uso

1. Agrega MROrganizaPB a tu avatar
2. Click en Escanear Avatar para detectar PhysBones
3. Click en Organizar PhysBones para moverlos a contenedores
4. Usa MRAgruparObjetos para referenciar los contenedores PhysBones/ y Colliders/

Estructura resultante

Avatar/
├── Armature/
│   └── Hips/
│       └── Hair_Root/     (sin VRCPhysBone)
├── PhysBones/
│   └── PB_Hair/           [VRCPhysBone]
├── Colliders/
│   └── Col_Head/          [VRCPhysBoneCollider]
└── Ropa/
    ├── PhysBones/         (contenedor por ropa)
    └── Colliders/

Tipos de Animacion

• OnOff (1 frame): Genera nombre_on.anim y nombre_off.anim
• AB (2 frames): Genera nombre_A.anim y nombre_B.anim
• Linear (3+ frames): Genera nombre_lin.anim (255 frames)

Enlaces

• Documentacion
• VPM (Creator Companion)
• Booth
• Ko-fi

Licencia

Este proyecto esta bajo la licencia MIT. Ver LICENSE para mas detalles.

Autor

Bender_Dios

Si esta herramienta te resulta util, puedes apoyar el desarrollo en Ko-fi.

Contribuciones

Las contribuciones son bienvenidas. Por favor, abre un issue primero para discutir los cambios que te gustaria hacer.

---

Hecho con :heart: para la comunidad de VRChat