VRCQuickImporter

BOOTHで購入した素材をUnity Editor内から検索・ダウンロード・インポートできるVRChat向けツールです。

本ツールはBOOTH（pixiv株式会社）の非公式ツールです。 公式の提供物ではなく、利用は自己責任です。 BOOTHの利用規約・ガイドラインを尊重し、常識的な範囲でご利用ください。

導入方法

動作要件

Windows
Unity 2022.3以降（推奨: 2022.3.22f1）
WebView2 Evergreen Runtime
.NET 8 Desktop Runtime

1. VPMリポジトリを追加

VCCまたはALCOMの「Add Repository」に以下URLを追加します。

https://github.com/hellcat-M18/vrc-quick-importer

2. プロジェクトに追加

VCC/ALCOMのパッケージ一覧から「VRCQuickImporter」をONにします。

または、リポジトリをcloneしてPackages/以下に展開し、Package Managerでローカルpackageとして追加することもできます。

3. 初回セットアップ

Unityメニュー Tools > VRCQuickImporter > 開く でウィンドウを開きます。
「BOOTHにログイン」を押し、WebView2で開いたBOOTH公式画面からログインします。
- 本ツールはBOOTHのパスワードを保存・送信しません。認証はBOOTH公式ページ上で行われます。
「BOOTHと同期」を押すと、初回の確認ダイアログが表示されます。同意するとライブラリ全ページの取得を開始します。
同期完了後、カードグリッドに購入済み商品が表示されます。

以降はBOOTHへの再ログイン不要です。セッション情報はプロジェクト内の専用プロファイルに保存されます。

通常の使い方

商品を探す

カード一覧からスクロールして探すか、画面上部の検索欄に商品名の一部を入力して絞り込みます。検索はローカルキャッシュに対して行われ、BOOTHへのアクセスは発生しません。

ダウンロード

商品カードのダウンロードボタンを押すと、helperプロセス経由でファイルをdownloads/に保存します。進捗バーが表示されます。

インポート

ダウンロード完了後、インポートボタンを押してUnityに取り込みます。

.unitypackageが1つだけ → 自動インポート
.unitypackageが複数 → どのファイルをインポートするか確認
.unitypackageなし → Assets/BOOTH/{zip名}/ に展開

増分同期

「BOOTHと同期」を押すと、前回の同期以降の新しいページを追加取得します。新しいページが空になった時点で自動停止します。

オプション機能

通常の利用では使わない機能です。詳細設定/トラブルシュートセクションにまとめられています。

同期キャンセル

同期中に「キャンセル」ボタンを押すと、取得途中のhelperプロセスを終了します。既存のキャッシュデータは保護されます。

完全リフレッシュ

キャッシュを一旦破棄し、BOOTHライブラリを全件再取得します。詳細設定内の「同期のメンテナンス」から実行できます。

データ削除/リセット

以下を個別に削除できます。

WebView2ログイン情報/プロファイル
ライブラリキャッシュ（database.json）
サムネイルキャッシュ
ダウンロード済みファイル
展開済みファイル
ログファイル

Library/VRCQuickImporter/ 全体を削除しても再生成されますが、WebView2プロファイルも消えるため再ログインが必要になります。

ログイン再認証

セッションが切れた場合や、別のBOOTHアカウントに切り替える場合は、詳細設定からWebView2プロファイルを削除して再ログインします。

技術詳細

アーキテクチャ

本ツールはUnity Editor拡張と、別プロセスのWebView2 helperで構成されています。

WebView2をUnityプロセス内に組み込むと、描画スレッドの干渉によりUnity本体がクラッシュするリスクがあります。このため、helper exeとして独立させ、Unity EditorからはJSONファイル経由で通信する設計としています。

Unity Editor (UI / Import / DB管理)
    ↓ JSON経由
WebView2 Helper (BOOTHログイン / ライブラリ同期 / ダウンロード)
    ↓ HTTP/HTML
BOOTH

BOOTHアクセスの設計

ライブラリページのHTMLをDOM解析し、商品名・ショップ名・ファイル名・ダウンロードURL等を抽出します。

アクセス制御:

BOOTHライブラリページへのアクセスは最低5秒の間隔を空けます
並列アクセスは行いません
同期時は画像・メディア・フォントリソースをブロックし（204 No Content）、BOOTHサーバへの負荷を抑えます。JavaScript/CSSはブロックしません
増分同期では、新しいページが空になった時点で自動停止します
完全リフレッシュはユーザーが明示的に実行したときのみ行われます

セッション管理

BOOTHのログインは、本ツール専用のWebView2プロファイル上で行われます。

Chrome/Edgeなど既存ブラウザのCookieやログインセッションは流用しません
BOOTHのパスワードを本ツールが読み取ることはなく、認証はBOOTH公式ページ上で完結します
セッション情報はプロジェクト内のLibrary/VRCQuickImporter/webview-profile/にのみ保存されます

データ管理

取得したライブラリデータはdatabase.jsonとしてプロジェクト内にキャッシュされます。

書き込み時は.tmpファイル経由で原子的に置き換え、既存ファイルを.bakに退避します
同期キャンセルや失敗時は、取得途中のデータを破棄し既存キャッシュを保護します

データ保存先

実行時データはプロジェクト内のLibrary/VRCQuickImporter/以下に保存されます。

Library/VRCQuickImporter/
  cache/                      各種キャッシュ
  thumbnails/                 サムネイル画像キャッシュ
  downloads/                  ダウンロード済みZIP/ファイル
  extracted/                  展開済みファイル
  logs/                       同期/ダウンロードログ
  webview-profile/            WebView2ログイン用プロファイル
  database.json               同期済みライブラリ
  database.json.bak           database.jsonのバックアップ
  pending-page.json           取得途中の1ページ分（同期完了後に削除）

Library/VRCQuickImporter/ を削除しても再生成されますが、WebView2プロファイルも消えるため再ログインが必要になります。

既知の制限

BOOTHのページ構造やダウンロードURL形式が変更されると、同期やダウンロードが動作しなくなる可能性があります
Windows専用です。macOS/Linuxには対応していません
商品のタグやカテゴリの取得は行っていません（取得には商品詳細ページへの大量アクセスが必要なため）
.unitypackageを含まないZIPの自動展開は、一般的な素材ZIP構造を想定しています。Unityプロジェクト構造を含むZIPは自動展開しません

免責事項

本ツールはBOOTH公式ツールではありません
利用は自己責任です
BOOTH側の仕様変更や判断により、利用が制限される場合があります。その場合は速やかに使用を停止してください
ログインはBOOTH公式ページ上で行われます。本ツールはパスワードを保存・送信しません
セッション情報はプロジェクト内のWebView2専用プロファイルに保存されます。他のブラウザのCookieを読み取りません
取得・保存するのはログインユーザー自身の購入履歴情報のみです。第三者への提供や再配布は行いません