Как установить Poiyomi: главный шейдер для VRChat-аватаров

Если открыть описание почти любого ассета для VRChat, в зависимостях будет строчка «Poiyomi». Это де-факто стандартный шейдер аватаров: тун-шейдинг, свечение, блёстки, реакция на музыку - всё в одном. Разбираемся, как его поставить и не наступить на классические грабли.

Бесплатный и Pro

• Poiyomi Toon - бесплатная версия, покрывает 95% задач: тун-освещение, эмиссия, матканы, hue shift, AudioLink. Именно её требуют почти все ассеты.
• Poiyomi Pro - платная (через Patreon автора), добавляет продвинутые эффекты вроде трассировки и эксклюзивных фич. Новичку не нужна.

Если ассет сделан «под Poiyomi» без уточнений - достаточно бесплатной.

Установка через Creator Companion

Правильный путь - репозиторий VPM, тогда шейдер обновляется сам:

1. Нажмите кнопку «Добавить в VCC» в начале этой статьи - откроется Creator Companion и репозиторий добавится сам (то же самое делает Add to VCC на официальном сайте poiyomi.com).
2. В VCC откройте свой проект → вкладка Manage Project → найдите «Poiyomi Toon Shader» и нажмите плюс.
3. Готово: в списке шейдеров материала появится раздел .poiyomi.

Запасной вариант - скачать .unitypackage со страницы релизов на GitHub и импортировать вручную, но тогда обновлять придётся руками.

Применение к материалу

1. Выберите материал (или создайте новый: правый клик в Project → Create → Material).
2. В выпадающем списке Shader выберите .poiyomi → Poiyomi Toon.
3. Основные слоты: Base Color - текстура и цвет, Normal Map - рельеф, Emission - свечение (не забудьте поднять Intensity), Outlines - контур в тун-стиле.

Настроек у Poiyomi сотни, они собраны в сворачиваемые секции - включайте только нужные: каждая активная секция немного дороже для производительности.

Блокировка материалов - самое важное

Перед загрузкой аватара материалы Poiyomi нужно заблокировать (Lock): шейдер скомпилирует только использованные функции, и материал станет в разы легче. Способы:

• правый клик по материалу → Poiyomi → Lock Materials;
• либо просто загрузить аватара: свежие версии блокируют материалы при сборке автоматически.

Если после загрузки анимации перестали менять материал (например, смена цвета из меню) - свойство не было помечено как анимируемое: правый клик по названию свойства → Animated до блокировки.

Частые проблемы

• Розовые материалы после импорта ассета - в проекте нет Poiyomi или он старее, чем требует ассет. Ставьте шейдер до импорта ассета.
• «Материал сломался» после обновления версии - откройте материал и переключите шейдер на актуальный .poiyomi/Poiyomi Toon заново.
• Quest-версия аватара розовая - Poiyomi работает только на PC. Для Quest переключите материалы на VRChat/Mobile/Toon Lit - и упростите текстуры.

Ассеты с готовыми материалами под Poiyomi - в каталоге FurHorizon: в описании каждого указаны зависимости и совместимость с PC и Quest.