Avatar Pose Library (APL)

AvatarPoseLibrary (APL) は、Unity 上で VRChat 向けのアバター用のポーズを管理・適用するためのツールです。アバターのポーズを効率的に制御し、VRChat アバターの制作やカスタマイズを支援します。

✨ 特徴

  • パラメーター数を最小限に最適化
    複数のメニューを統合し、制御する Int パラメーターを最小限にします。

  • サムネイル撮影機能
    アニメーションごとに自動でサムネイルを撮影し、メニュー画像を差し替え可能。

  • トラッキング抑制
    アニメーションごとに異なるトラッキング設定が可能。指だけを動かしたり、操作を完全に無効化することもできます。

  • コンポーネントで設定完了
    設定はコンポーネントベース。プレハブ化可能で再利用性も高いです。

  • より人間らしい動きに
    動きのないポーズを、自動で動画撮影に最適化された自然な動きに変換します。

  • 許諾なしで再配布OK
    アニメーションやポーズデータの配布に、商用・非商用問わず許諾なしで使うことができます。

📦 導入方法

APL は 2つの方法で導入することができます。 VCC (VRChat Creator Companion) 経由の導入がおすすめです。

1. VCC 経由での導入

  1. VCC を開き、Settings に移動
  2. Packages タブをクリック
  3. Add Repository をクリック
  4. 入力欄に以下の URL を貼り付け 
    https://HhotateA.github.io/AvatarPoseLibrary/index.json
  5. Add をクリック
  6. リポジトリ情報を確認し、I Understand をクリック
  7. 任意のプロジェクトの Manage Project から APL を追加

2. UnityPackage 経由での導入

  1. あらかじめ以下の依存パッケージをプロジェクトに追加しておく 
    "com.vrchat.avatars": "3.8.0",
"nadena.dev.ndmf": "1.7.9",
"nadena.dev.modular-avatar": "1.12.5"
  2. 下記 URL から UnityPackage を取得 
    https://github.com/HhotateA/AvatarPoseLibrary/releases/latest/
  3. 任意の Unity プロジェクトを開き、UnityPackage をドラッグ＆ドロップ
  4. 追加ファイルを確認し、Import をクリック

🤝 PRの作成方法

  1. フォークの作成

リポジトリ右上の「Fork」ボタンをクリックし、自分のアカウントにコピーします。

  1. ブランチを作成

フォークしたリポジトリをクローンし、新しいブランチを切ります。

git checkout -b feature/your-feature-name

  1. 変更を加える

必要な修正や追加を行い、コミットメッセージは明確に書きます。

git add .
の後、

git commit -m "Add: 追加したアセットの概要"  
git commit -m "Feature: 追加した機能の概要"  
git commit -m "Fix: 修正したバグの概要"

のように、カンタンに変更内容を記述してください。

  1. プッシュ

作成したブランチをリモートにプッシュします。

git push origin feature/your-feature-name

  1. プルリクエストを作成

オリジナルリポジトリのページに移動し、「Compare & pull request」をクリック。

  • タイトルと詳細な説明を入力

  • 関連 Issue があればリンクを貼る

  1. レビューとマージ

メンテナーがレビューを行い、問題なければマージされます。

フィードバックがあれば、追加コミットで修正してください。

※ バージョンコードの更新は行わないでください。

  • メジャーバージョン：互換性のない変更・機能追加
  • マイナーバージョン：互換性のある変更・機能追加
  • パッチバージョン：軽微なバグ修正

💰 開発支援のお願い

APLは、完全無料・無償利用OKのツールとして公開されています。 商用・非商用問わず再配布も可能で、アニメーション販売やアバター改変で自由にご活用いただけます。

もしAPLを利用したコンテンツ（アバター、衣装、ポーズ集など）で一定以上の収益や反響があった場合は、 開発者の活動継続のために投げ銭・宣伝などでご支援いただけると嬉しいです！

Donation => https://hhotatea.booth.pm/items/6902222

皆さんの支援が、APLのさらなるアップデートや新機能開発につながります。

📄 ライセンス

このプロジェクトは MIT ライセンス の下で提供されます。

  • 商用・非商用問わず利用することが可能です。
  • 再配布する場合も、許諾は必要ありません。

バグ報告・機能提案・プルリクエストは歓迎です！
GitHub の Issues や PR を通じてご参加ください。

ライセンスファイルは、 LICENCE を参照してください。

👯 共同製作メンバー

📞 連絡先

質問は、以下の連絡先にお願いします。

2025-05-15 v1.0.0

パッケージ名

com.hhotatea.avatar-pose-library

ドキュメント

未設定

リポジトリ

バージョン

1.2.23

Unityバージョン

2022.3 以降

依存関係

なし

VPM依存関係

旧パッケージ

なし

ライセンス

未設定

作者

HhotateA

リポジトリ内のパッケージJSON

{
  "name": "com.hhotatea.avatar-pose-library",
  "displayName": "AvatarPoseLibrary",
  "version": "1.2.23",
  "unity": "2022.3",
  "description": "VRChatのエモートアニメーションを自動設定するツール群。",
  "gitDependencies": {},
  "vpmDependencies": {
    "com.vrchat.avatars": ">=3.7.0",
    "nadena.dev.ndmf": ">=1.5.0",
    "nadena.dev.modular-avatar": ">=1.10.0"
  },
  "author": {
    "name": "HhotateA",
    "url": "https://hhotatea.com/"
  },
  "zipSHA256": "91907c7f4287030f618059f4060db9780dd3cb5692454aa71f75b74f631499d9",
  "url": "https://github.com/HhotateA/AvatarPoseLibrary/releases/download/1.2.23/com.hhotatea.avatar-pose-library-1.2.23.zip"
}