Skip to main content
Version: 10.0

Download & Install

Quick Download

tip

We recommend using VCC / ALCOM for the easiest install experience. For detailed instructions, see the sections below.


The latest version of Poiyomi Shaders can be installed in one of two ways. Please be aware that there are different versions offered in terms of feature availability.

Method 1: ALCOM / Creator Companion

Installing Poiyomi Shaders using the VCC Repository is our recommended method for the most straightforward and easiest install experience.

tip

We recommend using ALCOM to install Poiyomi Shaders and for managing VRChat Projects overall since it's way faster and easier to use compared to the default VRChat Creator Companion App. Although, using the VRChat Creator Companion is also supported.

If you are using ALCOM to install Poiyomi Shaders, follow the steps detailed below.

If you have registered ALCOM to use the vcc: URL scheme, click the Add to ALCOM button below. If successful, skip to Step 3.

  1. Open Resources and click ADD REPOSITORY.
  2. Enter the URL under the "Enter information about the repository" line and click ADD REPOSITORY:
    • https://poiyomi.github.io/vpm/index.json
  3. When prompted, confirm the following details are displayed, then click ADD REPOSITORY:
    • Name: Poiyomi's VPM Repo
    • URL: The URL you entered.
    • Packages:
      • Poiyomi Toon Shader
      • Poiyomi Pro
  4. Afterwards, head back to Projects, click MANAGE for the project you want to add Poiyomi Shaders to. Go down the list the list and click the icon on ONE version you prefer to install:
    • Poiyomi Toon Shader: The FREE Public version of the shader and the version you will most likely be using.
    • Poiyomi Pro: Our PAID version of the shader. This package contains a script used to authenticate with your Patreon account in order to download the shader's package. To learn more about Poiyomi Pro, see more details below.
  5. Done! Once ALCOM successfully installs the package, launch your Project and enjoy using Poiyomi Shaders.

If an update becomes available, the Latest version number will be highlighted with a Green Box and a Green icon. Click it and hit APPLY when prompted to update to the latest version.

warning

All VCC versions of Poiyomi Shaders will automatically replace any existing copy of the _PoiyomiShaders folder in your Project's Assets in favor of the VCC Version, if it exists. Keep this in mind if you have any older versions in your Project.

If you are going to be using both Toon and Pro, please install the Poiyomi Pro version as it also contains a copy of Poiyomi Toon. You cannot install both packages at the same time!

Method 2: Manual Unity Package

We offer a Unity Package of our shaders for those who prefer to use it. Read the instructions below to learn how to install the package.

  1. Join the Poiyomi Discord Server and download the latest .unitypackage posted in #free-shader channel.
    • OR you can download a stable, but likely outdated version of Poiyomi Shaders from either GitHub or BOOTH .
    • Make sure the file you download is a .unitypackage file, NOT a .zip!!
  2. Import the Unity Package into your Unity Project from the Menu Bar via Assets > Import Package > Custom Package or by Drag & Dropping the file from your File Explorer directly into your Project's Assets folder.
  3. Click Import when prompted.
    • If you instead see a warning from another plugin claiming it's "already installed" then it's highly likely the Avatar Creator already included Poiyomi Shaders (which is bad practice). If this is the case, follow the Updating Instructions below instead.
  4. Done! Enjoy using Poiyomi Shaders.

Updating the Shader Unity Package

When replacing or upgrading versions, you must do the following:

  1. Delete the Assets/_PoiyomiShaders folder in your Project. DO NOT SKIP THIS STEP!
    • Sometimes, Avatar Creators may attempt to hide the folder elsewhere in the project (which is bad practice). If this is the case, make sure you delete it!
  2. Import the newest Unity Package into your Project from the Menu Bar via Assets > Import Package > Custom Package or by Drag & Dropping the file from your File Explorer directly into your Project's Assets folder.
  3. Click Import when prompted.
  4. Done! You are now on the latest version.
danger

DO NOT ATTEMPT to import Poiyomi Shaders over another, or your project may break!

Poiyomi Pro

The Pro version of the shader (also known as Poiyomi Pro) is a Paid Version of the shader, available as a subscription model on Patreon. It contains extra special features that are outlined below.

Before using Poiyomi Pro, please ensure you agree to the EULA and subscribe to the $10/month Tier or higher.

Pro Version: Unity Package

We primarily offer the Poiyomi Pro version as a Unity Package and can be downloaded on our website. This is our recommended method for installing Poiyomi Pro.

To access these versions, follow the instructions below.

danger

It is extremely important that you delete any existing version of Poiyomi Shaders from your project before attempting to install Poiyomi Pro! Failure to do so will cause serious errors!

  1. Login to pro.poiyomi.com and follow the instructions to authenticate with your Patreon Account.
    • If you don't see the pop-up Patreon Login window, check with your Browser to see if a pop-up window was blocked.
  2. If successful, you can then immediately download the latest version of the Pro shader by going to the Downloads page.
  3. You may now proceed with Step 2 of installing Poiyomi Shaders as described above in Method 2..
Notice on official channels

For security reasons, distribution of our newest Poiyomi Pro Unity Packages through Discord is being discontinued! Poiyomi Pro versions will only be offered through pro.poiyomi.com or through our VCC Package and will never be distributed anywhere else!

If your subscription lapses, you may keep a copy of the last Unity Package you downloaded somewhere safe on your computer.

Pro Version: VCC Package

Optionally, we offer downloading Poiyomi Pro using our VCC Package. Things work a little differently, so follow the same instructions as noted above in Method 1: ALCOM / Creator Companion but instead of adding the Poiyomi Toon Shader package to your project, you will instead add Poiyomi Pro.

As stated, things work a little differently with this version. The following sequence will take place:

  1. Upon launching your Unity Project, a script will run that will open your Web Browser. You will then be asked to authorize with your Patreon account on pro.poiyomi.com.
  2. Login to your Patreon account when prompted, and confirm to authorize your connection to Poiyomi Pro.
    • If you've already logged in to this website previously, you will be automatically redirected to the next step.
  3. When successful, a message should appear saying, "Authentication successful. You may now close this window."
  4. Jump back into your Unity Project. Assuming you've successfully authorized linking your Patreon account, the script will automatically begin installing Poiyomi Pro into your project. Enjoy using Poiyomi Pro!
note

Please keep in mind that the scripting in the VCC version is intentionally designed to require an active subscription in order to receive future updates. When updating Poiyomi Pro, you must go through the same process again as detailed above.

By using Poiyomi Pro, you agree to the EULA stated here.

As a reminder, the Pro Shader only includes extra features. Therefore, it is not required if you are trying to access features already available in the Free version.

Features Chart

To see the different features offered between the Free vs. Pro version, refer to the table below:

Role AccessPublic$2/month$5/month$10/month$20/month$50/month
Toon/Pro FeaturesNanoMicroMegaGigaTera
Color & Normals, Color Adjust (Hue Shift), Details
Alpha Options, Back Face, Normal Correct
Decals, RGBA Color Masking
Anisotropics, Matcaps, CubeMap
Rim Lighting, Depth Rim Lighting, Subsurface Scattering
Reflections & Specular, Clear Coat, Environmental Rim
Stylized Reflections, Backlight, LTCGI
Outlines
UV Tile Discard, Proximity Color, Mirror/Camera Visibility
Depth Bulge, Depth FX, Internal Parallax
Emissions, Glitter/Sparkle, Dissolve
Flipbook, Pathing, Stats Overlay
Stats Overlay, Video Effects, Voronoi, Truchet
Audio Link, Global Themes, Global Mask
VRC Light Volumes Support
BlackLight Masking
Stochastic Sampling, Distortion UV, Panosphere UV, Polar UV
Parallax Heightmapping, Post Processing Animations
Lil Fur
Time Source
Vertex Options
Basics & Fun, Glitching, LookAt, Vertex Colors
Shading Styles
Texture Ramp, Multilayer Math, Wrapped, Skin
ShadeMap, Flat, Realistic, Cloth, SDF
Rendering Presets
Opaque, Cutout, TransClipping, Fade, Transparent
Additive, Soft Additive, Multiplicative, 2x Multiplicative
Two Pass Transparency
Grab Pass
Pro Features
Screen Space Ambient Occlusion
Geometric Dissolve
Poiyomi Fur and World Fur
Shatterwave
Tessellated
Tessellated Geometric
Particles
Constellation
Bent Normal Maps
Contact Shadows
Squish
Triplanar Projection
GT7 Tone Mapping
Custom Modules
Wireframe
NameTag
Cubed
EyeFX
Extras
StencilInvis
Can Request a New Feature
Prioritized Features and Shader Request