頭身ラボ - 同じアバターをロリにも大人にもできる頭身スライダー。視点位置と足の接地と揺れもの半径まで自動で合わせるUnityツール【VRChat】【JA,EN,KO】

「このアバター、もっと幼くしたい」「同じ子で大人版も作りたい」。

頭身ラボは、アバターの頭身をスライダーで変えるUnity Editorツールです。BlendShapeではなくボーンを組み替えるので、髪・帽子・アクセサリが自動で一緒に付いてきます。Blenderは使いません。

◆ 頭身をスライダーで決めるだけ

デフォルメ(3) / ロリ(5) / 標準(6.5) / お姉さん(7.5) / モデル(8) のプリセットと、2〜9頭身の自由スライダー。今の身長と頭身を実測して表示するので、どこから動かすのかが分かった状態で決められます。

◆ 身長は頂点から実測します

VRChatのアバターはカリング対策でメッシュのバウンディングボックスを膨らませていることが多く、それを読むと身長が20mになります。頂点を直接測ることで、しなの1.422m/6.16頭身、まよ1.345m/5.66頭身といった実寸を正しく出します。

◆ 頭身を変えると壊れるものを、まとめて合わせます

・視点位置 … 目の位置から計算し直します

・足の接地 … 身長が変わって浮いたり埋まったりするのを直します

・PhysBoneの半径 … 絶対値なのでスケールに追従しません。頭の下にあるものは頭に、それ以外は手足に合わせます

・コライダーの半径・高さ・位置

・衣装アーマチュアの同名ボーン … 衣装が自前の骨を持っていても置いていきません

◆ 衣装が破れないボーンの動かし方

膝や肘の位置を動かすと、素体と衣装で伸び方が違うためニーソックスが裂けます。このツールは付け根のボーンをスケールする方式なので、素体と衣装が同じだけ伸びます。髪プレハブが頭の下にダミーのHeadを持っている構成では、スケールが二重にかからないよう外側の1本だけを処理します。

◆ 元に戻せます

・「チェックのみ」で、何がどう変わるかを実行前に全部確認できます

・Ctrl+Zで戻せます

・「元に戻す」で、触ったボーン・PhysBone・視点位置をJSONバックアップから復元します

◆ 使い方

1. unitypackageをImport

2. Tools > VRCtoolers > 頭身ラボ

3. アバターを指定（選択中のオブジェクトから自動で入ります）

4. なりたい頭身を選ぶ

5.「チェックのみ」で変更内容を確認

6.「頭身を変える」を実行

7. VRChat SDK Build & Testで見え方を確認

◆ 検証

Unity 2022.3.54f1 / VRChat SDK Avatars。ユニットテスト28項目、実SDK環境で市販アバター2体（しなの / まよ）の衣装3シーンを通した実機テスト54項目、出品ZIP同梱のunitypackageを別プロジェクトへ新規Importして13項目、いずれも全項目クリアしています。実機テストで見つけて修正した不具合5件も同梱の検証レポートに記載しています。使い方ガイドを同梱。

※ 目標の頭身とぴったり一致はしません。手足と胴も同時に動くためです。実測では目標5.0に対して4.70〜5.27に収まりました。

※ 変化が大きすぎる場合は頭のスケールに上限がかかります（警告が出ます）。

※ 衣装が大きく崩れる場合は「手足の長さを変える」をOFFにして、頭の大きさだけで調整してください。

※ RigがHumanoidに設定されたアバターが対象です。

※ アバター本体、衣装、VRChat SDK、Modular Avatarは付属しません。

※ デジタル商品のため、購入後の返品・返金はできません。

内容物:

・頭身ラボ unitypackage

・README

・TEST_REPORT

・CHANGELOG

・LICENSE

--- English ---

"I want this avatar to look younger." "I want a grown-up version of the same girl."

Head Ratio Lab changes the head-to-body ratio of your avatar with a slider. It rearranges bones rather than using BlendShapes, so hair, hats and accessories come along automatically. No Blender needed.

Just pick a ratio

Presets for Chibi (3), Petite (5), Standard (6.5), Adult (7.5) and Model (8), plus a free slider from 2 to 9. The current height and ratio are measured and shown, so you always know where you are starting from.

Height is measured from the vertices

VRChat avatars often inflate their mesh bounds to avoid culling, and reading those gives a height of 20 metres. Measuring the vertices directly gives the real numbers: 1.422m / 6.16 heads (Shinano), 1.345m / 5.66 heads (MAYO).

It fixes what a ratio change breaks

- View position, recalculated from the eyes

- Feet on the floor, since the height changes

- PhysBone radii, which are absolute values and do not follow a scale

- Collider radius, height and position

- The same-named bone inside an outfit's own armature, so clothing is not left behind

Bones are moved in a way that does not tear clothing

Moving the knee or elbow stretches the body and the outfit by different amounts, which rips thigh-high socks open. This tool scales the root bone instead, so both stretch together. Where a hair prefab nests its own Head bone under the avatar's Head, only the outermost one is scaled so the change is not applied twice.

Everything is reversible

- "Check only" shows exactly what would change before anything happens

- Ctrl+Z works

- "Undo changes" restores the bones, PhysBones and view position from a JSON backup

How to use

Import the unitypackage, open Tools > VRCtoolers > Head Ratio Lab, set the avatar, pick a target ratio, review with "Check only", then press "Change the ratio".

Verification

Unity 2022.3.54f1 / VRChat SDK Avatars. 28 unit tests, 54 checks on two real commercial avatars across three outfit scenes with the real SDK, and 13 checks after a fresh import into a separate project. All passed. The five defects found during the real-avatar run are documented in the included test report.

Notes:

The result will not match the target exactly, because the limbs and torso move at the same time; a target of 5.0 landed between 4.70 and 5.27 in testing. A very large change caps the head scale and shows a warning. If an outfit breaks badly, turn off "Change the limb length" and use the head size alone. The avatar's Rig must be set to Humanoid. Avatar, outfit, VRChat SDK and Modular Avatar are not included.

--- 한국어 ---

"이 아바타를 좀 더 어리게 만들고 싶어요." "같은 아이의 어른 버전도 만들고 싶어요."

등신 랩은 아바타의 등신(키 ÷ 머리 길이)을 슬라이더로 바꾸는 Unity Editor 툴입니다. BlendShape가 아니라 본을 조정하므로 머리카락·모자·액세서리가 자동으로 함께 따라옵니다. Blender는 사용하지 않습니다.

등신을 슬라이더로 정하기만 하면 됩니다

데포르메(3) / 프티(5) / 표준(6.5) / 어른(7.5) / 모델(8) 프리셋과 2〜9등신 자유 슬라이더. 현재 키와 등신을 실측해 표시하므로 어디서부터 움직이는지 알고 정할 수 있습니다.

키는 정점에서 실측합니다

VRChat 아바타는 컬링 대책으로 메쉬의 바운딩 박스를 부풀려 두는 경우가 많아, 그것을 읽으면 키가 20m가 됩니다. 정점을 직접 측정해 Shinano 1.422m / 6.16등신, MAYO 1.345m / 5.66등신 같은 실제 값을 정확히 냅니다.

등신을 바꾸면 망가지는 것을 함께 맞춥니다

- 시점 위치: 눈 위치에서 다시 계산합니다

- 발 접지: 키가 바뀌어 뜨거나 묻히는 것을 고칩니다

- PhysBone 반지름: 절대값이라 스케일을 따라가지 않습니다

- 콜라이더 반지름·높이·위치

- 의상 아마추어의 같은 이름 본: 의상이 자체 본을 가져도 놓고 가지 않습니다

의상이 찢어지지 않는 본 조정 방식

무릎이나 팔꿈치 위치를 움직이면 몸과 의상이 늘어나는 정도가 달라 니삭스가 찢어집니다. 이 툴은 뿌리 본을 스케일하는 방식이라 몸과 의상이 같이 늘어납니다. 머리카락 프리팹이 머리 아래에 더미 Head를 가진 구성에서는 스케일이 이중으로 걸리지 않도록 바깥쪽 하나만 처리합니다.

되돌릴 수 있습니다

- "확인만"으로 실행 전에 변경 내용을 모두 볼 수 있습니다

- Ctrl+Z로 되돌릴 수 있습니다

- "되돌리기"로 본·PhysBone·시점 위치를 JSON 백업에서 복원합니다

사용 방법

unitypackage를 Import → Tools > VRCtoolers > 등신 랩 → 아바타 지정 → 원하는 등신 선택 → "확인만"으로 확인 → "등신 변경" 실행.

검증

Unity 2022.3.54f1 / VRChat SDK Avatars. 유닛 테스트 28항목, 실제 SDK 환경에서 시판 아바타 2체의 의상 3장면 실기 테스트 54항목, 출품 ZIP의 신규 Import 13항목 모두 통과했습니다. 실기 테스트에서 발견해 수정한 불량 5건도 동봉된 검증 리포트에 기재되어 있습니다.

주의:

목표 등신과 정확히 일치하지는 않습니다. 팔다리와 몸통도 함께 움직이기 때문이며, 실측에서는 목표 5.0에 대해 4.70〜5.27이었습니다. 변화가 너무 크면 머리 스케일에 상한이 걸리고 경고가 표시됩니다. 의상이 크게 무너지면 "팔다리 길이를 바꾼다"를 끄고 머리 크기만으로 조정해 주세요. Rig가 Humanoid로 설정된 아바타가 대상입니다. 아바타 본체, 의상, VRChat SDK, Modular Avatar는 포함되지 않습니다.