Repository navigation
Releases
Avatar Fork 0.2.1：複製時間の短縮
複製時の待ち時間を短縮しました。素材を多く含むアバターで繰り返していた文字列検索と、画像などの不要な再読み込みを減らしています。
Windows・Unity 2022.3.22f1で、素材1,330件を含む同じアバターを比較したところ、複製処理は約4分33秒から約1分43秒になりました。今回の測定では約62％の短縮です。各1回の測定結果で、短縮幅はプロジェクトやPCによって変わります。
元の未保存の編集を守る処理、素材参照の分離、複製先のBlueprint IDのクリア、複製後の検査は維持しています。画像の画質・圧縮設定も変更していません。
配布ファイルからの新規導入と0.2.0のunitypackageからの更新を確認し、日本語・英語の全11スイートの回帰試験が通過しました。モデルの材質が複製完了直後から正しく割り当てられることも確認しています。
ALCOM / VCCではAvatar Forkを0.2.1へ更新してください。unitypackageを利用している場合は、更新・削除の手順に沿って、下記の AvatarFork-0.2.1.unitypackage へツール本体を入れ替えてください。
検証環境・測定条件の詳細は検証記録にまとめています。
Avatar Fork 0.2.0
共有スクリプトのアイコンや既定の素材があるアバターで、複製が失敗する問題を修正した正式版です。
修正内容
- TightsTailorなどのスクリプトに設定されたアイコン・既定の画像・マテリアルを、アバター素材の複製漏れと誤判定しないようにしました。
- Packages内の素材からだけ参照されるAssets内の画像も、共通で使う範囲に含めます。
- 同じ画像をアバター自身が参照する場合はコピーします。直接参照や入れ子素材の分離漏れを検出する動作は維持しています。
確認
Windows・Unity 2022.3.22f1・VRChat SDK 3.10.5で、日英それぞれ全11スイートが成功しました。追加の共有依存18条件は独立したレビュー担当者のUnity実行でも成功しています。
実際に失敗していた制作プロジェクトでも、修正後に素材1,330点の複製と再検査が完了しました。元のScene設定と未保存の素材は維持しています。
更新
ALCOM / VCCでAvatar Forkを0.2.0へ更新してください。unitypackage版を使う場合は、添付のAvatarFork-0.2.0.unitypackageを取り込みます。導入方式は併用しないでください。
以前失敗した出力は完成品として使わず、更新後に新しく複製してください。既存の失敗フォルダーへ上書きする更新ではありません。
導入と更新の詳細はREADMEを参照してください。
Avatar Fork 0.1.1
コピー外の素材を参照していると、名前変更が止まる問題を修正しました。
- 外部の画像・マテリアル・設定のパスを保ったまま、コピーの名前を変更できます。外部の素材は移動・改名・複製しません。
- 外部のShader includeがさらに別のファイルを読み込む構成にも対応します。
- 参照切れ、未保存変更、GUIDの不整合による停止と、複製時の素材を分離する検査は維持しています。
- unitypackage版の更新をUnityが検知し、修正版へ再コンパイルできるように、配布ファイルの時刻も修正しました。
購入素材を使わない日英の回帰試験に加え、実アバターの保存済みPrefabと衣装を改変したSceneの検証コピーで、改名とUnity再起動後の参照・表示を確認しています。
対応・検証環境はWindows・Unity 2022.3.22f1・VRChat SDK 3.10.5です。Mac・Linux、他のUnity版、すべてのアバターやギミックの動作は未確認です。制作プロジェクト全体をバックアップしてから更新してください。
ALCOM / VCCではVPMリポジトリから更新してください。直接導入する場合は添付のunitypackageを使い、両方式を同時に入れないでください。
Avatar Fork 0.1.0
Avatar Forkの最初の正式版です。対応・検証環境はWindows・Unity 2022.3.22f1・VRChat SDK 3.10.5です。
- ネストしたShader includeのコピー漏れと、誤った完了判定を修正しました。相対・絶対・角括弧形式と改名後の参照を確認しています。
- 改名が一時フォルダーで中断した場合も、保存先の再使用を止めて復元手順へ案内します。
- 未ロードの外部Sceneが並んでいる状態でも、コピーのSceneを改名できます。
- beta.6で追加した個体識別・配置例外・Play Modeの保護を引き継ぎます。
ZIP版は日英各842確認、unitypackage版は各841確認が成功しました。表示文言・保存先の498確認を含むため、独立した利用場面の数ではありません。通常コンパイル、改名失敗時の復元、強制終了4地点からの手動復元も確認しています。
解析対象のShaderテキストはUTF-8を使ってください。未解釈のincludeはコメント内も含めて拒否します。Mac・Linux、他のUnity版、すべてのアバター・ギミックの動作は未確認です。強制終了時の自動復元はありません。制作プロジェクト全体をバックアップしてから更新してください。
ALCOM / VCC向けはVPMリポジトリから導入してください。直接導入する場合は添付のunitypackageを使い、両方式を同時に入れないでください。
Avatar Fork v0.1.0-beta.6（ベータ版）
配置済みコピーの識別、配置失敗時の復元、Play Mode中の保護を強化するベータ版です。
- 参照が失効した場合は、Scene内の個体識別子とPrefab GUIDの両方が一致するコピーだけを再取得します。不正な候補で元の識別子を上書きしません。
- 配置途中の例外では追加前の追跡状態を復元します。Undoの取り消し自体が失敗しても後始末を続け、失敗個体がRedoで復活することを防ぎます。
- Play Modeへの移行中・実行中・終了中とコンパイル中は、配置・選択・既存個体の再指定を無効にします。終了後はScene Reloadの設定に合わせて元の個体を追跡します。
Windows・Unity 2022.3.22f1・SDK 3.10.5で、配布ZIPとunitypackageをそれぞれ導入し、英語・日本語の全9試験群が成功しました。ZIPは各769項目、unitypackageは各768項目で、差はUPM専用のパス解決1条件です。件数は試験内の確認項目数で、表示文言・保存先の492項目を含みます。独立した769種類の操作を試した意味ではありません。
子・孫とコンポーネントを持つ合成Prefabの例外注入、Scene移動の即時・Editor更新後のUndo/Redo、Play Modeの往復を確認しました。実画面でも英日表示、幅530pxと最小サイズ530×510px、スクロール、誤指定の拒否、既存コピーへの再接続、Play Mode中の無効化を確認しています。
使い捨てプロジェクトで改名の3地点に停止処理を入れ、Unityを強制終了しました。未完了操作の手動復元と完了済み操作の保持を、SHA-256・GUID・参照・Blueprint ID・骨名・重複GUIDで確認しています。外部Sceneの未保存の改名は復元されず、保存時の旧名が残ります。強制終了後の自動復元や起動時通知はありません。復元手順を参照してください。
Mac・Linux、他のUnity版、電源断、実際のInstanceID再利用、コンパイル進行中の直接呼び出しは未確認です。制作プロジェクトへの導入やアバターのアップロードは今回の検証に含めていません。
ALCOM / VCCではプレリリース版を表示して更新してください。直接導入する場合はunitypackageを使い、導入方式を併用しないでください。更新前にUnityを閉じ、制作プロジェクト全体をバックアップしてください。公開済みの旧版と既存の生成ファイルは変更しません。
Avatar Fork v0.1.0-beta.5（ベータ版）
Sceneを保存して開き直した後のコピー識別と、改名後の再操作を修正するベータ版です。
- 別Sceneへ移した個体を追跡し、同じPrefabの別個体を誤って選んだり、元Sceneへ重複追加したりしません。
- 以前追加した個体が見つからない場合は自動追加せず、配置先Sceneの再読込、既存個体の指定、新規追加を選べます。
- 作成画面を開いたまま改名しても、保存先表示と再配置先を更新します。元Sceneの改名・別名保存にも対応します。
- 生成Sceneで親の下や無効な階層に置いた個体、同じPrefabを複数置いた場合も、旧自動名だけを改名します。手動名は維持します。
- コピー外のSceneへの改名反映をUndo・Redoに登録しました。ファイル一式の改名はUndoでは戻りません。
Windows・Unity 2022.3.22f1・SDK 3.10.5で、配布ZIPから読み込んだ状態の8組の合成回帰試験を英語・日本語で実行し、各685項目が成功しました。ZIPとunitypackageの内容一致、独立したGUID、ライセンス、SHA-256も照合しています。
新しい配置案内の実画面表示・クリック操作、Scene間移動そのもののUndoと改名を組み合わせた履歴、生成後の例外注入と強制終了からの復元は未確認です。Mac・Linuxと他のUnity版も未検証です。
ALCOM / VCCではプレリリース版を表示して更新してください。直接導入する場合はunitypackageを使用し、導入方式を併用しないでください。更新前にはUnityを閉じ、制作プロジェクトをバックアップしてください。既存の生成ファイルや制作Sceneは、このリリース公開だけでは変更されません。
Avatar Fork v0.1.0-beta.4（ベータ版）
複製したアバターを、今開いている元SceneのHierarchy末尾へ自動追加するベータ版です。
- 別Sceneを開く手順を外し、追加したコピーを選択します。
- 未保存の編集を保ち、追加のUndo・Redoと、追加だけが失敗した場合の再試行に対応します。
- 同じScene内のコピーを正しく識別し、名前変更と再複製を維持します。
- 親付きアバターの位置・向き・大きさを引き継ぎ、再現できない変形は作成前に停止します。
Windows・Unity 2022.3.22f1・SDK 3.10.5で、購入素材を使わない7組の回帰試験を英語・日本語で実行し、すべて成功しました。配布物の内容・GUID・ライセンス・ハッシュも照合済みです。
ALCOM / VCCではプレリリース版を表示して更新してください。直接導入する場合はunitypackageを使用します。導入方式を併用しないでください。更新前にはUnityを閉じ、制作プロジェクトをバックアップしてください。
Sceneは自動保存しません。Undoで取り消すのはHierarchyへの追加だけで、生成したファイルは残ります。
Avatar Fork v0.1.0-beta.3（ベータ版）
アバターの複製・名前変更の案内と、失敗時の表示を改善したベータ版です。
- 複製元の指定方法を明確にし、候補外のアバターを直接指定したときの表示を修正しました。
- 途中で失敗した出力の場所と次の作成先を区別して表示します。作成前のエラーは、入力を変えると消えます。
- エラーに問題のオブジェクト・コンポーネント・参照先や不足ファイルのパスを表示し、禁止名や記録の問題も理由を示します。
- 共通で使う素材、Shaderの複製範囲、名前変更で保つもの、参照切れの英語・日本語の説明を見直しました。
- コピーの失敗と名前変更の中断から、それぞれの対処・復元手順を直接開けます。
ALCOM / VCCでは既存のVPMリポジトリから更新できます。直接導入する場合はAvatarFork-0.1.0-beta.3.unitypackageを使ってください。二つの導入方式は併用しないでください。
Windows・Unity 2022.3.22f1・VRChat SDK 3.10.5で、英語・日本語の回帰試験を確認しています。Mac・Linux、ほかのUnity版、全アバターや全ギミックの動作は未確認です。制作プロジェクトをバックアップしてから使用してください。
Avatar Fork v0.1.0-beta.2（ベータ版）
変更点
- 基本の保存先を
Assets/複製名に変更しました。まとめたい場合はAssets内の親フォルダーを選べます。 - 複製・名前変更・共有一覧、Hierarchyメニュー、進捗・エラーの英語／日本語切り替えを追加しました。初期表示は英語です。
- 作成先を常時表示し、複製完了後は実際の保存先と完了後の操作を表示します。言語を切り替えても名前・保存先・完了結果を保ちます。
更新する方へ
既存コピーの移動・改名は行いません。英語表示から日本語へは画面上部の Language / 言語 で切り替えられます。制作プロジェクトをバックアップしてから更新してください。
ALCOM／VCCではプレリリース表示を有効にして更新できます。直接導入する場合は .unitypackage を使い、ALCOM／VCC版と併用しないでください。
検証
Windows・Unity 2022.3.22f1・VRChat SDK 3.10.5で、ZIPとunitypackageをそれぞれ専用プロジェクトへ導入し、英語・日本語の両方で複製・改名・参照の分離・Blueprint ID・保存先・言語切り替えの試験を実行しました。購入素材は使っていません。Mac・Linux、全アバター・全ギミックは未検証です。
Avatar Fork v0.1.0-beta.1（ベータ版）
Avatar Fork v0.1.0-beta.1
アバターの現在の改変状態を引き継いで、編集用の素材と参照を分離するUnity Editor拡張です。作ったコピーの名前を一式変更できます。
ベータ版です。今後も改良・変更を続けます。制作プロジェクトをバックアップしてから使ってください。
導入
- ALCOM / VCCでは、VPMリポジトリURL
https://raw.githubusercontent.com/ainoobmanpg/avatar-fork/main/vpm/index.jsonを追加し、Avatar Forkを対象プロジェクトへ導入してください。プレリリース版を表示する設定が必要です。 - Unityへ直接導入する場合は、添付の
AvatarFork-0.1.0-beta.1.unitypackageをAssets > Import Package > Custom Package…で読み込んでください。 - 二つの方式を併用しないでください。切り替え・更新・削除・中断時の復元は手順書を参照してください。
確認した範囲
Windows・Unity 2022.3.22f1、VRChat SDK 3.10.5で検証しています。購入素材を使わない新規プロジェクトで、VPM用ZIPは93条件、unitypackageは92条件を確認しました。差の1条件はVPM方式のPackagesパスの解決です。
個別アバター1体のWindows向けPrivateアップロードとDesktopモードでの装着・代表的な表示や姿勢の変化も確認しています。全アバター・全ギミック・他OSを保証するものではありません。VR機器・掴み・着火・接触・発声・他クライアント同期は未確認です。
ツール本体と付属文書はMITライセンスです。制作したアバターや素材に、本ツールのクレジット表示は求めません。素材ごとの利用条件はそれぞれの規約に従ってください。