AvatarNPC with EasySetupTools【基本セット】

「AvatarNPCシステム」はVRChatに対応しアバターモデルが自動でノンプレイヤーキャラクターとなってワールド内を動く仕組みです。（現状、PCVRのみの対応です）

この商品には「AvatarNPCシステム本体」と、NPCとしてアバターをセットアップできる「簡単セットアップツール」が同梱されております。

対応するワールドは同梱されていません。ご自身で制作したワールドや、別途購入したワールドなどにAvatarNPCシステムを導入するためのミニマムセットとなっております。（ご自身で設定したワールドをPublic化する場合には、ワールドアセットや個別のアバター規約を違反しないようご注意ください）

・AvatarNPCのデモワールド（モデルルーム）はこちら - Demo World URL

https://vrchat.com/home/launch?worldId=wrld_6f2c13ba-e1e6-408e-9193-21cad8912838

---

English Version：

https://metacreators-en.booth.pm/items/7964783

AvatarNPCシステムとは？

AvatarNPCはアバターをNPCとしてワールド内で歩き回らせたり、触れ合ったり、様々な行動をカスタマイズできるUdonギミック群です。

AvatarNPCでは以下のことができます

・特定の場所に移動してモーションを再生する

・ワールドに入ってきたひとに挨拶をする

・NPCの視界内にプレイヤーをみつけたら見つめてくる、近寄ってくる

・対面している時に特定の場所を触ったら反応する

・NPCの頭を撫でることができる

ワールド内にNPCの行動を決定する「アクション」を組み込むことで、NPC達がいきいきと動き回ってくれます。

導入マニュアル

・ワールドセットアップガイド（任意のワールドにAvatarNPCシステムを導入する方法を解説しています）

https://docs.google.com/document/d/1-8uuVZ8rNAhn6SVB8EKa1HmsJR9EwJh4XrejRHAi0eQ/edit?usp=sharing

・Avatar NPC Systemチュートリアル（お気に入りアバターをNPCとしてセットアップする方法を解説しています）

https://note.com/metacre/n/n50aeab072d6b

・アクションセッティングの実例（任意のアクションを組んでいくための実例とヒント集です）

https://docs.google.com/document/d/1gXtF2YMx35BsRen7lwrzEB3XRXiLRnrjBENoDASMqBg/edit?usp=sharing

・アクション一覧

https://docs.google.com/document/d/1QwVYhVoBWqV-VJKRGlXJVytcrFjvBubval2073DMqnA/edit?usp=sharing

・AvatarNPC内部構造

https://docs.google.com/document/d/138MDh5bKqXRYaylDiIK7nerELosF6_dJGlBn-A2X5io/edit?usp=sharing

・NPC用AnimatorControllerの概要

https://docs.google.com/document/d/1akke_RN6qT_G7Dl-KDNM3-v82uLbscASP-s6AaUktpw/edit?usp=sharing

更新履歴

AvatarNPCシステム アップデートログ

https://docs.google.com/document/d/1h5sZEJUjKOUaWt8ojrKjaXZ48qv7ClY4h11y3VmB6ZI/edit?usp=sharing

2026/9/11

## EnvironmentAgent のアクション選択を安定化

- 初回アクションが未指定で、実行可能な環境アクションがまだ存在しない場合、エラーにならず一定時間後に再検索するようにしました。

- 現在のアクション終了後に次の候補が見つからない場合、毎フレームではなく設定可能な間隔で再検索するようにしました。

- 再検索間隔として `Action Selection Retry Interval` を追加しました。初期値は1秒で、0.1秒未満の値は0.1秒として扱います。

- Udon の遅延イベントをキャンセルできないことを考慮し、初回選択と次回選択それぞれに待機状態と予約状態を持たせました。これにより、同じ再検索イベントが重複予約されることを防ぎます。

- 再検索時にもオーナーであることを確認し、オーナー移譲後の古い遅延イベントがアクションを変更しないようにしました。

- トリガーから次のアクションが指定された場合は、待機中の自動選択を解除してトリガーによる遷移を優先するようにしました。

- 利用可能なアクション一覧が `null` の場合だけでなく、空配列の場合も再検索へ移行するようにしました。

- 利用可能なアクションがない間の警告は、待機開始時の一度だけ出力するようにしました。

## LookAtIK の回転合成を改善

- IK適用前のAnimatorによる胸・首・頭の姿勢を保持し、その姿勢へIKの回転差分を加える方式に変更しました。アニメーションの姿勢を維持したまま視線追従を適用できます。

- 胸、首、頭の各ボーンへ影響率を先に適用してから階層的な回転差分を算出するようにしました。親ボーンの未適用分を子ボーンが過剰に補う挙動を防ぎます。

- ボーンごとの影響率と全体の `LookAtBlendRate` を0から1の範囲で適用するようにしました。

- 影響率を適用した後にもInspectorで指定した角度制限を再適用し、補間結果が制限範囲を越えないようにしました。

- スムージング用の参照回転には割合適用前のIK解を保持し、影響率の設定によって次フレームの追従計算が弱まらないようにしました。

- TransformだけでなくQuaternionを直接受け取れる角度制限処理を追加し、回転合成処理から同じ制限ロジックを利用できるようにしました。

- この変更により従来の設定値だとLookAtの可動範囲が狭まる可能性があります。特にLookAtBlendRateの値を小さくするなどで修正が必要になります。

- 新規作成時の `LookAt Blend Rate` の初期値を0.2から0.8へ変更しました。

2025/6/20 - Unityでインポート時にエラ―が発生する問題を修正

2025/02/13 - 別要因で後から入ってきたプレイヤーでNPCが動かなくなる問題を修正

2025/2/12 - 後から入ってきたプレイヤーでNPCが動かなくなる問題を修正

2025/1/17 - リリース

よくある質問 - FAQ

Q：Modular Avatarには対応していないの？

A：Modular Avatarで改変したモデルの場合は、こちらのガイドに従って、Modular Avatarモデルを手動ベイクし、それをプレハブとして保存した後にワールドへインポートする形で導入できると思います。参考にお試しいただけますと幸いです。

https://modular-avatar.nadena.dev/ja/docs/manual-processing

Q:AvatarNPCシステムを自作のワールドに導入してもいいの？

A:AvatarNPCシステムはNavmeshなどの設定をすることにより、自作ワールドでもご使用いただけます。ただし、AvatarNPCシステムが入ったワールドを販売することは再販に当たり規約で禁じられておりますのでご注意ください。

Q：アップロードが上手くいかない

A：マニュアルを読んで、手順通りに操作して下さい。

よくある間違いとして、シーンファイルをダブルクリックではなくドラッグ・アンド・ドロップしてしまっている問題があります。

必ずダブルクリックで開いて下さい。

Q：データが壊れている

A：Boothからダウンロードする際に稀にデータが欠損することがあるようです。再度ダウンロードしてみてください。

それとは別にうまく行かない場合はご連絡ください。

Q：メニューに文字化けがある。コンパイルエラーが出る。

A：文字コード環境により一部文字化けとエラーが出る可能性があります。原因特定と修正対応中ですが、お急ぎの場合下記の変換ツールで改善する場合があります。

https://github.com/catsnipe/EncodeUtf8

注意事項 - disclaimer

※このシステムはVRChatのPCVR専用となっております。

※ワールドは同梱されていません。ご自身でお好みのワールドをご用意ください。

※将来のVRChatアップデートなどによる動作保証はありません。予めご了承下さい。

上記納得の上、ご購入をお願いいたします。

お困りの点で対応可能なものは対応いたします。

下記discordサーバよりお問い合わせください。

https://discord.gg/bmw3PWE37M

利用規約 - Terms of Use

本データの利用を購入者に対して許諾します。

（ただし、オリジナルの著作者を偽る行為を禁じます。）

A. 個人による利用

非営利および非営利有償目的での利用を許可します

B. 法人による利用

非営利目的に限り許可します

・再配布

改変・未改変を問わず許可しません

・性的表現への利用

許可しません(ただし私的使用(プライベートな範囲での利用)については禁止しません)

・暴力的表現への利用

許可しません(ただし私的使用(プライベートな範囲での利用)については禁止しません)

・政治活動への利用および、宗教活動への利用

許可しません

・権利義務の譲渡等

許可しません

・本データの利用、または利用できなかったことにより生じた損害について、権利者は一切の責任を負いません。

詳しくはこちらのフォルダの利用規約をご確認ください。

https://drive.google.com/drive/folders/1oZYSsfEUSmB6bC2p5Moecerd1vz3FcWb?usp=sharing

クレジット - Credit

* AvatarNPCシステム開発 : 黒鳥（メタバースクリエイターズmetaverse creators）

https://kurotori.booth.pm/

* ロゴ・PV制作：おむらいす食堂 | omu（メタバースクリエイターズmetaverse creators）

https://omu-rice.booth.pm/

* NPCモーションアクト：神楽 もい

https://kaguramoimoi.booth.pm/