Introduction
Opacity and outline rendering are two of the most visually critical aspects of any Poiyomi Toon Shader material and two of the most bug-prone areas VRChat avatar creators regularly deal with. Whether transparent materials are sorting incorrectly, showing z-fighting artifacts, or outlines flicker, disappear, or render through solid objects, these bugs make an otherwise polished avatar look broken and unfinished.
Every transparency and outline bug in Poiyomi Shader has a logical cause rooted in how Unity handles rendering order, depth testing, and multi-pass shader effects. Once you understand what is causing the visual artifact you are seeing, the fix is almost always straightforward.
This guide covers every transparency and outlines bugs, explains why each one occurs, and walks you through targeted fixes for each scenario.
What Is Poiyomi Shader Transparency plus Outline Rendering?
Transparency rendering in Poiyomi Shader refers to how the shader handles materials that are partially or fully see-through, including cutout transparency, standard alpha blending, and dithered transparency modes. Outline rendering refers to the multi-pass system Poiyomi Shader uses to draw anime-style edge outlines around mesh surfaces.
Both systems interact with Unity’s depth buffer and render queue in ways that can produce unexpected visual results when not configured correctly. Understanding how each system works is the foundation for diagnosing and fixing every bug this guide covers.
Poiyomi Shader Transparency Modes
Poiyomi Toon Shader offers several distinct transparency modes, each with different rendering behavior and different potential bug scenarios:
- Opaque mode renders surfaces with no opacity and has the fewest bug scenarios.
- Cutout mode uses an alpha threshold for hard-edged transparency with no semi-transparency
- Transparent mode uses standard alpha blending to produce smooth, semi-transparent surfaces.
- Dithered transparency simulates semi-transparency through a pixel pattern for performance benefits.
- Each mode interacts with the depth buffer differently, which is the root of most transparency bugs.
How the Outline System Works
The Poiyomi Shader outline system uses an inverted hull technique, a second render pass that draws the mesh slightly scaled outward with a solid color, creating the appearance of an outline around the base. This technique is highly effective for anime-style outlines but introduces rendering order dependencies that are the root cause of most outline bugs.
Why These Systems Produce Bugs
Both tripacity and outlines interact directly with Unity’s depth buffer, which determines which surfaces are visible in front of others. Transparent surfaces cannot write to the depth buffer the same way opaque surfaces do, creating sorting ambiguities when multiple transparent objects overlap.
Outlines rendered during a second pass create depth-buffer interactions that conflict with other materials on the same avatar or in the same scene.
Poiyomi Shader Transparency Sorting Bugs
Transparency sorting bugs are the most commonly encountered category of Poiyomi Shader transparency issues. They manifest as certain materials appearing in the wrong order, rendering in front of surfaces that should be occluding them, or flickering between correct and incorrect sorting as the camera moves.
Root Causes of Sorting Issues
Transparency sorting in Unity relies on camera distance to determine render order. This system breaks down in several specific situations:
- Multiple transparent materials on the same avatar mesh are sorting incorrectly against each other.
- Transparent avatar materials are sorting incorrectly against transparent VRChat world objects.
- Changes in camera angle cause the perceived depth order to shift, resulting in flickering.
- Render queue values are set inconsistently across materials, preventing them from sorting correctly together.
Fixing Transparency Sorting
Resolving sorting bugs requires adjusting render queue values to establish a clear, consistent rendering order:
- Set all opaque Poiyomi Shader materials to render queue 2000
- Set cutout materials to render queue 2450
- Set transparent materials to render queue 3000 as a baseline.
- Adjust individual transparent material queue values by small increments to force the correct sort order.
- Materials rendering behind others have lower queue values, while those rendering in front have higher values.
Poiyomi Shader Cutout Transparency Bugs
Cutout transparency uses an alpha threshold value to decide which pixels are fully visible and which are fully invisible. When cutout transparency misbehaves, the visual result ranges from jagged aliased edges to entire material surfaces disappearing unexpectedly.
Alpha Threshold Misconfiguration
The most common cutout bug is incorrect threshold configuration. Setting the threshold too high results in more pixels being culled than intended, making the material appear to dissolve or have missing sections. Setting it too low allows pixels that should be transparent to remain visible, creating a dirty appearance around edges.
The correct value depends entirely on the texture’s alpha channel. Hard-edged alpha masks work best at 0.5, while softer gradients work best at values between 0.1 and 0.3.
Texture Alpha Channel Problems
Cutout bugs are frequently caused by problems with the texture alpha channel rather than Poiyomi Shader settings:
- Alpha channel absent from the texture file, no transparency data available
- Inverted alpha channel: transparent and opaque areas appear reversed.
- Alpha channel compressed incorrectly during Unity import, jagged or noisy cutout edges.
- Wrong texture assigned to the base color slot, lacking an alpha channel entirely
Fixing Cutout Transparency Issues
Check the texture import settings in Unity first before adjusting Poiyomi Shader threshold values. Verify the texture has an alpha channel, confirm the compression format preserves alpha quality, and check that the correct texture is assigned to the base color slot. Only adjust the threshold value after confirming the texture itself is correctly configured.
Poiyomi Shader Outline Flickering and Disappearing
Outline flickering and disappearing are the most visually disruptive outline bugs in Poiyomi Toon Shader. An outline that flickers between visible and invisible, or disappears entirely at certain camera angles, destroys the anime aesthetic that the outline system exists to create.
Z-Fighting as the Primary Cause
Z-fighting occurs when two surfaces occupy nearly identical depth buffer positions, causing Unity to alternate unpredictably between which is in front. In Poiyomi Shader outlines, z-fighting happens when the outline pass renders at nearly the same depth as the main material surface.
Increasing the outline offset value in the inspector creates greater separation between the outline pass and the main surface, eliminating the depth overlap causing flickering.
Outlines Disappearing at Camera Angles
Outlines visible from some angles but absent from others are caused by the inverted hull technique’s fundamental limitation, outline geometry is only visible from outside the mesh. At extreme angles where the camera looks nearly parallel to a mesh surface, outline geometry clips behind the main surface and becomes invisible.
Increasing outline width and experimenting with different outline modes in the Poiyomi Shader inspector resolves most angle-dependent visibility issues.
Outlines Rendering Through Solid Objects
When Poiyomi Shader outlines render through solid objects that should be occluding them, the outline pass is not interacting correctly with the depth buffer. Ensure the outline render queue is set correctly relative to the main material queue and confirm depth write settings are configured appropriately for the material’s transparency mode.
Poiyomi Shader Transparency & Interaction Bugs
The most complex category involves transparency and lines of incorrect interactions between the same material or between adjacent materials on the same avatar.
Outlines Visible Through Transparentes
When outlines from one mesh render through transparent surfaces on another mesh, the transparent surfaces do not correctly occlude the underlying outline geometry. This happens because transparent surfaces do not write to the depth buffer, leaving the depth information needed to hide objects behind them absent.
Switching from standard alpha blending to dithered transparency mode resolves this issue: dithered transparency writes to the depth buffer are handled correctly while still producing a visually transparent appearance.
Transparent Material Outlines Appearing Incorrectly
Outlines on transparent Poiyomi Shader materials often render incorrectly, appearing fully opaque when the main surface is transparent. This is a render order issue; the outline pass renders after the main surface and does not inherit transparency settings automatically.
Configure the outline opacity setting independently of the main material transparency, and adjust the outline render queue to match the transparent render range.
Multi-Layer Transparent Material Conflicts
When multiple transparent Poiyomi Shader materials are stacked on the same avatar, such as layered clothing, hair, and accessories, their outlines can conflict, leading to complex sorting artifacts.
Assigning incrementally different render queue values to each transparent material layer, starting at 3000 and incrementing by one for each layer above, establishes a deterministic rendering order that eliminates most multi-layer conflict scenarios.
Poiyomi Shader Outline Width and Scaling Bugs
Outline width inconsistencies are a common quality issue that falls short of a full bug but significantly impacts the refined look of a Poiyomi Shader avatar in VRChat.
Outlines that look perfect in the Unity editor frequently appear too thick or too thin in VRChat due to differences in resolution, field of view, and rendering scale between the editor and the platform. Testing outline width specifically in VRChat rather than relying solely on the Unity editor preview is essential.
Enable camera distance scaling in the Poiyomi Shader outline settings to maintain a consistent outline width regardless of how close or far the camera is from the avatar. This single setting resolves most outline-scaling inconsistencies between the editor and VRChat.
Poiyomi Shader Depth Write and Render Queue Reference
Managing depth write settings alongside render queue values is the most reliable approach for resolving transparency and outline conflicts in Poiyomi Shader avatar projects.
Opaque materials should always have depth write enabled and render at queue 2000. Cutout materials should have depth write enabled at queue 2450. Standard transparent materials should have depth write disabled at queue 3000 and above.
Dithered transparency materials should have depth write enabled, despite appearing transparent, which is what makes them useful for correctly occluding outlines. Outlines on any material type should have their queue set to match or slightly exceed the main material queue to ensure correct rendering order between the two passes.
Conclusion
TrOpacity and outline bugs in Poiyomi Toon Shader are among the most visually impactful issues a VRChat avatar creator can encounter, but each has a clear technical cause and a proven fix.
Sorting bugs respond to render queue adjustments; cutout issues respond to threshold and alpha channel corrections; outline flickering responds to offset and depth write fixes; and transparency-outline interactions respond to dithered transparency, along with indent outline configuration.
Approaching these bugs systematically, identifying the specific visual symptom first, understanding the rendering mechanism behind it, and applying the targeted fix produces clean artifact-free results that make Poiyomi Shader materials look exactly as intended across every VRChat environment they appear in.
Frequently Asked Questions
1. Why are my transparent materials sorting incorrectly?
Inconsistent render queue values across transparent materials cause sorting bugs. Set opaque to 2000, cutout to 2450, and transparent to 3000 as a baseline, then increment individual values to establish the correct sort order.
2. Why do my outlines flicker?
Outline flickering is almost always z-fighting between the outline pass and the main surface. Increase the outline offset value in the Poiyomi Shader inspector to create greater depth separation between the two passes.
3. Why do outlines disappear at certain angles?
The inverted hull technique produces visible geometry only on the outside of the mesh, causing it to disappear at extreme camera angles. Increase outline width and try different outline modes. Screen Space outlines eliminate angle-dependent visibility entirely.
4. How do I stop outlines from showing through see-through surfaces?
Switch transparent materials that need to occlude outlines behind them from standard alpha blending to dithered transparency mode. Dithered transparency writes to the depth buffer correctly and hides outline geometry behind the surface.
5. Why do cutout edges look jagged?
Jagged cutout edges are caused by incorrect texture compression in Unity’s importer that introduces noise into the alpha channel. Check the compression settings and verify that the alpha three is equal to thees the softness of your texture’s alpha gradient.
6. Do I need to relock materials after fixing these bugs?
Yes. Always unlock to make changes, apply fixes, then relock immediately after. Never upload a VRChat avatar with unlocked Poiyomi Shader materials, as the performance cost is always high.
Latest Post:
