頭アクセフィッター - 髪飾り・ケモ耳・ヘッドホン・角を頭の実寸と髪の厚みに合わせて自動装着するUnityツール【VRChat】【JA,EN,KO】

「拾ってきた髪飾りが、頭に対して大きすぎる」

「ケモ耳を入れたら、根元が髪に埋まって見えない」

「片方しか入っていないので、反対側が作れない」

頭の小物が合わない理由は靴と同じで、元のアバターの頭のサイズで作られているからです。

頭の大きさはアバター間で2割から3割ちがいます。

頭アクセフィッターは、アバターの頭の実寸と髪の厚みを実際に測ってから置きます。

だから髪に埋まらず、浮きすぎもしません。

◆ 対応する小物

髪飾り・ヘアピン・リボン・カチューシャ

ケモ耳・エルフ耳

ヘッドホン・イヤーマフ

角

ヘッドドレス・ティアラ・王冠

名前から自動で判定します。判定できないときだけ手で選んでください。

◆ 片方しか無いケモ耳から、左右セットを作れます

チェックを1つ入れるだけで反対側が作られます。

負のスケールで反転すると法線が裏返って片方だけ真っ黒になりますが、

このツールは位置と回転だけを鏡像にするので、そうなりません。

◆ 髪の上に置きます

頭の表面と髪の表面を別々に測って、外側のほうを基準にします。

既に付いているケモ耳や角は「頭」として数えないので、

猫耳アバターでも頭の大きさを間違えません。

◆ 使いかた

1. Tools > VRCtoolers > 頭アクセフィッター を開く

2. アバターと小物を入れる

3. 「下見する」で置く場所と大きさを確認する(何も変わりません)

4. 「装着する」を押す

置いたあとは1mm単位で位置を動かせます。

◆ 元に戻せます

Ctrl+Z で戻せます。

ボタン1つで、複製した反対側も消えて元の場所と大きさに戻ります。

◆ 確認したこと

ユニットテスト 47項目 ALL PASS

実機E2E(実VRChat SDK3 + Felis)8項目 ALL PASS

何も入っていない新規プロジェクトへの取り込み確認 済み

◆ 動作環境

Unity 2022.3 系。VRChat SDK は不要です(入っていても問題ありません)。Blender は不要です。

◆ 注意

アバターのRigがHumanoidで、Headが割り当てられている必要があります。

アクセのメッシュが、そのオブジェクトの外にあるボーンにスキニングされている場合は、

アーマチュアを含むほうのオブジェクトを指定してください。

枝分かれした角など形が特殊なものは、向きの自動合わせを切って手で回してください。

--- English ---

A head accessory made for another avatar will not fit yours, for the same reason shoes do not: it was built for that avatar's head size. Head sizes differ by 20-30% between avatars.

Head Accessory Fitter measures the real head size and the hair thickness before it places anything. Nothing sinks into the hair, and nothing floats above it.

Supported: hair ornaments, hair pins, ribbons, headbands, animal ears, elf ears, headphones, earmuffs, horns, headdresses, tiaras and crowns. The type is detected from the name; pick it by hand only when detection fails.

Pairs from a single part: tick one checkbox and the other side is built. Duplicating with a negative scale flips the normals and turns one side black. This tool mirrors only the position and rotation, so that does not happen.

It measures the scalp surface and the hair surface separately and uses the outer one. Animal ears, horns and tails already on the avatar are not counted as head, so cat-eared avatars are measured correctly.

Open Tools > VRCtoolers > Head Accessory Fitter, set the avatar and the accessory, press Preview to check the position and size without changing anything, then press Attach. Afterwards you can nudge the position in 1mm steps. Ctrl+Z works, and one button restores everything including the mirrored copy.

Verified: 47 unit tests all pass, 8 real-avatar E2E tests with the real VRChat SDK3 and Felis all pass, and a clean import into an empty project was checked.

Unity 2022.3. The VRChat SDK is not required. Blender is not required. The avatar's Rig must be Humanoid with Head assigned. If the accessory mesh is skinned to bones outside the object you select, select the object that contains the armature instead.

Note: the detection keywords include Japanese words on purpose, so accessories with Japanese object names still work in this English build.

--- 한국어 ---

다른 아바타용으로 만들어진 머리 소품은 그대로 넣으면 맞지 않습니다. 이유는 신발과 같습니다. 원래 아바타의 머리 크기로 만들어졌기 때문입니다. 머리 크기는 아바타마다 20~30% 차이가 납니다.

헤드 액세서리 피터는 아바타의 머리 실측 크기와 머리카락 두께를 실제로 측정한 뒤 배치합니다. 그래서 머리카락에 묻히지도, 붕 뜨지도 않습니다.

대응 소품: 머리 장식·헤어핀·리본·머리띠, 동물 귀·엘프 귀, 헤드폰·귀마개, 뿔, 헤드드레스·티아라·왕관. 이름으로 자동 판정하며, 판정이 안 될 때만 직접 선택하면 됩니다.

한쪽만 있는 파츠로 좌우 세트를 만들 수 있습니다. 체크 하나만 넣으면 반대쪽이 생성됩니다. 음수 스케일로 반전해 복제하면 노멀이 뒤집혀 한쪽만 새까맣게 되지만, 이 툴은 위치와 회전만 거울상으로 만들기 때문에 그런 일이 없습니다.

두피 표면과 머리카락 표면을 따로 측정해 바깥쪽을 기준으로 삼습니다. 이미 붙어 있는 동물 귀나 뿔은 「머리」로 세지 않으므로, 고양이 귀 아바타에서도 머리 크기를 잘못 재지 않습니다.

Tools > VRCtoolers > 헤드 액세서리 피터 를 열고 아바타와 소품을 넣은 뒤, 「미리보기」로 배치 위치와 크기를 확인하고(아무것도 바뀌지 않습니다) 「장착하기」를 누릅니다. 이후 1mm 단위로 위치를 옮길 수 있습니다. Ctrl+Z 로 되돌릴 수 있고, 버튼 하나로 복제한 반대쪽까지 정리됩니다.

확인 사항: 유닛 테스트 47항목 ALL PASS, 실기 E2E(실제 VRChat SDK3 + Felis) 8항목 ALL PASS, 아무것도 없는 신규 프로젝트로의 임포트 확인 완료.

Unity 2022.3 계열. VRChat SDK 는 필요 없습니다. Blender 는 필요 없습니다. 아바타의 Rig 가 Humanoid 이고 Head 가 지정되어 있어야 합니다. 액세서리 메쉬가 선택한 오브젝트 바깥의 본에 스키닝되어 있으면, 아마추어가 들어 있는 쪽 오브젝트를 지정해 주세요.

참고: 판정용 키워드에는 일본어 단어가 의도적으로 포함되어 있습니다. 일본어 오브젝트 이름의 액세서리도 이 한국어판에서 그대로 판정하기 위해서입니다.