Introduction
Every VRChat avatar creator reaches a point where two things need to work together perfectly: Poiyomi Toon Shader and the VRChat SDK. Getting this setup right is the difference between an avatar that uploads cleanly with stunning materials and one that throws errors, displays pink materials in VRChat worlds, or performs so poorly that other users cannot even see it.
Setting up Poiyomi Shader correctly with the VRChat SDK is not complicated, but it does require following a specific sequence of steps. Skip one step or do them out of order, and you can spend hours troubleshooting problems that should never have existed in the first place.
This guide covers the complete setup process from installing both tools in the correct order to configuring your avatar materials for optimal VRChat performance, locking your shader, and successfully uploading your first Poiyomi Shader avatar to VRChat.
What Is Poiyomi Shader VRChat SDK Setup?
Poiyomi Shader VRChat SDK setup refers to the process of correctly installing, configuring, and integrating Poiyomi Toon Shader within a Unity project that uses the VRChat Software Development Kit for avatar creation and upload.
The VRChat SDK provides the tools needed to build, configure, and upload avatars to the VRChat platform, while Poiyomi Shader provides the material shading system that makes those avatars look visually stunning.
These two tools are completely independent packages. Poiyomi Shader does not require the VRChat SDK, and the VRChat SDK does not require set up Poiyomi Shader.
However, when used together correctly, they form the foundation of nearly every high-quality VRChat avatar created today. Understanding how they interact and how to configure them together is essential knowledge for any serious VRChat avatar creator.
VRChat SDK Versions and Poiyomi Shader Compatibility
VRChat currently uses two SDK versions that creators need to be aware of: the legacy SDK2 and the current SDK3 with Avatars 3.0. Poiyomi Toon Shader is fully compatible with both SDK versions, but SDK3 with Avatars 3.0 is the current standard and the version this guide focuses on. Here is a quick compatibility overview:
- VRChat SDK3 Avatars 3.0 — fully supported and recommended for all new avatar projects
- VRChat SDK2 — supported but legacy and no longer recommended for new projects
- VRChat Creator Companion — the current recommended method for managing VRChat SDK installation
- Unity 2022.3 LTS — the current Unity version required by VRChat SDK3
How Poiyomi Shader and VRChat SDK Work Together
Poiyomi Shader and the VRChat SDK interact primarily at two points in the avatar creation workflow. The first interaction point occurs during avatar material setup, when Poiyomi Toon Shader materials are assigned to avatar mesh components in the Unity scene.
The second and most essential interaction point is during the avatar upload process, where the VRChat SDK compiles the avatar build, and Poiyomi Shader materials must be correctly locked and optimized to pass VRChat’s performance ranking system.
Installing VRChat Creator Companion and SDK3 for Poiyomi Shader Projects
The correct starting point for any new Poiyomi Shader VRChat avatar project is installing the VRChat SDK through the VRChat Creator Companion, the official VRChat tool for managing SDK installations, Unity version compatibility, and project creation.
Setting Up VRChat Creator Companion
Follow these steps to set up the VRChat Creator Companion correctly before creating your Poiyomi Shader avatar project:
- Download the VRChat Creator Companion from the official VRChat website.
- Install and launch the Creator Companion on your Windows PC
- Allow the Creator Companion to install the correct Unity version, currently Unity 2022.3 LTS.
- Create a new Avatar project through the Creator Companion interface.
- The Creator Companion will automatically configure the project with the correct SDK3 version.
- Open the newly created project in Unity & verify the VRChat SDK control panel appears in the Unity menu.
Verifying SDK Installation Before Adding Poiyomi Shader
Before importing Poiyomi Shader into your VRChat project, verify that the SDK installation is complete and error-free:
- Open the Unity Console and confirm there are no red SDK-related error messages.
- Navigate to the VRChat SDK menu in Unity & confirm the control panel opens correctly.
- Check that the Avatars SDK3 folder is present in your project Assets directory.
- Confirm that your Unity project is using the Built-In Render Pipeline, which is required for both SDK3 and the Poiyomi Shader.
- Only proceed with Poiyomi Shader import after confirming a clean SDK installation.
Poiyomi Toon Shader Installation in a VRChat SDK Project
With the VRChat SDK correctly installed and verified, you are ready to add Poiyomi Toon Shader to your project. The import process for a VRChat SDK project is identical to that of a standard Unity project, but it requires one additional consideration: import order matters.
Correct Import Order for VRChat Projects
Always install the VRChat SDK before importing Poiyomi Shader, never the other way around. Importing Poiyomi Shader into a project that does not yet have the VRChat SDK can create configuration states that cause compatibility conflicts when the SDK is added later. The correct import order for a complete VRChat avatar project setup is:
- Install Unity via VRChat Creator Companion
- Create a new project through Creator Companion with SDK3 pre-installed
- Verify SDK installation is clean and error-free
- Import any required third-party tools, such as Dynamic Bones or Physbones
- Import Poiyomi Toon Shader from the official GitHub repository
- Import AudioLink package if audio-reactive avatar materials are planned
- Import avatar base mesh and texture assets last
Poiyomi Shader Post-Import Verification in SDK Projects
After importing Poiyomi Toon Shader into your VRChat SDK project, run through this verification checklist before beginning avatar material work:
- Confirm no red errors appear in the Console relating to either Poiyomi Shader or the VRChat SDK.
- Create a test material with Poiyomi Toon shader applied and verify that the full inspector displays correctly.
- Check that the VRChat SDK control panel still opens correctly after the Poiyomi Shader import.
- Confirm the avatar upload section of the SDK panel is accessible and shows no new errors.
- Test that shader locking works correctly by locking a test material and verifying no errors appear.
Configuring Poiyomi Shader Materials for VRChat Avatars
With both tools installed and verified, the core of the setup process is configuring your Poiyomi Toon Shader materials correctly for use in VRChat. VRChat avatars have specific material requirements that differ from those of standard Unity game projects, particularly regarding performance optimization and lighting compatibility.
VRChat Lighting Compatibility Settings
VRChat worlds use a wide variety of lighting setups, and Poiyomi Shader materials need to be configured to look good across them all. Key lighting compatibility settings to configure in every Poiyomi Shader VRChat material include:
- Set the minimum brightness to a low positive value to prevent completely black materials in unlit worlds.
- Configure the light probe fallback correctly so materials respond naturally to the VRChat world’s ambient lighting.
- Avoid relying exclusively on emission for material visibility; combine emission with proper toon shading for consistent results.
- Test materials in both bright and dark Unity scene lighting to verify they look intentional in both conditions
- Set a reasonable maximum brightness cap to prevent materials from appearing blown out in bright VRChat worlds.
Avatar Material Organization Best Practices
Organizing your Poiyomi Shader materials efficiently before upload saves significant time and prevents common VRChat avatar material errors:
- Create a dedicated Materials folder within your avatar project folder structure.
- Name each material clearly to identify which mesh component and avatar region it applies to
- Keep all textures referenced by Poiyomi Shader materials within the same project folder as the materials themselves.
- Group related materials together: skin materials, clothing materials, accessory materials, and special effect materials
- Maintain a master list of which materials use AudioLink so they can all be verified together before upload.
Poiyomi Shader AudioLink Setup for VRChat
AudioLink is one of the most exciting reasons to use Poiyomi Toon Shader for VRChat avatar creation, and setting it up correctly within your VRChat SDK project requires a few additional steps beyond the standard Poiyomi Shader installation.
Installing AudioLink in Your VRChat Project
AudioLink is a separate package that must be installed alongside Poiyomi Shader to enable audio-reactive material features in VRChat. Here is how to install and configure AudioLink correctly:
- Download the latest AudioLink package from the official AudioLink GitHub repository.
- Import the AudioLink package into your Unity project after the Poiyomi Shader is already installed.
- Confirm there are no console errors after the AudioLink import.
- In your Poiyomi Shader material inspector, locate the AudioLink section and enable it.
- Configure which AudioLink frequency bands drive which material properties based on your creative vision
- Test AudioLink reactivity in Unity using the AudioLink preview tools before uploading
AudioLink VRChat World Compatibility
AudioLink requires a compatible AudioLink source to be present in a VRChat world for avatar materials to react to audio. Here is what VRChat creators need to know about AudioLink world compatibility:
- AudioLink only functions in VRChat worlds that have an AudioLink source installed by the world creator.
- In worlds without AudioLink, Poiyomi Shader AudioLink materials fall back to their static, non-reactive appearance.
- Most VRChat music events and club worlds support AudioLink; it is the standard for audio-reactive content.
- Configure your AudioLink materials to look visually attractive in their static fallback state for worlds without AudioLink support
VRChat SDK Avatar Descriptor Setup With Poiyomi Shader
The VRChat Avatar Descriptor is the SDK component that defines how your avatar behaves in VRChat, including its view position, lip-sync configuration, and avatar dynamics. Setting up the Avatar Descriptor correctly alongside your Poiyomi Shader materials ensures your avatar works as intended after upload.
Add the VRC Avatar Descriptor component to your avatar root GameObject in Unity. Configure the view position to match your avatar’s eye level. Set up lip sync if your avatar has a face mesh with blend shapes. Configure avatar dynamics, including Physbones for any moving parts.
Ensure all Poiyomi Shader materials are assigned to the correct mesh components before adding the Avatar Descriptor, as reassigning materials after descriptor setup can occasionally cause unforeseen behavior in the VRChat build process.
Poiyomi Shader Lock and VRChat Performance Optimization
Locking your Poiyomi Shader materials before uploading your VRChat avatar is not optional; it is essential. Unlocked Poiyomi Shader materials significantly increase avatar build size, reduce performance, and can cause visual inconsistencies between what you see in the Unity editor and what appears in VRChat.
Here is a complete overview of how Poiyomi Shader locking affects VRChat avatar performance ranking:
| Fully Unlocked | Very Large | Very High GPU Cost | Significantly worsens rank |
| Partially Locked | Large | High GPU Cost | Moderately worsens rank |
| Fully Locked | Optimized | Minimal GPU Cost | Best possible rank |
| Locked + Modules Disabled | Smallest | Lowest GPU Cost | Optimal performance rank |
To lock all Poiyomi Shader materials simultaneously, select all materials in your project, and use the Lock All button in the Poiyomi Shader toolbar. Verify each material shows the locked state indicator in its inspector before proceeding to avatar upload.
Uploading a Poiyomi Shader Avatar Through VRChat SDK
With materials configured, AudioLink set up, Avatar Descriptor complete, and all Poiyomi Shader materials locked, you are ready to upload your avatar through the VRChat SDK.
Open the VRChat SDK control panel through the VRChat menu in Unity. Sign in to your VRChat account within the SDK panel. Navigate to the Builder tab and select your avatar GameObject from the scene hierarchy. Review the avatar performance rank displayed by the SDK and aim for a Good or Excellent ranking for the best visibility across all VRChat users.
Handle any validation errors shown by the SDK builder before attempting an upload. Click Build and Upload, provide your avatar name and description, set visibility preferences, and confirm the upload. Wait for the build and upload process to complete. This typically takes between 2 and 10 minutes, depending on avatar complexity and connection speed.
Common Poiyomi Shader VRChat SDK Setup Mistakes to Avoid
Even experienced creators make avoidable mistakes when setting up Poiyomi Shader with the VRChat SDK for the first time. Knowing these common errors saves significant troubleshooting time:
- Importing Poiyomi Shader before the VRChat SDK is fully installed and verified
- Forgetting to lock all Poiyomi Shader materials before attempting an avatar upload
- Using an incompatible Unity version that does not match VRChat SDK requirements
- Enabling too many Poiyomi Shader modules on a single avatar causes a Very Poor performance rank
- Not testing AudioLink material fallback appearance for worlds without AudioLink support.
- Skipping the post-import verification checklist and discovering errors only during the upload attempt
Conclusion
Setting up Poiyomi Toon Shader correctly with the VRChat SDK from the beginning saves enormous amounts of time and frustration throughout your entire avatar-creation workflow.
The key elements of a successful setup include installing tools in the correct order, configuring materials for VRChat lighting, setting up AudioLink properly, locking all materials before upload, and following the SDK upload process carefully, which together produce avatar uploads that look exactly as intended and perform well for every user in VRChat.
Poiyomi Shader and the VRChat SDK are the two most powerful tools available to VRChat avatar creators today.
Mastering how they work together is the foundation of producing professional-quality VRChat avatars that stand out in any world, react to any lighting environment, and deliver the visual experience you have worked hard to create.
Frequently Asked Questions
1. Do I need to install Poiyomi Shader before or after the VRChat SDK?
Always install the VRChat SDK before importing Poiyomi Toon Shader into your Unity project. The correct order is to create your project in the VRChat Creator Companion with SDK3 pre-installed, verify that the SDK installation is clean and error-free, and then import Poiyomi Shader. Reversing this order can lead to difficult-to-diagnose compatibility issues.
Poiyomi Shader materials need to be locked before the VRChat avatar upload?
Yes, locking all Poiyomi Shader materials before uploading a VRChat avatar is essential. Unlocked materials significantly increase build size, worsen avatar performance ranking, and can cause visual differences between the Unity editor preview and the in-game VRChat appearance. Always lock every Poiyomi Shader material using the Lock All button before beginning the avatar upload process.
3. Does AudioLink work automatically with Poiyomi Shader in VRChat?
AudioLink requires a separate package installation alongside Poiyomi Shader and only functions in VRChat worlds that have an AudioLink source installed by the world creator. After installing the AudioLink package and enabling AudioLink in your Poiyomi Shader material inspector, your materials will react to audio in compatible VRChat worlds and fall back to their static appearance in worlds without AudioLink support.
4. Which Unity version should I use for Poiyomi Shader VRChat projects?
Use the Unity version specified by the current VRChat Creator Companion, currently Unity 2022.3 LTS. Always create VRChat avatar projects through the Creator Companion rather than manually to ensure the correct Unity version and SDK configuration are used from the start. Using an incompatible Unity version is one of the most common causes of conflicts between the Poiyomi Shader and the VRChat SDK.
5. How does Poiyomi Shader affect VRChat avatar performance ranking?
Poiyomi Shader materials that are fully locked and have unnecessary modules disabled have minimal impact on VRChat avatar performance ranking. Unlocked materials and materials with many active modules significantly increase GPU cost and worsen performance ranking. For the best possible performance, rank all materials, disable any modules that do not actively contribute to the avatar’s visual design, and use texture atlasing to reduce draw calls.
6. Can I use Poiyomi Shader for Quest-compatible VRChat avatars?
Poiyomi Toon Shader, in its full form, is not compatible with VRChat Quest avatars because Quest uses a mobile GPU architecture that requires shaders from an approved whitelist. For Quest compatibility, you need to create a separate Quest avatar build using a mobile-approved shader. Most serious VRChat avatar creators provide both a PC build using Poiyomi Shader and a Quest build using a Quest-compatible shader alternative.
Latest Post:
