組み込みのContact Tags

Contact SenderやReceiverを扱う際、VRChat SDKには利用可能な組み込みのContact Tagsがいくつか用意されています。これらのタグの使用は任意であり、必要に応じて独自のタグを入力することも可能です。しかし、組み込みタグを使用することで、自身が作成していないアバターやワールドと互換性のあるコンタクトを簡単に作成できるようになります。例えば、アバターの手を検知して反応するワールド内のReceiverや、熱い面や冷たい面に触れると反応するアバター上のReceiverなどを実装できます。

組み込みタグを使用するには、下図のようにインスペクターのドロップダウンリストから選択してください。1つのSenderやReceiverに対して複数のタグを組み合わせて使用できることを覚えておいてください。SenderとReceiverの双方に少なくとも1つ共通のタグが含まれている場合に、コンタクトがトリガーされます。

身体部位

このカテゴリのタグは、人型アバターの身体の各部位を表します。

これは現在、VRChat内で特別な扱いを受ける唯一のカテゴリです。ヒューマノイドアバターがロードされる際、アバター作成者によって手動で定義されていない場合は、適切なボーンに対してこれらのタグを持つContact Senderが自動的に生成されます。そのため、アバターやワールド内のReceiverにこれらのタグを使用することで、それらの身体部位が近づいたことを検知できるようになります。これは、頭をなでるような接触によって起動する機能や、ワールド内の押しボタンで動作するギミックなどに役立ちます。

Tag	Description
`Head`	アバターの頭部。
`Torso`	アバターの胴体。
`Hand`	アバターの左右いずれかの手。
`HandL`	アバターの左手。
`HandR`	アバターの右手。
`Foot`	アバターの左右いずれかの足。
`FootL`	アバターの左足。
`FootR`	アバターの右足。
`Finger`	アバターの左右いずれかの手の指すべて。
`FingerL`	アバターの左手の指すべて。
`FingerR`	アバターの右手の指すべて。
`FingerIndex`	アバターの左右いずれかの人差し指。
`FingerMiddle`	アバターの左右いずれかの中指。
`FingerRing`	アバターの両手の薬指です。
`FingerLittle`	アバターの両手の小指です。
`FingerIndexL`	アバターの左手の人差し指です。
`FingerMiddleL`	アバターの左手の中指です。
`FingerRingL`	アバターの左手の薬指です。
`FingerLittleL`	アバターの左手の小指です。
`FingerIndexR`	アバターの右手の人差し指です。
`FingerMiddleR`	アバターの右手の中指です。
`FingerRingR`	アバターの右手の薬指です。
`FingerLittleR`	アバターの右手の小指です。

Object Traits

このカテゴリのタグは、オブジェクトが持つ可能性のある特性を表します。VRChatクライアント内で特別な処理は行われませんが、複数のアバターやワールドで機能するシステムを作成する際には役立つ場合があります。これらは以下のサブセクションに分類されます。

Elements

オブジェクトの元素的な特性です。

Tag	説明
`Hot`	触れると熱いオブジェクトや表面。
`Cold`	触れると冷たいオブジェクトや表面。
`Fire`	火の炎、または燃えているオブジェクト。
`Freezer`	触れたオブジェクトを凍らせることができるオブジェクト。
`Wet`	液体で覆われたオブジェクト。
`Water`	液体の水。オブジェクトを濡らす性質を持つ。
`Wind`	風力を適用する領域。

Combat

VRChatの戦闘システムに関連する可能性のあるタグ。

Tag	Description
`Weapon`	武器として使用できるアイテム全般を示すタグ。
`Shield`	ダメージをブロックまたは無効化できるアイテム全般を示すタグ。
`Damage`	接触した際にダメージを与える可能性のあるあらゆるものを示すタグ。
`DamageBlunt`	こん棒のような鈍器でダメージを与えるための、Damageの特定のバリエーション。
`DamageSharp`	剣のような鋭利な武器でダメージを与えるための、Damageの特定のバリエーション。
`Ammunition`	遠距離武器の弾薬として扱えるオブジェクト。
`Projectile`	空中を移動してダメージを与えるオブジェクト。通常は武器から発射される。

Interaction

アバターとワールド内のオブジェクト間で行われる一般的なインタラクション。

Tag	Description
`Consumable`	食べ物やポーションなど、消費可能なアイテム。
`ConsumableFood`	飲食物に特化した `Consumable` のバリエーションです。
`ConsumableDrink`	飲料に特化した `Consumable` のバリエーションです。
`Brush`	髪や毛などに作用するブラシです。
`Dye`	他のオブジェクトの色を変更できるオブジェクトです。

最終更新: 2025年10月8日