TOOLHUB
← Volver
UNITY · VRCHAT · SHADER

Poiyomi

Guía visual para entender Poiyomi, ordenar un material, animarlo y evitar configuraciones innecesariamente pesadas.

ToonMatCapEmissionRimAnimation
PlataformaPC
QuestShader móvil aparte
🎨 Resumen

Qué es Poiyomi y para qué sirve

Poiyomi es una familia de shaders orientada a avatares con estilos toon, realistas y efectos avanzados. Su editor agrupa muchas funciones dentro de un mismo material.

🌈
Shading

Toon, realista, cloth, skin y otras formas de controlar luz y sombra.

Efectos

Emission, MatCap, Rim, outlines, decals, dissolve, AudioLink y más.

🧰
Editor

Presets, búsqueda, packing de máscaras y herramientas para gestionar materiales.

📦 Instalación

Forma limpia de instalarlo

1

Usa VCC/VPM

Para proyectos VRChat, una instalación mediante repositorio VCC/VPM facilita versiones y dependencias.

2

Evita mezclar versiones

No importes encima paquetes viejos de procedencias distintas sin revisar. Mezclar archivos del shader suele acabar en errores de compilación.

3

Haz backup antes de actualizar

Especialmente si tienes materiales complejos, presets propios o animaciones sobre propiedades del shader.

🟣 ToolHub: actualmente VRChat usa Unity 2022.3.22f1. Mantén el proyecto en la versión soportada por VRChat.
🧱 Bloques principales

Orden recomendado al crear un material

1 · Color & Normals
2 · Shading
3 · Reflections / MatCap
4 · Emission / FX
5 · Rendering

Color & Normals

Textura principal, color, normal maps y detalles de superficie.

Shading

Decide cómo responde el material a la iluminación del mundo.

MatCap / Specular

Reflejos y apariencia metálica o estilizada sin necesitar geometría extra.

Emission

Permite zonas autoiluminadas y efectos visuales que siguen visibles en ambientes oscuros.

⚡ Optimización

Activa solo lo que realmente necesitas

  • Evita transparencias si una solución Opaque/Cutout funciona igual.
  • No añadas cuatro MatCaps, varios rims y múltiples emisiones solo porque están disponibles.
  • Reutiliza máscaras y empaqueta canales cuando tenga sentido.
  • Reduce material slots del avatar; cada slot termina creando trabajo adicional de render.
  • Prueba el material en mundos claros y oscuros antes de considerarlo terminado.
🟢 Consejo: un material “simple” bien configurado suele verse mejor que uno cargado con efectos que compiten entre sí.
🎞️ Animación

Propiedades animadas

Poiyomi puede exponer propiedades del material para que Animation/Animator las modifiquen: emission, colores, máscaras, UV, dissolve y muchas otras. Anima solo lo necesario y evita crear estados que cambian decenas de propiedades sin motivo.

Material
Propiedad
Animation Clip
Animator / FX
📱 Quest / Android

Poiyomi no es el shader del avatar móvil

VRChat restringe los shaders de avatares Android/Quest a los shaders móviles incluidos en el SDK. La versión móvil del avatar debe usar materiales compatibles con esas restricciones.

🔴 No hagas esto: asumir que porque un material Poiyomi funciona en PC también funcionará en Quest.
🛠 Diagnóstico

Problemas habituales

Normalmente indica shader ausente o error de compilación. Comprueba que Poiyomi esté instalado correctamente y revisa Console.
Revisa emission, reflections/specular, light data y MatCap antes de culpar a la textura.
Comprueba que la propiedad animada siga existiendo con el mismo nombre y que el material asignado sea el correcto.
🔗 Referencias

Fuentes oficiales