EXQv

VRChat のワールドに置く QvPen を拡張するパッケージです。QvPen で描いた線をアバターの体に追従させたり（BodyQv）、手で持って動かせるようにしたり（GrabQv）できます。2 つを組み合わせて、体に付けたものを持って付け直すこともできます。

📖 使い方ドキュメント — 設置の手順・線の付き方・できないこと・困ったときの対処

できること

機能概要
BodyQv体の上に描いた線が、その人が動いても体に付いたまま追従します。顔・腕・胴のほか、頭の上に浮かせて描いた猫耳やヘイロー、背中から描き出した翼も体と一緒に動きます。体の表面をなぞって描くこともできます
GrabQv描いた線を、まとまりごとに誰でも手で持って動かせます。まとまりはペンの Split ボタンで区切り、Erase ボタンの長押しでまとまりごと消せます
BodyQv + GrabQv描いたものが体に付いて追従し、持って位置を直せます。離した場所で付け先を決め直します（空中なら浮いたまま、体の近くならその部位に付きます）

どれも専用の Prefab をワールドに置くだけで動きます。描かれる人・持つ人の側には何も要りません。後から入った人にも同期されます。

同じワールドに置いたふつうの QvPen は、何も変わらずに動きます。QvPen 本体のファイルは書き換えません。

動作環境

項目要件
Unity2022.3 (LTS)
VRChat SDKWorlds 3.8.1 以上
QvPen3.3.15 以上 3.4.0 未満

インストール（VPM）

  1. VCC / ALCOM にリポジトリを追加します。
  2. ワールドのプロジェクトの Manage Packages から「EXQv」を追加します。

Packages/EXQv/Prefabs/ の BodyQv / GrabQv / BodyGrabQv をシーンに置けば使えます。BodyQv と BodyGrabQv は、Inspector に出る案内に従って衝突の設定を直してください。詳しくはクイックスタートを参照してください。

VCC を使っていない場合は、リリースページの .unitypackage からも導入できます。

できないこと

  • 髪・尻尾・スカートなどの揺れもの（PhysBone）には付きません。ワールドからは揺れものの骨を読めないためです。
  • アバターの見た目の表面にぴったりは描けません。体の形は骨の位置からおおまかに作っています。
  • 関節をまたいだ線は曲がりません。

ほかの制限はドキュメントにまとめています。

不具合の報告

GitHub Issues へお願いします。

パッケージ名

net.maaaaa.exqv

ドキュメント

https://ghp.maaaaa.net/EXQv/

リポジトリ

バージョン

0.4.0 (変更履歴)

Unityバージョン

2022.3 以降

依存関係

なし

VPM依存関係

旧パッケージ

なし

ライセンス

MIT

作者

Poyotoron

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

{
  "name": "net.maaaaa.exqv",
  "displayName": "EXQv",
  "version": "0.4.0",
  "unity": "2022.3",
  "description": "QvPen で描いた線を、アバターの体に追従させたり（BodyQv）、手で持てるようにしたり（GrabQv）、その 2 つを組み合わせたりするワールド用の拡張です。",
  "vpmDependencies": {
    "com.vrchat.worlds": ">=3.8.1",
    "net.ureishi.qvpen": ">=3.3.15 <3.4.0"
  },
  "changelogUrl": "https://github.com/Poyotoron/EXQv/blob/main/CHANGELOG.md",
  "author": {
    "name": "Poyotoron",
    "url": "https://github.com/Poyotoron"
  },
  "documentationUrl": "https://ghp.maaaaa.net/EXQv/",
  "license": "MIT",
  "zipSHA256": "39ce8c49ba0860b617704298118c2b8599605d92d6af18775e4d5f36b20e1eee",
  "url": "https://github.com/Poyotoron/EXQv/releases/download/0.4.0/net.maaaaa.exqv-0.4.0.zip"
}