Poiyomi vs lilToon: Choosing a Shader for Your VRChat Avatar

seabug
seabug
November 16, 2026 • 7 views

Poiyomi and lilToon are the two names you'll hear most when people talk about toon shaders for VRChat. Both are free at the base level, both are mature, and both work on PC. They work differently, though. Poiyomi is a big feature set with an optional paid tier and a locking system. lilToon is lighter and mostly runs on presets, so there's less to learn.

Poiyomi or lilToon? The short version

Go with Poiyomi if you want the most features, you don't mind locking materials, and you might buy Pro later. Go with lilToon if you want a light, clean look with good presets and fewer moving parts. Neither one gets you onto Quest. Android avatars can only use the shaders in the VRChat Mobile list, and neither Poiyomi nor lilToon is on it.

Advertisement

Poiyomi vs lilToon at a glance

Question Poiyomi Toon Poiyomi Pro lilToon
Price Free Paid, tiered on Patreon Free, open source (MIT)
Latest public version (Nov 2026) 10.0.29 (released 2026-11-05) Same release line as Toon 2.4.1 (released 2026-10-20)
Install routes VCC or ALCOM, or unitypackage VCC or ALCOM after sign-in, or Pro package VCC, UPM Git URL, or unitypackage
Locking and optimization Yes, Lock In Optimized Shader Yes, same system Editor strips unused features
Extra features Core set Many advanced features Presets and color adjust
Quest / Android Not in VRChat Mobile list Not in VRChat Mobile list Not in VRChat Mobile list

Check the Pro feature list on the official Poiyomi download page before you pay for anything. Neither shader is on the Quest list, so neither works for Quest avatars.

What Poiyomi does

Poiyomi is a large, modular toon shader. The free Poiyomi Toon covers outlines, decals, matcaps, emission, dissolve, glitter, Audio Link, global themes and masks, LTCGI, light volumes, and several shadow styles. Fur, tessellation, particles, contact shadows, and a few shader-effects modules are in Poiyomi Pro.

The current stable line is Poiyomi 10.0. Version 10.0 came out on 2026-09-14 and removed the legacy versions 7.3 through 9.2. If your materials came from one of those, translate them to 9.3 first. The docs site lists 11.0 as being tested, but 10.0 is the one to install today.

What lilToon does

lilToon is a feature-rich toon shader built for avatars. It comes with one-click presets, a lightweight build that strips unused features in the editor, and support for a wide range of Unity versions. It's MIT licensed on GitHub. The latest release is 2.4.1, published 2026-10-20.

If you want good results with little setup, lilToon is the easier start. If you want the deepest control over each material, Poiyomi gives you more.

How to install Poiyomi

The easiest route is the official Poiyomi repository. Add this URL to VCC or ALCOM:

https://poiyomi.github.io/vpm/index.json

Then add Poiyomi Toon to your project. ThryEditor, the inspector Poiyomi uses, comes with it. Poiyomi Pro is a separate package. It installs through a Patreon sign-in and the Pro download service. The official page warns that you can't have Toon and Pro in the same project.

Use one package from the release. The GitHub release for 10.0.29 has a VRChat and built-in pipeline package (Poi.Toon.10.0.29.unitypackage) and a URP package for BasisVR (Poi.Toon.URP.10.0.29.unitypackage). Pick the one that matches your project. Don't install both.

Importing a unitypackage by hand

If you need a specific build, you can import the unitypackage. Go to Assets > Import Package > Custom Package and pick the file. We'd skip this route unless you have a reason, because the VCC package keeps versions straight. When you update a unitypackage install, delete Assets/_PoiyomiShaders first. Never import a new version over an old one.

How to install lilToon

lilToon is on VCC too. Use this repository URL:

https://lilxyzw.github.io/vpm-repos/vpm.json

You can also add it by UPM Git URL: https://github.com/lilxyzw/lilToon.git?path=Assets/lilToon#master. lilToon's docs have a section on distributing works that use the shader, so read it before you share a package.

Stick with Unity 2022.3.22f1 for VRChat. That's the version Poiyomi's docs list for VRChat.

Locking and optimization

Both shaders aim for good runtime performance, but they get there in different ways.

Locking Poiyomi materials

Every Poiyomi shader has a Lock In Optimized Shader button at the top. Locking strips code and fixes values for properties you don't animate, which makes the material cheaper to render. Unlocked materials carry every feature, so they also cost more in the editor.

Two things trip people up. First, animate before you lock, and mark properties first. Right-click a property and pick Animated (When Locked) or Renamed (When Locked). Renamed properties get a unique suffix based on the material name. Lock the materials before you record any animation that uses renamed properties, or the animator records the wrong name.

Second, uploads lock for you. When you build or upload, Poiyomi locks every Poiyomi material in the avatar. You'll see a one-time message the first time it happens, so don't plan on uploading with unlocked materials. Locking can also help with the 64 texture slot crash that shows up in scenes full of complex materials.

lilToon optimization

lilToon handles this on its own. The editor switches features on and off as you use them, so unused features don't end up in the build. You don't lock materials by hand. If you'd rather skip a lock workflow, lilToon is the simpler pick.

Habits that help either shader

VRChat's avatar tips recommend these habits for any shader:

  • Avoid tessellation.
  • Avoid extra shader passes.
  • Avoid excessive keywords, and clear old ones with an SDK tool.
  • Avoid transparency unless the look needs it.

Shader choice usually matters less than texture size and triangle count. Read the performance guide alongside this one. The performance ranking is static. It doesn't account for shaders, textures, animators, or pixel lights, so a good rank doesn't tell you much about your shader.

Does Poiyomi or lilToon work on Quest?

No. On Android you can only use the VRChat Mobile shaders included in the SDK. That list is Toon Standard, Standard Lite, Bumped Diffuse, Bumped Mapped Specular, Diffuse, Matcap Lit, Toon Lit, and two particle shaders. Neither Poiyomi nor lilToon is on it, so an avatar built on either one is a PC avatar.

If you need a Quest version, build a separate avatar with the VRChat Mobile shaders. The Android limits are much tighter. The Excellent ranking allows 7,500 triangles, 10 MB of texture memory, one material slot, and no PhysBones. The default mobile block is Medium, so Poor and Very Poor avatars stay hidden unless a user chooses to show them.

Android also turns off a lot of components, including cloth, lights, cameras, audio sources, and colliders. If your avatar depends on any of those, the look won't carry over.

How to switch an avatar from one shader to another

Switching is possible, but it isn't a one-click job. Here's the order we'd follow:

  1. Back up the whole project folder, not just the materials.
  2. Check the source version. If your materials came from an older Poiyomi version, translate them to 9.3 first, then to 10.0. Version 10.0 removed the older ones.
  3. Use the built-in translation. Poiyomi 10.0 adds a Material Upgrade Utility, and the LilToon 2.3 to Poiyomi 10.0 translation got better in that release. Try it on a test avatar before you touch your main one.
  4. Compare the materials in the editor. Grab Pass setups are where translation most often needs manual fixes.
  5. Lock and test. For Poiyomi, lock the materials and check any animations that use properties. For lilToon, build the avatar and test it in the SDK.

Common problems

Pro features disappear

If a Pro feature stops showing, the Pro package isn't in your project, or Toon and Pro got mixed together. Reinstall one package from one source.

Two Poiyomi copies conflict

The VCC package replaces _PoiyomiShaders and the ThryEditor folder. Keep one copy in the project.

Materials look different after a switch

Translation isn't perfect. Compare the shadow, rim, and outline settings, and check any emission and Audio Link setup.

The avatar blocks on mobile

Quest blocks are about polygons and memory, not the shader. Cut triangles and textures before you change the shader.

Viewers see a fallback

Some users block shaders, and VRChat swaps in a fallback. Shader authors can set VRCFallback tags to pick a better one. Check the VRChat shader fallback page and each shader's docs before you count on a specific look for blocked viewers.

For the wider setup, read the install guide. If a material turns pink after a shader change, the pink material guide covers that.