Kuraberu

くらべる

unitypackage を入れる前に、今のプロジェクトとくらべる

衣装やギミックの新しい版を入れ直したら、自分で直したマテリアルが元に戻っていた。入れたら、VCC で入れたシェーダーとぶつかった。Kuraberu は、unitypackage を Unity に入れる前に、今のプロジェクトとファイルを 1 つずつくらべて、変わる物・ぶつかる物を日本語で先に出す Windows 用のツールです。読むだけで、unitypackage もプロジェクトも書き換えません。入れるのは今までどおり Unity で行います。

通常版 ¥300
支援版 (中身は同じ) ¥500
応援版 (中身は同じ) ¥1,500
BOOTH で買う

Windows 11(64 ビット) Unity のプロジェクトのフォルダー(Unity と VCC は起動していなくてかまいません) Microsoft Edge WebView2(Windows 11 には最初から入っています)

主な機能

  • 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 件まで残します(時刻・ファイル名・プロジェクトのフォルダー名・答えの一言だけ)。

使いかた

  1. ZIP を展開して、Kuraberu フォルダーを好きな場所に置く
  2. 「Kuraberu.exe」を起動する
  3. 入れたい unitypackage(か BOOTH の ZIP)を窓に落とすか、「unitypackage を選ぶ」を押して選ぶ
  4. 入れ先のプロジェクトを押す(次からは覚えています)
  5. 「くらべた答え」と「確かめてほしい物」を見てから、Unity で入れるかを決める

はじめてくらべるプロジェクトは、部品の番号を読むのに時間がかかることがあります(作者のパソコンでは、.meta が 2 万 9 千個のプロジェクトで約 1 分)。2 回目からは、変わったファイルだけを読み直します(約 2 秒)。

くらべて心配な物があったら、入れる前に控えを取っておくと安心です。プロジェクト全体の控えを取って、全部戻せる「Hikae」もあります。

Kuraberu の使い方の画像。入れる前に、1 回くらべるだけ。1 落とす(unitypackage か BOOTH の ZIP)、2 プロジェクトを押す(VCC の一覧から選べます)、3 答えを読む(入れるのは今までどおり Unity で)。使える環境は、Windows 11(64 ビット。Windows 10 は確かめていません)、Unity のプロジェクトのフォルダー(Unity と VCC は起動していなくてよい)、Microsoft Edge WebView2(Windows 11 には最初から入っています)。読むものと通信は、unitypackage とプロジェクトを読むだけ(どちらも書き換えません)、本体が送るのはエラー報告だけ(同意したときだけ。画面の部品 WebView2 は Microsoft へ接続します)、くらべた答えは、このパソコンの中だけ(20 件まで。ファイルの一覧は残しません)。下に、アプリの画面の例。入れる物は Hair_Ponytail.unitypackage、今のプロジェクトは MyAvatar で、くらべた答えは「今ある物とぶつかりません」(新しく 7 個のファイルが入ります)

対応環境

対応 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 が保護されました」と出ることがあります(「詳細情報」を押してから「実行」で起動できます)

更新履歴

  1. 公開しました

ライセンスとクレジット

個人利用
できます
商用利用
できます
改変・再配布・再販売
できません
同梱している部品
画面に pywebview(BSD-3-Clause)などを使っています。部品の一覧とライセンス文書は、ZIP の中の licenses フォルダーにあります
お問い合わせ
X @noatti_vrc か BOOTH のメッセージ

こんなツールが欲しい、を送る

困っていることを、ひとことでも。良いアイデアは作って、サイトと X でお知らせします。

どの分野ですかえらばなくてもかまいません

名前やメールは聞きません。送った人を見分けるものは残しません。いただいた声は、作者が読んで、次に作るツールの参考にします。