リアル影システム (for Avatar) PCSS For VRC

※導入前に本ページを最後まで読んでください。ほとんどのトラブルの解決法は書いてあります。

lilToonまたはPoiyomiシェーダーに対して、リアルタイムに高解像度な影を比較的低負荷で落とすアバターギミックです。

前髪や、顎、胸といった様々な部位の影がつくことで、圧倒的な立体感・存在感が表現できます。

影の濃さや、柔らかさ、色、ワールドライトの影響度などを自在に設定できるので、アニメ調からトゥーン超、リアル調まで様々な表現が可能です。

（※負荷については下部に記載があります）

また普段使いを想定して、ノーマルのlilToon/Poiyomiの状態にExpressionMenuから切り替えることもできます。

セットアップツールが付属しており、ワンクリックでセットアップな上、非破壊で使用することができます。

※nHarukaの実験室サポートDiscordサーバでは各ギミックのトラブルシューティングやプリセット共有、便利なTipsなどが集積されています。

お困りの際は一度ご参照ください。

https://discord.gg/zuaYSC5FHg

※商品ページの画像・動画に映っているアバター・衣装などの3Dモデルは商品に含みません。

Instructions for the English version can be found in the second half of the document.

前提条件

・Unity2022.3.22f1

（※Unity2019は動作対象外です）

・VRChatSDK Avatar 3.8.0 or later

（※バージョンが低いとマテリアルエラーになります）

・lilToon v2.0 or later

- PoiyomiProv10.0.15 or later

- PoiyomiToon v9.3.64 or later

・Quest版アバターには適用不可

機能詳細

PCSS（Percentage Closer Soft Shadows）という距離に応じて影の柔らかさを変動させる仕組みをVRChatで使えるようにカスタマイズしたものです。

これにより、リアルタイムに高解像度な影を比較的低負荷で落とすことができ、前髪や、顎、胸といった様々な部位の影がつくことで、圧倒的な立体感・存在感が表現できます。

PCSSの実装としては、下記OSSを参考に作成したシェーダーを使用しています。

https://github.com/TheMasonX/UnityPCSS

・lilToonもしくはPoiyomiをPCSS用にカスタムしたカスタムシェーダーをアバターに組み込みます。

・上記シェーダーはワールドのライトの影響を抑え、アバターにセットアップされたスポットライトの影響を支配的に受けるように設定されています。

・上記にある通り、セットアップツールはアバターにスポットライトを組み込みます。

・スポットライトはHeadを照らすようになっています。

・スポットライトの向きはPhysBoneでコントロールすることができます。

・ライトの強さはExpressionMenuからコントロールすることができます。

・ライトの色もExpressionMenuからコントロールすることができます。Hueが色相、Saturationが彩度です。

・ワールドライトの色を、自身のライトの色に反映させることができます。

（※カメラコンポーネントを使用しているため、他人視点からは、フレンドかAvatarDisplayしている場合にしか反映されません。）

・ExpressionMenuのRemoteShadowOnをオフにすると、他のプレイヤーの視点では影が映らなくなります。

・ExpressionMenuのLocalShadowOnをオフにすると、自分の視点では影が映らなくなります。

・マテリアルの「カスタムプロパティ」で、影の柔らかさ、濃さ、ワールドライトの影響度の調節、マスクの設定などが可能です。

・一部のアバターで白目に瞳等の影が映りこんでしまうアバターがありますが、マスク機能を使うことで、影を落としたくない箇所をマスクできます。

・Unityの通常の仕様では、半透過オブジェクトは影がつきません。これを改善し、半透過と影を両立しました。

（※RenderQueue2500以下が必須）

・主にアニメ調向けに影の境界をくっきりさせるShadowClamp機能が追加されました。

マスク機能について

マスク機能を使うことで、影を落としたくない箇所をマスクすることができます。

一般的に影は、①光を遮り影を作るオブジェクト（遮蔽物）と②それによって影になるオブジェクト（被遮蔽物）の２つのオブジェクトが作用します。

それに応じてリアル影システムには２種類のマスクがあります。

①ReceiveMask（被遮蔽物をマスク）

影の受け取りをマスクする機能です。マスクすると影を受け取らなくなり、強度に応じて影にならなくなります。

※こちらはグラデーションが可能です。

→主に、あまり影を濃くしたくない場所（白目、瞳など）をグレーで塗って、明るさを調節するような用途で使います。

②CastMask（遮蔽物をマスク）

マスクした個所の影を落とさないようにする機能です。マスクした部位の影は投影されなくなります。

※こちらはグラデーション不可で、マスクするかしないかの２値です。

→主に、影が落ちてほしくない部位（白目など）『の周囲のパーツ（瞼、まつげ、瞳など）』を黒で塗って、影を落とさないようにする用途で使います。

マスクの作り方は以下です。

①白いテクスチャを用意する。

②マスクしたいメッシュの元のテクスチャの座標を参考に、マスクしたい部分を黒く塗りつぶす。

③作成したテクスチャをマテリアルのプロパティの_xxxMaskTexにセットする。

また、ユーザーが作成したマスクテクスチャの共有所が下部記載のDiscordサーバーにあります。

導入手順

0. 以前のバージョンが入っている場合は、"Assets/nHaruka/PCSS4VRC"フォルダを削除する。

（セットアップ済みのものはいったんマテリアルエラーになりますが、再インポートすれば戻ります）

1. lilToonVer2.0以上またはPoiyomi Pro v10.0.15/Toon v9.3.64以上を導入する。

2. 本パッケージをインポートする。

3. メニューバー「nHaruka」→「PCSS For VRC」を押す。

4. 表示されたウインドウの「Avatar」欄にアバターをD&Dする。

5. 導入手順を確認の上Setupを押す

6. アバター直下のPCSS_Setup_for_MAのメニューでプレビューするかPlayモードに入って見た目を確認する。

7. 必要に応じてPCSS_Setup_for_MAのメニューか各マテリアルのパラメータを調整する。

※AV3Emulator（VCCから追加できます）を入れないと（GestureManager不可）、UnityEditor上ではPlayMode時に真っ暗になります。これは確認用のEditorOnlyライトが削除された上、アバターのレイヤーをVRChatと同等に設定しないと、ライトに照らされないためです。

※アバターにlilToonが同梱されていたりするとバグります。同梱されているlilToonを削除する等して、lilToonがプロジェクト内で重複しないようにしてください。

他プレイヤーに正常に表示させるためのTIPS

・UserランクはTrustedにしてください。（User偽装機能を使うとデフォルトセーフティ設定ではフレンド以外に表示されなくなります。）

・RemoteShadowOnをオフにすると、他のプレイヤーの視点では影が映らなくなります。影の処理負荷を気にされる場合はこちらを使ってください。

・LocalShadowOnをオフにすると、自分の視点では影が映らなくなります。

・マテリアルのプロパティのShadow Distanceを超えた距離からは影が見えなくなります。

負荷について

本システムは作者が考えうる限りの負荷軽減策を実装しておりますが、ある程度の負荷上昇は発生いたします。しかしこれは通常のプレイにおいては許容範囲内であると考えております（※作者の検証環境に基づく私見となります）。

これまでの検証におきましても、本システム単体が原因で極端なパフォーマンス低下を引き起こす状況は観測されておりません。

VRChat界隈では「リアルタイムライト＝無条件に重いもの（避けるべきもの）」というイメージが先行しがちです。確かに設定次第では負荷が高くなりやすい機能ですが、決してそれ自体が悪というわけではなく、用途や環境に合わせて適切にチューニングを行えば、負荷をコントロールしながらリッチな表現を可能にする有用な技術です。

「リアル影システムは重い」というご意見をいただくこともございますが、これは本システムが視覚的に分かりやすいことと、他の負荷の高い要素（元々負荷が高めのアバター構成など）と組み合わさった際に、本システムが原因として認識されやすいためではないかと推測しております。

具体的に、本システムによって増加する負荷の要因は以下の3点です。

①ShadowMapの生成とShadowCasterPassの追加

アバターにライトが追加されることで、影の計算に必要な深度データ（ShadowMap）を生成する処理が発生します。影を落とすマテリアルごとにShadowCasterPassが実行されるため、これに伴いSetPassCall（主にCPUの負荷）が増加します。

②ForwardAddPassの追加

追加されたライトの「光」をアバターの各マテリアルに重ね塗り（加算）するため、ForwardAddPassが追加されます。このパスも影響を受けるマテリアルごとに実行されるため、さらにSetPassCall（主にCPUの負荷）が増加します。

③影の計算自体の負荷

光の当たり方や、①で生成したShadowMapを参照して影の落ち方を計算する処理であり、こちらは主にGPU側の負荷となります。（※アバターが画面に大きく映った際など、描画範囲が広くなるほどGPU負荷は上昇します）

このうち、「①」と「②」の負荷はアバターのマテリアル数に比例して増加します。

VRChatの仕様上、SetPassCallの増加はボトルネックになりやすいため、PC（特にCPU）のスペックが高くない環境において、マテリアルスロットが大量にあるアバターに本システムを適用した場合、パフォーマンス低下の要因となり得ます。

逆に言えば、マテリアル数が極端に多すぎない、一般的な着せ替えの範囲内に収まっているアバター（公式のパフォーマンスランクではVery Poorに該当しますが、実運用の目安として32〜64スロット程度）であれば、リアルタイムライトの負荷は十分にコントロール可能であり、本システムが致命的な問題に繋がることは少ないと考えております。

ただし、本システムを使用するユーザーが同じインスタンスに多数集まった場合、SetPassCallの増加が累積し、フレームレート低下を招く可能性がある点についてはご留意ください。

常用する際の注意

可能な限り他プレイヤーへの負荷を低減する措置を施していますが、それでも元のアバターの処理負荷に比例して処理負荷は上昇します。特にマテリアル数は負荷に直結しやすいです。

常用する場合はできるだけ最適化（マテリアルを統合する、ローポリ化する等）を施したアバターで使用し、Shadow Distanceを必要最低限に抑え、さらに『Test Samplers』を12以下、『Filter Samplers』を24以下（デフォルト）に設定することを推奨します。

（最適化にはAvatarOptimaizerがおススメです。https://booth.pm/ja/items/4885109）

他人から見て影が不要な場合は、RemoteShadowOnをオフにして、他人視点での影を無効にしてください。

なお、ver4.1.0からCullingMatrixOverrideとBoundingSphereOverrideを導入しました。これは光や影の影響範囲をUnityデフォルト設定に対して上書きするもので、パフォーマンス向上に貢献します。

一方で、影響範囲を出てしまうと影が出なくなったりしてしまうので、WorldFixを多用される方はご注意ください。

※どうしてもこれらの機能をOffにしたい場合は、"Assets/nHaruka/PCSS4VRC/ShadowCullingOff.preset"をライトコンポーネントに適用してください。

ワールドにも影が落ちるアドオン（ShadowCast Addon）について

動画４つ目にあるように、アバター自身だけでなくワールドオブジェクト等に影を落とすことができるようになるアドオンです。

Expressionメニューから影の濃さやOn/Offを制御できます。

【導入手順】

1.リアル影システム本体を先に導入する。

2.メニューバー「nHaruka」→「PCSS For VRC ShadowCastAddon」を押す。

3. 表示されたウインドウの「Avatar」欄にアバターをD&Dする。

4. Setupを押す。

【注意点】

・ワールドだけでなく他アバター等にも影をキャストします。

・ライトの影生成範囲を出ると影が途切れることがあります。

・他オブジェクトの影はミラーには写りません。（VRChatの仕様です）

・Stencilが設定されているオブジェクトには影が映らず、その部分だけ透けてるように見えることがあります。

【更新履歴】

[2024-10-30: v1.0.2] 初公開。

[2024-11-02: v1.0.3] 影響範囲を5mに。

[2024-11-14: v2.0.1] 光の当たっていない部分の処理をスキップすることで、大幅にパフォーマンス向上。

[2024-11-25: v2.1.3] Modular Avatarに対応。

[2026-03-09: v3.0.0] 本体ver9.0.0に対応。

[2026-04-02: v3.1.0] 本体ver9.2.0に対応。

上手くセットアップできない場合の確認項目

・マテリアルエラーになる原因の9割はlilToonのバージョンミスマッチです。アバターにlilToonが同梱されていたり、unitypackage版とVCC版の重複等により、最新版を入れたつもりでも正しく導入されていないことがあります。マテリアルのインスペクター欄のバージョンが最新か確認してください。

・アバターの一部が真っ暗になってしまう場合は、マテリアルのRenderQueueが2500以上の可能性があります。マテリアルを開いてRenderQueueを2500以下にしてみてください。

・VRChatSDKがv3.9.0未満の場合でもマテリアルエラーになります。VCCからSDKのバージョンをあげて下さい。

・ExpressionMenuが機能しない場合の原因の殆どは、上書きインポートによる不完全なインポートです。Unityの上書きインポートは信頼できないので、挙動がおかしい場合は削除してからインポートしなおしてください。

・半透明マテリアルの落とす影は、場合によってはひどいノイズとなる可能性があります。マテリアルプロパティのRendering設定の "Subpass Cutoff"を0にすることで影を半透明ではなくすことができます。

Unity上での動作について

NDMF(ModularAvatar等)が有効だと、PlayMode時にEditorOnlyのオブジェクト（検証用ライト）が削除されてしまいます。

GestureManagerはアニメーションをエミュレートしますが、Layerはエミュレートしないので、inGameではPlayer/PlayerLocalレイヤーになるはずのアバターオブジェクトがDefaultレイヤーのままになるので、アバターが照らされなくなります。

AV3 Emulatorはレイヤーまでエミュレートするので、検証はそちらを推奨します。

VCCから追加できます。

既知の不具合・注意事項

・CastMaskをかけたときに、メッシュのライトから見て反対側も影がつかなくなります。

・LightIntensityが10%以下になると、ライトの影響が無効になります。

・ごくまれにライトが消灯するワールドが存在します。原因調査中です。

・v4.4.5からライトの合成モードを加算にしました。これにより複数のリアル影用ライトを浴びると白飛びすることがあります。

・半透明オブジェクトが重なる場合、手前のオブジェクトのRenderQueueが高い場合に正しく表示されます。（これはUnityの仕様です）

・RenderQueue2500以上のオブジェクトは影を受け取りません。（これもUnityの仕様です）

・ファーシェーダーはサポートしておりません。（高負荷になりすぎるため）

・ステンシルマスクがデフォルトでwrite 125になっています。

アップデート履歴

<v5未満はDiscordに移行しました>

[2024-10-25: v5.0.2β(lilのみ)] PCSS版を改良してNGSS版を廃止。Expressionをコピーする機能を追加。

[2024-10-26: v5.1.0β(lilのみ)] AvatarやFX, ExParam等がセットされてないとセットアップできないようにした。スポットライトでめっちゃ明るくなる問題を修正。SoftnessRange項目を追加。コピーセットアップ機能を修正。

[2024-10-30: v5.2.3(lil/poi)] ShadowCastアドオンに対応。Poiyomi版を最新に。

[2024-11-02: v5.2.4(lil/poi)] アーティファクト軽減のために、マテリアルのデフォルトパラメーターを変更。

[2024-11-14: v6.0.2(lilのみ)] サンプリングロジックを大幅に改良し、ノイズ軽減のほか、より少ないサンプリング数での描画が可能となり、パフォーマンスが向上。半透明オブジェクトから半透明の影が投射されるように。

[2024-11-14: v6.1.8(lilのみ)] Shadow Casterを改良。メッシュ形状状のアーティファクトがでにくくなった。一部Modular Avatarに対応。Shadow Bias Mask機能を追加。

[2024-12-02: v6.1.9(lil, poi)] Shadow Casterの干渉防止ロジックを修正。poiyomi対応。

[2024-12-04: v6.1.10(lil, poi)] 影色の合成ロジックを戻した。poiyomiPro版でセットアップ時にマテリアルが変換されない問題を修正。

[2025-01-22: v6.1.11(lil, poi)] VRCカメラの画面にAutoColorAdjustが反映されていない問題を修正。

[2025-02-02: v6.1.13(lil)] 半透明マテリアルが半透明の影をキャストしない問題を修正。

[2025-06-18: v7.0.2(lil)] マテリアルプロパティをExpressionMenuから操作するアニメーションを作成するツール（PCSS For VRC MaterialAnimationCreater）を追加。これによりデフォルトlilToon相当に切り替えが可能に。その他アニメーション等の微修正。

[2025-08-11: v8.1.2(lil,poi)]

・セットアップ時に除外メッシュを指定可能に

・Assets/nHaruka/PCSS4VRC/OptionalLight.prefabを追加すると、複数ライトつかえる（強度とか色とかはメインライトと共通）

・lilToon2.x対応

・Poiyomi9.7.x対応

・まっさらなlilToonに切り替え機能を強化

・セットアップ時に切り替えスイッチを入れるオプションを追加

・ノーマルマップの凹凸を影に反映させるように

・上記の強度をマテリアルプロパティで調節可能

[2025-08-14: v8.1.3(lil,poi)] VRC上で真っ暗になる問題を修正

[2025-09-08: v8.2.2(lil,poi)] VRC上で歩行時にライトがちらつく問題を修正。ライトの範囲外にでると一定範囲で不適切な影が表示される問題を修正。スポットライトの角度とかを少し見直し。lilToonLiteなどの一部シェーダーでの不具合を修正。OptionalLightのセットアップオプションを追加。

[2026-01-24: v8.3.2(lil,poi)] マテリアルバリアントに対処。Poiyomi v9.3.63に対応。セットアップツールにFAQを追加

[2026-02-06: v8.4.2(lil,poi)] リアル影システム使用者同士が近づくと光源の強さを自動的に弱めるようにした（最大50%）

[2026-02-20: v9.0.5] ほぼ非破壊化。

[2026-03-09: v9.0.6] PoiyomiでRevertとRemoveMaterialsがうまく動かない問題を修正。

[2026-03-31: v9.1.0] Poiyomi v10.0.9に対応。

[2026-04-02: v9.2.0] ShadowCastAddonがv9.1.0に対応してなかったのを直した。OptionalLightに強さオプションをいれた。

[2026-06-05: v9.5.1] 便利機能系を大きくアップデート。元のマテリアルの設定を都度引き継ぐオプションを追加。RenderQueueを2500以下に強制するオプションを追加。プリセット機能を追加。見た目の補正機能を強化。ReceiveMaskを設定しても暗くなったときに相対的に光ってるように見えるのを直した。影色のロジックを改良。影境界を色を付ける機能を追加。影色をベースカラーに合わせて色味を調整する機能を追加。ゲーミングの色回転速度が当社比２倍に。Poiyomiのライト関連処理をやり直した。

[2026-06-06: v9.5.2] UIの色を見やすくした。

[2026-06-13: v9.6.0] アバターにノーマルマップが一枚もアサインされていない状態だと、真っ暗になる問題を修正。ワールドのディレクショナルライト（アバターライト）の影響度をExpressionMenuで調整できるように。

[2026-08-14: v10.0.10]

・MAMaterialSetterとAMCのマテリアルアニメーションに対応

・MaterialAnimationCreatorを修正・改良

・NonToon版を試験対応

・２回目のWorldFixの際に位置がおかしくなる問題を修正

・ちらつき対策オプションを追加

・マスクテクスチャのアサイン機能を親切にした

・Poiyomi Toon v9.3.64との互換性をどうにかした

・Poiyomi Pro v10.0.15に対応（それ以前には対応しない）

・カメラ上でワールドライトの色が反映されない問題を修正

・ワールドのポストプロセスやカメラのフォーカスが正常に動作しない問題を修正

[2026-09-07: v10.1.5]

・側面影の質感を改善

・影の表示対象に「フレンドのみ」を追加。

・影OFF時に専用ライトを実際に無効化するようにした。

・メニュー構成を整理した。

・若干のパフォーマンス改善

・インスペクターやメニューの表示名の日英対応

・OptionalLightのWorldFixがRotationしちゃう問題を修正

・Unity上でOFF状態でアップロードされたオブジェクトが暗くなる問題を修正

利用規約

・Unitypackageそのものやそれに含まれるアセット、ソースコードの一部または全部の二次配布は禁止します。

・ギミックの機構、コンセプトをそのまま模倣し販売することを禁止します。

・本ツールを使用してPCSS For VRCを組み込んだアバターのPublishは可ですが（※PoiyomiPro版PoiyomiProの規約により不可）、unitypackage等アセットを取り出し可能な形での再配布は不可とします。

・販売アバターへの組み込みは個別にご相談ください。

・法人利用は個別にご相談ください。

・画像作品、映像作品への利用は自由です。可能であればクレジットいただけると嬉しいです。

・映像作品などでの設定値のコンサルティング、シェーダーの部分カスタマイズなども条件次第で承ります。お問い合わせください。

・PCSSの影シェーダーは下記オープンソースプロジェクトのコードを参考にしています。

https://github.com/TheMasonX/UnityPCSS

バグ報告・サポートについて

バグ報告やサポート依頼については、下記Discordに一元化しております。

お困りの際は下記へお問い合わせください。

※下記以外からお問い合わせ頂いても回答できない場合がございます。

https://discord.gg/zuaYSC5FHg

サポートガイドライン（抜粋）

・他ギミックとの複合的な問題やUnityのバグ、その他作者の知見を超える内容についてはご回答できない場合があります。

・リクエストの内容が不鮮明である場合、回答が困難な場合があります。

・申し訳ございませんが、質問する前に商品ページを一読ください。自明に記載されている事項については都度回答できない場合がございます。

リアル影システムを用いた商品紹介・広告等に関するガイドライン

昨今、ありがたいことにリアル影システム（PCSS4VRC）を商品紹介等にご利用いただくことが多々あります。しかし、消費者が商品に含まれないもの（リアル影システム）が含まれていると誤認してしまうと景品表示法の優良誤認表示に該当してしまう恐れがあります。そのような事態を避けるため、リアル影システム（PCSS4VRC）を用いたアバター等を使って衣装やアバターなどの紹介動画・紹介画像・販促ポスターなどを公に公開・掲示する場合は下記の事項に留意してください。

1. リアル影システムが強調されるような表現が含まれる場合（例：影表現を付けることを意図して行った場合など）、影の効果などはリアル影システムによるもので商品単体にリアル影システムのような影がつく機能があるわけではないことを明示してください。（文例：本サンプル画像は『リアル影システム』を使用して撮影されており、影の付き方が商品単体とは異なる可能性があります。）

2. VRChat内・XなどのSNS・Boothの商品ページなどに含まれる宣伝用の画像・動画が主な対象範囲です。イベントのポスターなど商品範囲を混同する恐れのない内容の場合、対象にはなりません。

3. ポスターなどの場合掲示範囲に制約があると考えられるため、簡素な表現（例：「『リアル影システム』を使用して撮影」）でも可とします。

4. 本ガイドラインは「お願い」であり、ガイドラインに準拠できない場合に『リアル影システム』の利用を禁止するものではありません。諸都合で準拠できない場合があると思いますのでベストエフォートでご対応頂ければと思います。

[English] Overview

This avatar gimmick casts high-resolution shadows in real time with a relatively low load.

Shadows are cast on various parts of the avatar, such as the forelock, chin, and chest, giving the avatar an overwhelming sense of three-dimensionality and presence.

The system is set up to suppress the influence of world lights and mainly illuminate the lights that follow the avatar, so it does not depend on world lights and therefore does not go completely dark in certain worlds.

[English] Feature Details

PCSS (Percentage Closer Soft Shadows), a mechanism that changes the softness of shadows according to distance, has been customized for use with VRChat.

This allows high-resolution shadows to be cast in real-time with relatively low load, and shadows on various parts of the body, such as the forelocks, chin, and chest, can express an overwhelming sense of three-dimensionality and presence.

As an implementation of PCSS, shaders created with reference to the following OSS.

https://github.com/TheMasonX/UnityPCSS

- Build a custom shader from lilToon for PCSS into your avatar.

- The above shader is set to be less affected by the world lights and more dominated by the spotlight set up on the avatar.

- As mentioned above, the setup tool incorporates a spotlight into the avatar.

- The spotlight is aimed to focus on the Head.

- The direction of the spotlight can be controlled with PhysBone.

- The intensity of the light can be controlled from the ExpressionMenu.

- The softness and density of the shadows, the influence of the world light can be adjusted, and masks can be set in the "Custom Properties" of the material.

- Some avatars have shadows on the whites of their eyes, but by using the mask function, you can mask the areas where you do not want shadows cast.

[English] Prerequisites

- Unity2022.3.22f1

- VRChatSDK Avatar 3.8.0 or later

- lilToon v2.0.0 or later

- PoiyomiProv10.0.15 or later

- PoiyomiToon v9.3.64 or later

- Not applicable for Quest avatars.

[English] Setup steps

0. If you use old version, Remove "Assets/nHaruka/PCSS4VRC" folder.

1. Import lilToon v2.0.0+ or Poiyomi Pro/Toon v9.3.38+

2. Import this package.

3. Press the menu bar "nHaruka" -> "PCSS For VRC".

4. D&D your avatar in the "Avatar" field of the window that appears.

6. Confirm the setup guide and press "Setup" button.

[English] About Performance

Although I have implemented every possible optimization measure I could think of for this system, a certain degree of performance load increase is inevitable. However, I consider this to be within an acceptable range for normal gameplay (*this is my personal opinion based on my own testing environment).

In all testing conducted so far, I have not observed any situations where this system alone causes a severe drop in performance.

In the VRChat community, there is a prevailing assumption that "real-time lights = unconditionally heavy (something to be avoided)." While it is true that this feature can easily become resource-intensive depending on its settings, it is by no means inherently bad. When tuned appropriately for the specific use case and environment, it is a useful technology that enables rich visual expression while keeping the performance load under control.

I sometimes receive feedback that "the Real Shadow System is heavy." I suspect this is because the system's effects are visually obvious, making it an easy target to blame when combined with other high-load elements (such as an avatar configuration that is already resource-intensive to begin with).

Specifically, the factors contributing to the load increase caused by this system are the following three points:

1. Generation of ShadowMap and Addition of ShadowCaster Pass

Adding a light to an avatar triggers the process of generating depth data (ShadowMap) necessary for shadow calculation. Because a ShadowCaster pass is executed for each material that casts a shadow, this results in an increase in SetPass Calls (primarily a CPU load).

2. Addition of ForwardAdd Pass

A ForwardAdd pass is added to overlay (additively blend) the "light" of the added light onto each material of the avatar. Since this pass is also executed for each affected material, it further increases SetPass Calls (primarily a CPU load).

3. The Load of the Shadow Calculation Itself

This is the process of calculating how light hits and how shadows fall by referencing the ShadowMap generated in step 1. This is primarily a GPU-side load.

Among these, the load from "1" and "2" increases in proportion to the number of materials on the avatar.

Due to VRChat's specifications, an increase in SetPass Calls tends to become a performance bottleneck. Therefore, if this system is applied to an avatar with a massive number of material slots in an environment with lower PC specs (especially the CPU), it can become a cause of performance degradation.

Conversely, if the avatar does not have an excessively large number of materials and falls within the range of a typical customized avatar (while this falls under "Very Poor" in the official performance ranking, a practical guideline is around 32 to 64 slots), the load from real-time lights is highly controllable, and I believe this system is unlikely to cause any fatal performance issues.

[English] Bug Reporting and Support

Bug reports and support requests are centralized on the following Discord.

If you have any problems, please contact us at

https://discord.gg/zuaYSC5FHg

Support Guidelines (excerpt)

- Support requests may not be answered if the problem is a complex combination of other gimmicks, a bug in Unity, or other issues beyond the author's knowledge.

- Requests with unclear content may be difficult to respond to.

[English] Terms of Use

Secondary distribution of the unitypackage itself, the assets included in it, or the source code, in whole or in part, is prohibited.

You may publish avatars that incorporate PCSS For VRC using this tool ( * Poiyomi Pro version is NOT allowed.), but you may not redistribute them in a form that makes it possible to extract assets such as the unitypackage.

The shadow shader is based on the code of the following open source project.

https://github.com/TheMasonX/UnityPCSS