この記事はUnityアドベントカレンダー2021part3の３日目の記事です。記事を書いたのもアップしたのも１２月２６日ですが、アドカレpart3がスカスカなのが寂しいので強引に入れさせてもらいました。
qiita.com
ちなみに、part1の３日目も土屋が書いてますのでこちらもどうぞよろしくです。
someiyoshino.info
ＵＲＰの実装を見ている時、挙動を確認するためにＵＲＰのコードを弄りたくなることがよくあると思いますが*1、それをする為に必要な操作があります。
これ、以前どこかで画像付きの分かりやすい記事を見た記憶があるんですが、どうにも再検索できなかったのでメモとして上げておきます*2。
Package ManagerでＵＲＰ関連パッケージを確認する
Unityの基幹ライブラリの一部はPackageという独立した形式で配布されていて、必要に応じて個別に更新することが出来ます。プロジェクトが使用しているPackageはPackage Managerで確認できます。ＵＲＰテンプレートプロジェクトだと下図のような感じ。「Universal RP」がＵＲＰ実装のPackageになります。
ちなみに、ＳＲＰ自体のコア実装である「Core RP Library」というPackageも別にあります。"Packages: Unity Registry"に切り替えるとこちらも確認できます。
今回はUniversal RPパッケージだけを編集します。
パッケージが配置されるフォルダを確認する
Packageの実体は、プロジェクトの"\Library\PackageCache"フォルダに格納されています。
Universal RPの実装は"\Library\PackageCache\com.unity.render-pipelines.universal"フォルダに格納されます。フォルダ末尾の"@10.7.0"はPackageのバージョンを表していますが、内部的には参照されていないようです（良く知らない）。
ただし、パッケージの配置フォルダを確認する時は、フォルダを直接掘るのではなく、以下の様にProjectビューのPackagesツリー配下にある各パッケージを右クリック→"Show in Explorer"を選択してエクスプローラーを開く事が推奨されています（理由は後述します）。
PackageCacheフォルダからPackagesフォルダにコピーする
さて、このフォルダ配下のコードを書き換えればいいかと思いきや、これは上手く行きません。どうもunityが不定期にPackageCache配下のデータを確認しているようで、コードを書き換えてもどこかのタイミングでrevertされてしまいます*3。
これを回避するためには、"com.unity.render-pipelines.universal"フォルダをプロジェクト直下の"Packages"フォルダ下にコピーします。コピー後のフォルダ名からは末尾のバージョン表記を削除することが推奨されています*4。
この状態でunityをアクティブにすると、Package Manager上でUniversal RPに"Custom"と付記されます。同時に、PackageCacheフォルダ配下からはUniversal RPフォルダは削除されます。
完了！
これで準備は完了です。Packagesフォルダにコピーした実装を更新すれば正しく反映されます。なお、この状態でProjectビュー上で"Universal RP"を右クリックして"Show in Explorer"を選択すると、自動的にPackagesフォルダにリダイレクトされます。Packageは状況によって配置場所や配置方法が異なるため、unityにリダイレクトを任せるこの方法が推奨されています。
宣伝「Unityシェーダープログラミングの教科書シリーズ」
土屋は同人誌「Unityシェーダープログラミングの教科書」シリーズを書いています。現在以下の４冊が出ています。
- Unityシェーダープログラミングの教科書 ShaderLab言語解説編
- Unityシェーダープログラミングの教科書２【反射モデル＆テクスチャマップ編】
- Unityシェーダープログラミングの教科書３ ライティング＆ＧＩ（大域照明）解説編
- Unityシェーダープログラミングの教科書4 SRP[1]UniversalRP/Litシェーダー解説編
これらの同人誌は、現在ＢＯＯＴＨにてＰＤＦ版を有料頒布しています。
染井吉野ゲームズ
s-games.booth.pm
技術書典などの同人誌即売会で紙書籍版も頒布しています。ただし、昨今の情勢を鑑みて、次の紙版の頒布がいつになるかは未定です。すみません。
なお、年明けの技術書典で第５巻の頒布を予定しています（間に合えば）。５巻はＵＲＰポストプロセス処理編になる予定です（間に合えば）。今回の記事は５巻に収録される予定です（間に合えば）。お楽しみに。
参考リンク
今回の記事は、このページの「Unity のパッケージをキャッシュからコピーする」という項をベースにしています。
docs.unity3d.com
