Kuraberu
くらべるunitypackage を入れる前に、今のプロジェクトとくらべる
衣装やギミックの新しい版を入れ直したら、自分で直したマテリアルが元に戻っていた。入れたら、VCC で入れたシェーダーとぶつかった。Kuraberu は、unitypackage を Unity に入れる前に、今のプロジェクトとファイルを 1 つずつくらべて、変わる物・ぶつかる物を日本語で先に出す Windows 用のツールです。読むだけで、unitypackage もプロジェクトも書き換えません。入れるのは今までどおり Unity で行います。
Windows 11(64 ビット) Unity のプロジェクトのフォルダー(Unity と VCC は起動していなくてかまいません) Microsoft Edge WebView2(Windows 11 には最初から入っています)
入れると、Toon Shader が古い版(1.4.0)に戻ります
今のプロジェクトは 1.9.2
主な機能
-
Unity を開かずに読む
unitypackage を、Unity を開かずに読みます。BOOTH からダウンロードした ZIP のままでも、中の unitypackage を読みます(ZIP は展開しません)。
-
プロジェクトは一覧から選ぶ
くらべるプロジェクトは、VCC(VRChat Creator Companion)に登録されたプロジェクトの一覧から押して選べます。ほかのフォルダーも選べます。
-
1 つずつくらべて、種類に分ける
入れる物のファイルを 1 つずつ、プロジェクトの物と「部品の番号(GUID)・場所・中身」でくらべます。VCC のパッケージと同じ部品、中身が変わる物、別のフォルダーにある同じ部品、名前の違う同じ部品、同じ名前の別の物、新しく入る物・もう入っている物に分けて出します。
-
入れると Unity がどうするか
種類ごとに、入れると Unity がどうするかも出します(作者のパソコンの Unity 2022.3.22f1 で、作り物の unitypackage をコマンドで入れて確かめた動きです)。くわしくは、下の「対応環境」の「入れたときの動き」にあります。
-
古い版を知らせる
入れる物の中に package.json(部品の名前と版)があり、同じ名前のパッケージがプロジェクトに入っていれば、版をくらべて「古い版」を知らせます。
-
フォルダーごとの数と、記録
入る場所(フォルダー)ごとに、気をつける物の数をまとめます。種類を押すと、ファイルの場所の一覧が開きます。くらべた答えを 20 件まで残します(時刻・ファイル名・プロジェクトのフォルダー名・答えの一言だけ)。
使いかた
- ZIP を展開して、Kuraberu フォルダーを好きな場所に置く
- 「Kuraberu.exe」を起動する
- 入れたい unitypackage(か BOOTH の ZIP)を窓に落とすか、「unitypackage を選ぶ」を押して選ぶ
- 入れ先のプロジェクトを押す(次からは覚えています)
- 「くらべた答え」と「確かめてほしい物」を見てから、Unity で入れるかを決める
はじめてくらべるプロジェクトは、部品の番号を読むのに時間がかかることがあります(作者のパソコンでは、.meta が 2 万 9 千個のプロジェクトで約 1 分)。2 回目からは、変わったファイルだけを読み直します(約 2 秒)。
くらべて心配な物があったら、入れる前に控えを取っておくと安心です。プロジェクト全体の控えを取って、全部戻せる「Hikae」もあります。
対応環境
- 対応 OS
- Windows 11(64 ビット)。Windows 10 は確かめていません
- 必要なもの
- Unity のプロジェクトのフォルダー(Assets と ProjectSettings があるフォルダー)と、Microsoft Edge WebView2(Windows 11 には最初から入っています)。Unity と VCC は起動していなくてかまいません
- 入れたときの動き
- 作者のパソコンの Unity 2022.3.22f1 で、作り物の unitypackage をコマンド〔-importPackage〕で入れて確かめた動きです。VCC のパッケージと同じ部品は、Packages の中のパッケージのファイルが、入れる物の中身で上書きされました(package.json も上書きされ、パッケージの版が古くなりました)。中身が変わる物は、今の中身が、入れる物の中身に置き換わりました。別のフォルダーにある同じ部品は、今あるフォルダーの物が、入れる物の中身で上書きされました(入れる物の場所には入りませんでした)。名前の違う同じ部品は、今ある物は残り、入れる物は別の部品番号で増えました(同じ物が 2 つ)。同じ名前の別の物は、今のファイルが入れる物の中身に置き換わり、部品の番号も変わりました
- 読むもの
- 選んだ unitypackage(か ZIP)と、選んだプロジェクトの Assets・Packages の .meta ファイルと package.json、比べるファイルの中身。VCC の設定(プロジェクトの一覧)
- 書き換えるもの
- ありません(unitypackage・プロジェクト・VCC の設定のどれも)
- 保存するもの
- Kuraberu の設定とくらべた答えの記録(20 件)、読む時間を短くするための控え(プロジェクトごとの .meta の場所と番号)。どれも %LOCALAPPDATA%\Kuraberu の中です
- 通信
- 起動したとき、Kuraberu.exe(起動役)がインターネットに接続して、新しい版があるかを確かめます(設定や記録は送りません)。本体のプログラムには、これと下の「エラーの報告」のほかに、インターネットに接続する処理はありません(ソースで確かめました)
- エラーの報告
- はじめて開いたときに「うまく動かなかったときに、作者に知らせますか」と聞きます。「知らせる」を選んだときだけ、エラーの種類・起きた所・内容(名前や場所を消したもの)・ツールの版・Windows の版・時刻を作者のサーバー(noattilabo.com)に送ります。unitypackage・プロジェクト・くらべた答えは送りません。「設定」でいつでも変えられます
- 画面の部品の通信
- 画面の表示に使う Microsoft Edge WebView2(Microsoft の部品)は、起動したときに Microsoft の診断データの受け口(events.data.microsoft.com)へ接続します(作者のパソコンで、同じ作りのツールで確かめました)。WebView2 は本体の中でも動くので、本体の接続として見えることがあります。Kuraberu はこの接続に何も渡しません
- 更新
- 起動時に新しい版を確かめ、新しい版があるときだけお知らせします。「更新する」を押したときだけ入れ替わります(BOOTH からダウンロードした新しい版の ZIP を使います)。設定とくらべた記録は引き継がれます
できないこと
- Kuraberu は、入れたあとに Unity の中で起きること(部品の番号で使っていた物のつながり・スクリプトのエラー・見た目の崩れなど)までは調べません
- 読むだけのツールです。入れるのは、今までどおり Unity で行います
- 確かめたのは、作者のパソコン 1 台(Windows 11)です。BOOTH などから手元にダウンロードしてあった unitypackage 61 個(ZIP の中の物を含む)が、どれも読めることを確かめました
- 同じパソコンの VCC のプロジェクト(.meta が 2 万 9 千個)とその 61 個をくらべ、14 個に「確かめてほしい物」が出ました(中身が変わる物 23・別のフォルダーにある同じ部品 111・名前の違う同じ部品 4・VCC のパッケージと同じ部品 1)。古い版の package.json が入った物は、この中にはありませんでした
- 作り物のプロジェクトと unitypackage で、6 つの種類の分け方と版のくらべ方を、自動の試験で確かめています。くらべても、プロジェクトのファイルが増えも変わりもしないことも、試験で確かめています
- 入れると Unity がどうするかは、作者のパソコンの Unity 2022.3.22f1 で、使い捨てのプロジェクトに作り物の unitypackage を入れ、前と後のファイルと部品の番号をくらべて確かめました
- 確かめていないこと:ほかのパソコン、Windows 10、Unity 2022.3.22f1 以外の版のプロジェクト、Unity の画面の Import の窓から入れたときの動き、Packages の場所のまま入っている unitypackage を入れたときの動き、「unitypackage を選ぶ」で開くファイルを選ぶ窓、作者のパソコン以外の大きさ・速さのプロジェクト
- Kuraberu は VRChat・Unity の公式のツールではなく、VRChat Inc.、Unity Technologies、Microsoft とは関係ありません
- 電子署名がないため、はじめて起動するときに「Windows によって PC が保護されました」と出ることがあります(「詳細情報」を押してから「実行」で起動できます)
レビュー
更新履歴
- 公開しました
ライセンスとクレジット
- 個人利用
- できます
- 商用利用
- できます
- 改変・再配布・再販売
- できません
- 同梱している部品
- 画面に pywebview(BSD-3-Clause)などを使っています。部品の一覧とライセンス文書は、ZIP の中の licenses フォルダーにあります
- お問い合わせ
- X @noatti_vrc か BOOTH のメッセージ